Zend Studio集成Xdebug断点调试详解

转自:http://www.softown.cn/post/115.html

Xdebug是PHP开发中两个常用的断点调试工具之一(另一个为Zend Debugger)。

现在，我们在Zend Studio中集成PHP的Xdebug模块，从而在Zend Studio中实现断点调试功能。

1、下载、安装、配置Xdebug

关于如何在PHP中安装、配置Xdebug模块，请直接参考文章PHP安装配置Xdebug模块详解。

2、Xdebug远程连接配置

想要在Zend Studio中使用Xdebug，就需要启用Xdebug的远程调试功能。

Xdebug与远程调试相关的参数，见下表。

配置参数选项	参数值类型与默认值	参数选项描述
xdebug.remote_enable	boolean类型，默认值=0	是否启用Xdebug的远程调试功能(默认：未启用)
xdebug.remote_host	string类型，默认值=localhost	指定远程调试的主机地址(可以为域名、主机名或IP地址)
xdebug.remote_port	integer类型，默认值=9000	指定远程调试的端口号
xdebug.remote_handler	string类型，默认值=dbgp	指定远程调试的处理协议，值可以为"php3"、"gdb"、"dbgp"。其中，dbgp是唯一受支持的协议。php3可以选择旧版本PHP 3样式的调试器输出；gdb可以像dbgp一样地使用GDB调试器。Xdebug 2.1及以后版本只支持dbgp协议。
xdebug.remote_autostart	boolean类型，默认值=0	通常情况下，你需要使用一个指定的HTTP GET/POST 变量来启动远程调试。如果该参数设为1，即使没有指定的变量，Xdebug也将一直尝试开始一个远程调试会话，并与客户端保持连接。
xdebug.remote_connect_back	boolean类型，默认值=0	该参数自2.2版本开始引入。如果启用该参数选项，xdebug.remote_host参数将会被忽略。Xdebug将会尝试和发送请求到PHP服务器的所有客户端建立连接。Xdebug将通过`$_SERVER['REMOTE_ADDR']`来获取客户端所使用的IP地址。只要对方能够连接到服务器，就可以开启一个远程调试会话。
xdebug.remote_cookie_expire_time	integer类型，默认值=3600	该参数自2.2版本开始引入。指定远程调试的有效期限(单位：秒)。
xdebug.remote_log	string类型，默认值=	指定远程调试的日志文件路径，用于记录远程调试的日志信息，该文件在调试过程将会一直以追加模式保持打开，所以默认情况下，文件内容不会被覆盖。
xdebug.remote_mode	string类型，默认值=req	指定远程调试的连接模式，值可以为"req"或"jit"。req表示一旦运行脚本就立即连接调试客户端。jit表示当错误发生时才立即连接调试客户端。

简而言之，如果保持其他参数默认(有些参数官方也不建议修改)，我们只需要在php.ini中接着Xdebug原来的配置添加如下一行代码，即可启用远程调试功能。

xdebug.remote_enable=On

最终配置如下图所示。

3、配置Zend Studio

点击Zend Studio菜单栏的【Window】->【Preferences】。如下图所示，在首选项窗口中依次找到【PHP】->【Debug】的右侧面板。

在旧版本的Zend Studio中，菜单名直接为【PHP Debug】。

首先我们对PHP Server进行配置，也就是将PHP Server的调试器类型从默认的Zend Debugger改为Xdebug。点击图中编号①处的链接。

在PHP Server中对当前项目指定的Server进行编辑【Edit】。

笔者的abc.com是本地的虚拟主机配置，以便于直接映射到当前项目的根目录。

将Debugger类型改为Xdebug。

接着，我们配置PHP执行环境。点击前面图中编号②的链接，进入PHP的执行环境配置页面。如下图所示，Zend Studio为我们自带了几个采用Zend Debugger的执行环境，由于我们的PHP是自己独立安装的，而不是采用Zend Studio自身集成的。因此，我们将自己安装的PHP执行环境添加进来。点击【Add】按钮。

输入执行环境的名称，点击【Browse】按钮浏览我们自己安装的php.exe和php.ini的文件路径，并将PHP Debugger改为Xdebug类型，然后点击【Finish】。

此时，我们就可以看到PHP Server和PHP Executable的调试器类型都已经改为了Xdebug。面板下方还有一个默认勾选的【Break at First Line】，表示自动在第一行代码处添加断点(当然，你也可以取消【Break at First Line】选项，然后在调试之前根据需要添加断点)。

由于我们的Xdebug远程调试配置参数均为默认值，而Zend Studio为我们的Xdebug默认设置的参数也与之相同，因此我们不需要在【PHP】->【Debug】->【Installed Debuggers】中对Xdebug的参数进行修改(其默认参数如下图所示)。

由于我们更改了php.ini配置文件，因此需要重启服务器使其生效。

接着，如下图所示，我们就在指定的PHP文件中添加断点，并进行断点调试(由于我们刚才勾选了【Break at First Line】选项，因此这里可以不加断点，当我们进行调试时，Zend Studio会自动在第一行代码的位置进入断点调试模式)。

添加好断点后，我们就在该文件中点击右键，在弹出的关联菜单中点击【Debug As】->【PHP Web Application】(有些旧版本为【PHP Web Page】)。

接着在弹出的下列对话框中输入用于调试的URL。

接着，Zend Studio会提示我们是否进入调试透透视图，点击【Yes】。

最后，Zend Studio就自动进入了断点调试模式，如下图所示。

这个时候，我们就可以像使用Eclipse的调试快捷键来对PHP文件进行调试了。

Eclipse调试快捷键：F5(单步跳入)、F6(单步跳过)、F7(单步返回)、F8(跳过调试继续执行)。

下一篇:Xdebug断点调试的工作原理详解