Xdebug文档（七）远程调试，xdebug文档调试

Xdebug提示调试客户端接口与PHP运行相联系。该章节解释如何设置PHP与xdebug，并推荐一些客户端。

介绍

Xdebug的远程调试器允许你检查数据结构，交互式地穿过和调试你的代码。该协议已经开放，名叫DBGp。该协议在xdebug2中实现，并代替旧版GDB类似协议并不再支持。

客户端

Xdebug2捆绑了一个使用DBGp协议简单命令行工具。还有一些其他客户端都做得很好（免费或商业的）。

Dev-PHP (IDE: Windows)
Eclipse plugin (IDE).
Emacs plugin (Editor Plugin).
KDevelop (IDE: Linux (KDE); Open Source).
ActiveState's Komodo (IDE: Windows, Linux, Mac; Commercial).
MacGDBP (Standalone client for Mac OS X; Free)
NetBeans (IDE: Windows, Linux, Mac OS X and Solaris).
Notepad++ plugin (Editor: Windows).
WaterProof's PHPEdit (IDE, from version 2.10: Windows; Commercial).
PHPEclipse (Editor Plugin).
Devsense's PHP Tools for Visual Studio (MS Visual Studio Plugin; Commercial).
JetBrain's PhpStorm (IDE; Commercial).
Protoeditor (Editor: Linux).
pugdebug (Standalone client for Linux, Windows and Mac OS X; Open Source).
VIM plugin (Editor Plugin).
jcx software's VS.Php (MS Visual Studio Plugin; Commercial).
Xdebug Chrome App (Chrome Application; Open Source)
XDebugClient (Standalone client for Windows).

用于调试的简单命令行工具绑定于xdebug所在的 debugclient 目录中。

启动调试器

要使xdebug调试器生效，你需要在php.ini配置一些设置。这类设置有xdebug.remote_enable开启调试器，xdebug.remote_host和xdebug.remote_port配置IP地址和端口以便调试器连接。还有xdebug.remote_connect_back设置用于开发服务器共享给多名开发者使用。

如果你需要调试器在错误发生时（PHP错误或exception）发起一会话，你也需要改变xdebug.remot_mode设置。该设置允许值是”req”（默认），高度器会在脚本一开始就发起一会话，或”jit”值让会话值在错误发生时生成。

做好所有这些设置后，xdebug仍未能在脚本一运行时自动开始调试会话。你有三个方法激活xdebug调试器：

1、当在命令行中运行脚本，你需要设置以环境变量：

export XDEBUG_CONFIG="idekey=session_name"

登录后复制

php myscript.php

登录后复制

你也能配置 xdebug.remote_host, xdebug.remote_port, xdebug.remote_mode 和xdebug.remote_handler 为相同的环境变量只要在隔离这些值在一个空间内：

export XDEBUG_CONFIG="idekey=session_name remote_host=localhost profiler_enable=1"

登录后复制

所有设置你都能在php.ini通过XDEBUG_CONFIG设置。

2、如果你想在浏览器调试脚本，只需要URL添加 XDEBUG_SESSION_START=session_name参数。要替代GET参数也可以设置XDEBUG_SESSTION_START为POST参数，或是COOKIE参数。详情请参考下一章节。

3、要在浏览器运行PHP并激活调试器需安装以下浏览器插件。每种插件都能让你简单点下按钮就开启调试器。当这些插件激活，它们会直接设置XDEBUG_SESSION的cookie值，代替XDEBUG_SESSION_START。

The easiest Xdebug

Firefox插件拥有IDE界面更容易方便调试。插件地址： https://addons.mozilla.org/en-US/firefox/addon/the-easiest-xdebug/.

Xdebug Helper for Chrome

Chrome插件只需一键帮助你打开或关闭调试。插件地址：https://chrome.google.com/extensions/detail/eadndfjplgieldjbigjakmdgkmoaaaoc.

Xdebug Toggler for Safari

Safari插件能自动开启Xdebug调试。Github地址： https://github.com/benmatselby/xdebug-toggler.

Xdebug launcher for Opera

Opera插件允许你开启一xdebug调试会话。

在你运行脚本，你要让你的客户端能接收调试连接，请参考文章指明客户端需要如何配置的内容。使用捆绑的简单客户端请参考编译和安装一章。你可以用于支行“调试客户端”。

当调试客户端启动，它会显示以下信息并等待连接被调试服务器接收：

Xdebug Simple DBGp client (0.10.0)

- libedit support: enabled

Waiting for debug server to connect.

当连接形成，调试服务器将输出以下信息：

Connect

(cmd)

现在你能用有关DBGp的一些命令集。当脚本运行结束，调试服务器关闭与客户端连接。调试客户端恢复等待新的连接。

通讯设置

静态IP/单一开发

远端调试时，内置于php的xdebug扮演了客户端，而IDE充当了服务器。以下动图展示了通讯频道的建立：

服务器IP为10.0.1.2 ，HTTP端口80
IDE所在IP 10.0.1.42, 因此 xdebug.remote_host 设置为10.0.1.42
IDE侦听端口9000, 因此 xdebug.remote_port 设为 9000
HTTP请求在IDE所在的机器上启动。
Xdebug连接到10.0.1.42:9000
调试开始，HTTP提供回应。

未知IP/多名开发者

如果xdebug.remote_connect_back利用了，其连接方式有些不同：

服务器IP和HTTP端口10.0.1.2:80
IDE所在机器是未知IP，所以 xdebug.remote_connect_back 设为1。
IDE侦听端口9000，因此 xdebug.remote_port 设为9000
HTTP请求开始， Xdebug通过HTTP头部获取IP地址。
Xdebug连接获取到的IP (10.0.1.42)于端口9000
调试运行，HTTP提供回应。

HTTP调试会话

Xdebug包含使用cookie对浏览器启动跟踪调试会话功能。该工作类似下面步骤：

当URL变量XDEBUG_SESSION_START=name附加到URL后，或通过POST传入相同名称值——Xdebug发出一cookie值”XDEBUG_SESSION”而该值为URL参数XDEBUG_SESSION_START值。Cookie值有效期为1小时。DBGp协议也会将相同的值在连接到调试客户端时传到初始数据包内的“idekey”属性。

XDEBUG_SESSION_START 或XDEBUG_SESSION cookie 一旦设置，Xdebug就会尝试连接到调试客户端。
要停止调试会话（和销毁附带cookie) 只需简单地添加URL参数XDEBUG_SESSION_STOP。Xdebug然后不再尝试创建连接到高度调试客户端。

多用户调试

Xdebug只允许远程调试时指定的一个IP地址连接到 xdebug.remote_host。它不能在浏览器跑测试的时候连回到浏览器所在的机器IP，除非你使用xdebug.remote_connect_back。

如果开发者们的各种不同项目都放在同一（开发）服务器上，你可将每个项目通过Apache的.htaccess功能设置php_value xdebug.remote_host=10.0.0.5而使用xdebug.remote_host 设置。

这里有两种解决方法。第一，你可以使用DBGp代理。至于如何使用它参考 Debugging with multiple users 章节。你能在ActiveState's web site下载代理软件作为python远端调试包的一部分。有关更多文档位于 Komodo FAQ。

第二是使用xdebug 2.1的xdebug.remote_connect_back设置。

xdebug