Xdebug：[Step Debug] 无法连接到调试客户端

Question

我想尝试 Xdebug 3.0.0RC1 来探索发生了什么变化以及随之而来的新功能。我还在使用最新的 PhpStorm 2020.3 EAP，它支持 Xdebug 3，无需主要配置。下面是我对调试器的 PhpStorm 配置：

这是我为 Xdebug3 尝试过的配置：

zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20170718/xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=host.docker.internal # here I tried several combinations like: "localhost", "127.0.0.1", "172.17.0.1"
xdebug.client_port=9001 # here I tried several ports 9003 included with no success

我也尝试过不添加 client_host/client_port 设置，但仍然失败。

我收到此错误：

Script php bin/console doctrine:cache:clear-metadata returned with error code 255
!!  [17-Nov-2020 15:24:40 UTC] Xdebug: [Step Debug] Could not connect to debugging client. Tried: host.docker.internal:9001 (through xdebug.client_host/xdebug.client_port) :-(
!!  [17-Nov-2020 15:24:41 UTC] PHP Fatal error:  Method class@anonymous::__toString() must not throw an exception, caught Symfony\Component\DependencyInjection\Exception\AutowiringFailedException:  in /var/www/vendor/symfony/symfony/src/Symfony/Component/DependencyInjection/Compiler/AutowirePass.php on line 233

关于我的环境的一些信息：

• Fedora 33
• Docker 版本 19.03.13，构建 4484c46d9d
• PhpStorm 2020.3 EAP 构建 #PS-203.5784.36

这很奇怪（因为显然host.docker.internal 是我正在使用的 Docker 版本“不”支持的，但它可以工作）而且很奇怪，同时以下配置确实适用于 Xdebug 2，即使调试器正在监听一直传入连接：

zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20170718/xdebug.so
xdebug.remote_autostart=0
xdebug.remote_enable=1
xdebug.remote_host=host.docker.internal
xdebug.remote_port=9000

我在这里缺少什么？

注意：我已经应用了Xdebug开发者here提供的解决方案。

Answer 1

PHP 7.4
码头工人
PHPStorm 2020.1
Xdebug 3.1.0

使用 Dockerfile 在你的 docker 容器中安装 Xdebug

RUN pecl install xdebug-3.0.1 && docker-php-ext-enable xdebug

使用以下配置 php.ini：

[xdebug]
xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.discover_client_host = 1

转到 PHPStorm - 设置 - PHP - 调试 - Xdebug 并将端口设置为 9003（默认）

PHPStorm

就是这样（：

如果您只想在需要时启用/禁用调试器：只需安装一个名为“Xdebug helper”的浏览器扩展，选择“调试”并从 php.ini 中删除“xdebug.start_with_request = yes”

[xdebug]
xdebug.mode = debug
xdebug.discover_client_host = 1

Answer 2

对我有用的是将 start_with_request 从 yes 更改为 trigger。

这对我有用：

xdebug.mode=debug
xdebug.start_with_request=trigger
xdebug.client_port=9003

Answer 3

我将开始非常感谢@LazyOne，他花了一些时间帮助我完成这个，直到我们让它工作。以下是我目前的配置，它运行良好：

zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20170718/xdebug.so
xdebug.mode=debug
xdebug.client_port=9005

您还需要更新File | Settings | Languages & Frameworks | PHP | Servers 处的Xdebug 端口以反映新端口，但还需要启用监听Xdebug3 传入连接的选项。 （我相信它在 PhpStorm 2020.3 中默认启用）

这是一个后端项目的设置，中间没有浏览器，我没有尝试过，但对于那些，你可能需要：

xdebug.start_with_request=yes

还有File | Settings | Languages & Frameworks | PHP | Servers 配置好。

注意：我们发现主机启用了 IPv6，我禁用了它，此外，通过Help > Edit Custom VM options 将以下设置添加到 IDE：-Djava.net.preferIPv4Stack=true。将 IP4 设置添加到 IDE 后，我没有尝试重新启用 IPv6 并查看 Xdebug 3 是否仍在工作

Answer 4

PHP 7.3
Docker（适用于 Mac）
PhpStorm 2021.1

---

您可能不需要通过 PECL 安装它（这需要很长时间才能构建并且对我不起作用）。

我所做的只是将php7.3-xdebug 添加到我的apt-get install 命令并正确配置端口映射，如下所示：

在 Dockerfile 中添加： RUN apt-get install -y php7.3-xdebug

在 docker-compose.yml 中，我映射了一个 extra_host（这是我的秘诀）：

services:
  web:
    extra_hosts:
      - "host.docker.internal:host-gateway"

在 php.ini 中：

[xdebug]
xdebug.mode=debug
xdebug.client_host=host.docker.internal

;optionals: (uncomment if you need them)
;xdebug.start_with_request=yes
;xdebug.discover_client_host=1

在 PhpStorm 中，我刚刚开始监听 9003 端口并根据需要配置服务器映射。

参考资料：

• XDebug 3 Documentation
• Milos Devacic post about xdebug + docker + vscode（帮助我找到了 extra_host 参数）

Answer 5

我创建了一个非常简单的配置，让我可以轻松地将Xdebug 与任何 PHP 版本一起使用（v2：5.6-7.1，v3：7.2+）。我只需要在三个地方配置 PhpStorm 和 docker-compose.yml 就可以调试了。

配置：

gander/dev@xdebug2.ini:

zend_extension=xdebug.so
; https://2.xdebug.org/docs/all_settings
; ------------------------------------
; Enables Step Debugging
xdebug.remote_enable=1
; ------------------------------------
; Address where IDE listening for incoming debugging connections
xdebug.remote_host=host.docker.internal
; ------------------------------------
; Port where IDE listening for incoming debugging connections
xdebug.remote_port=9003
; ------------------------------------
; Color var_dumps when in CLI
xdebug.cli_color=1
; ------------------------------------

gander/dev@xdebug3.ini:

zend_extension=xdebug.so
; https://xdebug.org/docs/all_settings
; ------------------------------------
; Enables Step Debugging
xdebug.mode=debug,develop
; ------------------------------------
; Address where IDE listening for incoming debugging connections
xdebug.client_host=host.docker.internal
; ------------------------------------
; Port where IDE listening for incoming debugging connections
xdebug.client_port=9003
; ------------------------------------
; Color var_dumps when in CLI
xdebug.cli_color=1
; ------------------------------------

gander/dev@docker-compose.yml:

version: '3.7'

services:
#...
  dev74:
    hostname: 'dev-74'
    container_name: 'dev_74'
    image: 'gander/dev:7.4'
    volumes:
      - './app/xdebug3:/www/localhost'
    working_dir: '/www/localhost/public'
    ports:
      - '8074:80'
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      PHP_IDE_CONFIG: "serverName=dev.74"
#...

通过 CLI 运行：

XDEBUG_SESSION=1 XDEBUG_CONFIG=1 php script.php

或：

docker-compose exec dev74 bash -c 'XDEBUG_SESSION=1 XDEBUG_CONFIG=1 php index.php'

截图：

Answer 6

我有同样的问题。从浏览器发出请求时我仍然有它，但是从命令行，就像你的情况一样，它现在可以工作了。我缺少的是带有路径映射的服务器配置。一旦设置好，连同你已有的设置，它就可以工作了。我在 Mac Os Big Sur 上，使用 PhpStorm 2020.3

Answer 7

我想指出ini文件中的以下配置选项，因为这对我来说解决了同样的问题。

xdebug.client_host=host.docker.internal

在 PhpStorm 的文档中 here 说 xdebug.remote_host=host.docker.internal 必须配置哪些接缝相似，但不是。

略有不同的是我使用的是 IntelliJ。

Answer 8

我遇到了同样的问题（ubuntu 20.4 - docker 20.10 - xdebug 3）

我的解决方案是：

1. xdebug.discover_client_host=1
2. 禁用防火墙sudo ufw disable