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(跳过调试继续执行)。