时间戳

首页 > 解决方案 > 使用 Docker 和 VSCode 设置 XDebug

docker - 使用 Docker 和 VSCode 设置 XDebug

问题描述

我使用 Docker 设置了 Laravel 开发环境 - nginx:stable-alpine、php:8.0-fpm-alpine 和 mysql:5.7.32。我从我的 php.dockerfile 安装 Xdebug：

RUN apk --no-cache add pcre-dev ${PHPIZE_DEPS} \ 
&& pecl install xdebug \
&& docker-php-ext-enable xdebug \
&& apk del pcre-dev ${PHPIZE_DEPS}

并在 docker-compose 中包含两个卷以将 php 指向 xdebug.ini 和 error_reporting.ini：

    volumes:
  - .:/var/www/html
  - ../docker/php/conf.d/xdebug.ini:/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
  - ../docker/php/conf.d/error_reporting.ini:/usr/local/etc/php/conf.d/error_reporting.ini

我的 xdebug.ini 看起来像这样：

zend_extension=xdebug

[xdebug]
xdebug.mode=develop,debug,trace,profile,coverage
xdebug.start_with_request = yes
xdebug.discover_client_host = 0
xdebug.remote_connect_back = 1 
xdebug.client_port = 9003
xdebug.remote_host='host.docker.internal'
xdebug.idekey=VSCODE

当我返回 phpinfo() 时，我可以看到一切设置正确，显示已安装 xdebug 版本 3.0.4，但是当我在 VSCode 中设置断点并运行调试器时，它没有命中它。

我的 launch.json 看起来像这样：

{
"version": "0.2.0",
"configurations": [
    {
        "name": "XDebug Docker",
        "type": "php",
        "request": "launch",
        "port": 9003,
        "pathMappings": {
            "/var/www/html": "${workspaceFolder}/src",
        }
    },
]

}

我的文件夹结构如下所示：

- Project
-- /docker
--   nginx.dockerfile
--   php.dockerfile
--- /nginx
---  /certs
---  default.conf
--- /php
---- /conf.d
----   error_reporting.ini
----   xdebug.ini
-- /src (the laravel app)

标签： dockervisual-studio-codexdebugvscode-debuggerxdebug-3

解决方案

Xdebug 3 更改了设置的名称。根据升级指南xdebug.remote_host，您需要使用代替： https ://xdebug.org/docs/upgrade_guide#changed-xdebug.remote_hostxdebug.client_host

xdebug.remote_connect_back也已重命名为xdebug.discover_client_host，但在将 Xdebug 与 Docker 一起使用时，您应该将该设置保留为0.

推荐阅读