Xdebug 忽略在 Docker 容器内创建的 PHP 项目的 Netbeans 中的断点

Question

当我调试不是在 Docker 容器内创建的项目时，Xdebug 没有问题。

但是，当我调试在 Docker 容器内创建的项目时，Xdebug 不会在断点处停止 - 尽管它正在运行并在 xdebug_break() 处停止。

我的 Docker 主机是 Ubuntu 14.04。它安装为 VirtualBox。它使用 PHP 5.5.9-1ubuntu4.16 和 Xdebug v2.2.3。我有一个已安装的卷（在 Docker 主机和 Docker 容器之间），其中存储了在 Docker 容器内创建的项目。

我在 Ubuntu 14.0.4 中的 Docker 容器基于 CentOS 6.7 版（最终版）。它使用 PHP 5.3.29 和 Xdebug v2.1.4，并且 Xdebug 配置如下（在 /etc/php.d/xdebug.ini 中）：

zend_extension=/usr/lib64/php/modules/xdebug.so
;xdebug.remote_autostart = 0
xdebug.remote_autostart = 1
xdebug.remote_connect_back = 1
xdebug.remote_enable = 1
;xdebug.remote_host = 127.0.0.1
;xdebug.remote_host = localhost
;xdebug.remote_host = 172.17.42.1
;xdebug.remote_host = 10.0.2.15
;xdebug.remote_host = 10.0.2.2
;xdebug.remote_port = 9001
xdebug.remote_port = 9000
xdebug.remote_handler = dbgp
xdebug.profiler_enable_trigger = 1
xdebug.profiler_output_dir = /home/devteam/xdebug/profiler
xdebug.remote_log=/home/devteam/xdebug/xdebug.log
xdebug.profiler_output_name = cachegrind.out.%c
xdebug.show_exception_trace = 1
xdebug.idekey = netbeans-xdebug

我已经检查了 xdebug.remote_port 设置的所有值，当前显示为注释掉。我为 xdebug.remote_port 设置尝试了不同的端口（9001、9002）（当然在 Netbeans 中设置了相同的端口）。我还尝试更改 xdebug.remote_connect_back 和 xdebug.remote_autostart 设置。我注意到，当这两个设置为零时，xdebug 实际上挂起并等待连接。

但是在调试以前部署在 Docker 容器中的项目时，我仍然无法让 Xdebug 在断点处停止。

我不确定我是否遗漏了有关 Netbeans 设置或 Xdebug 设置的任何内容。我花了很多时间试图找到解决方案。我试图在 xdebug.log 中找到一些相关信息 - 但它似乎没有包含任何对我重要的信息：

...
<- breakpoint_set -i 1567 -t line -s enabled -f file:///var/www/html/test/index.php -n 3
-> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" command="breakpoint_set" transaction_id="1567" state="enabled" id="11710015"></response>

<- breakpoint_set -i 1568 -t line -s enabled -f file:///home/pkowalski/clients/deployments/demon-prep/application/bootstrap_http.php -n 7
-> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" command="breakpoint_set" transaction_id="1568" state="enabled" id="11710016"></response>

<- run -i 1569
-> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" command="run" transaction_id="1569" status="stopping" reason="ok"></response>

Log closed at 2016-05-20 23:38:11

Log opened at 2016-05-20 23:40:23
-> <init xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" fileuri="file:///mnt/deployments/demon-prep/application/bootstrap_http.php" language="PHP" protocol_version="1.0" appid="1172" idekey="netbeans-xdebug"><engine version="2.1.4"><![CDATA[Xdebug]]></engine><author><![CDATA[Derick Rethans]]></author><url><![CDATA[http://xdebug.org]]></url><copyright><![CDATA[Copyright (c) 2002-2012 by Derick Rethans]]></copyright></init>

<- feature_set -i 1570 -n show_hidden -v 1
-> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" command="feature_set" transaction_id="1570" feature="show_hidden" success="1"></response>
...

看起来它成功地设置了断点，但我不确定 xdebug.log 中的文件路径是否正确。也许我需要在 Netbeans 中使用手动路径映射，但我不确定如何去做以及什么路径应该是服务器路径。

现在，如果我开始调试，页面会加载。但前段时间，浏览器内部出现错误，提示连接已重置。除此之外，还出现了几次错误弹出窗口。有一段时间弹出窗口说 Netbeans 和 Xdebug 之间存在通信问题。其他时间显示不同的消息 - 存在套接字连接错误。我不知道为什么现在我看不到这些弹出窗口。

对于在 Docker 容器内创建的项目，Xdebug 忽略 Netbeans 中的断点的解决方案是什么？

Answer 1

最后我自己解决了这个问题。

正如我所料，解决方案是在 Netbeans 中正确设置路径映射。

今天再次分析xdebug.log后，我注意到，在日志的开头包含有趣的信息-对于属性的值了fileURI的初始化元素：

<init xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" fileuri="file:///mnt/deployments/my-project/application/bootstrap_http.php" language="PHP" protocol_version="1.0" appid="139" idekey="netbeans-xdebug"><engine version="2.1.4"><![CDATA[Xdebug]]></engine><author><![CDATA[Derick Rethans]]></author><url><![CDATA[http://xdebug.org]]></url><copyright><![CDATA[Copyright (c) 2002-2012 by Derick Rethans]]></copyright></init>

顺便我分享我的码头工人主机的目录，包含我的项目中，与泊坞容器，运行搬运工子对我的码头工人容器：搬运工运行... -v /家庭/ pkowalski /客户/部署：到/ mnt /部署.

所以我做了什么来解决 Netbeans 忽略my-project断点的问题，我只是在 Netbeans 中设置了路径映射（项目属性 -> 运行配置 -> 高级），如下所示：

服务器路径：/mnt/deployments/my-project

项目路径：/home/pkowalski/clients/deployments/my-project

因为我在 Docker 容器中为挂载目录创建了一个软链接：ln -s /mnt/deployments /home/devteam/deployments，最初我尝试将/home/devteam/deployments/my-project作为服务器路径值，但它没有用。

除此之外，现在它对我有用，根本没有设置xdebug.remote_host并且xdebug.remote_autostart设置为零或一。

这是我在 Docker 容器中的/etc/php.d/xdebug.ini的最终工作内容：

zend_extension=/usr/lib64/php/modules/xdebug.so 
xdebug.remote_autostart = 0
xdebug.remote_connect_back = 1
xdebug.remote_enable = 1
xdebug.remote_port = 9000
xdebug.remote_handler = dbgp