XDebug调试

本文介绍如何使用PhpStorm集成xdebug在本地开发环境进行断点调试的技巧。 我配置的环境是:Windows10 + PhpStorm + PHP5.6。

1. 下载xdebug的扩展,并配置到php.ini

+ View code

第一行是加载xdebug的扩展,路径需根据自己的环境修改。 
第二行是开启远程调试; 
第三行是配置进行调试的主机地址; 
第四行是配置进行调试的主机上面会监听的端口; 
第五行是配置调试连接通信使用的协议,这行不配置也没关系,默认值就是dbgp。dbgp跟http一样,是一种通信协议。 
根据remote_host跟remote_port,xdebug就知道该把调试连接发送到哪里。

2. 配置PhpStorm中的php解释器

依次点击菜单File-Settings,打开如下菜单:

image 
image

3. 配置PHP的Debug

image

以上截图是PhpStorm的默认值,红框部分的Debug port应该与php.ini中的xdebug.remote_port保持一致。所以只有在php.ini中xdebug.remote_port不是9000的时候,才需要去这个地方设置。

至此,PhpStorm应用xdebug的调试环境就已经配置好了。接下来看看如何使用断点调试,方法主要有两种。


方法一:最原始的方法。

1)主动开启PhpStorm对调试端口的监听

image

在工具栏上找到如图所示的按钮,点一下就开启了。

2)找到合适的代码位置打断点

image

3)访问对应的请求,并在请求地址后面添加XDEBUG_SESSION_START的参数,如: 
image 
访问后就会进入断点: 
image

这个方法中: 
第一步的目的是为了让PhpStorm开启对xdebug.remote_port端口的监听,以便接收到xdebug发出的调试请求。 
第三步XDEBUG_SESSION_START参数的值可以随意写,它的作用在于开启一个http的调试会话。这个会话类似平常的登录会话一样,xdebug会把这个值写到cookie里面去: 
image 
只要在http(get或者post)请求中包含XDEBUG_SESSION_START参数或者XDEBUG_SESSION这个cookie中,这个请求就会尝试进入调试环境。只需要在第一次请求调试的时候加上XDEBUG_SESSION_START的参数,接下来一个小时内都不需要再加这个参数。如果想要停止调试,只要把调试端口监听关闭即可: 
image


方法二:跟方法一类似,只不过在第三步的时候,不需要在请求后边手动添加XDEBUG_SESSION_START参数,而是借助浏览器的插件来添加。

如果使用chrome浏览器,可以找到下面这个扩展并安装: 
image
安装完成后,在浏览器地址栏旁边就会出现这个插件的小按钮: 
image           

1)先进入要调试的页面,不加XDEBUG_SESSION_START参数

2)点击刚安装插件的按钮,随意输入Xdebug Key,再点击Set跟Start XDebug Session按钮,页面就会刷新进入调试环境。

这个方法跟方法一本质上没有区别,就是简化了输入XDEBUG_SESSION_START参数的过程而已。


 xdebug进行断点调试的关键在于:xdebug在识别到一个请求需调试的时候,就会用dbgp的协议向remote_host跟remote_port这个地址发送调试请求,当一个位于remote_host上的IDE如PhpStorm正好在监听remote_port这个端口的调试请求时,就能成功接收到调试信息进行调试。

本文演示的是xdebug用于本地调试的场景,实际上xdebug还可应用于远程调试的场景,比如说项目已经上线到了生产环境,通过xdebug的远程调试功能,就能在本地对生产环境的代码进行调试。目前我还没遇到这种调试的需求,所以也没有去尝试这个方式的具体实现过程,我在xdebug官方的文档中看到了类似的介绍,等来将来有必要的时候再来研究吧。