本文介绍如何使用PhpStorm集成xdebug在本地开发环境进行断点调试的技巧。 我配置的环境是:Windows10 + PhpStorm10.0.1 + PHP5.6。
1. 下载xdebug的扩展,并配置到php.ini
zend_extension = d:devphp5.6.28extphp_xdebug-2.5.0-5.6-vc11-x86_64.dll xdebug.remote_enable = On xdebug.remote_host=localhost xdebug.remote_port=9000 xdebug.remote_handler=dbgp
第一行是加载xdebug的扩展,路径需根据自己的环境修改。
第二行是开启远程调试;
第三行是配置进行调试的主机地址;
第四行是配置进行调试的主机上面会监听的端口;
第五行是配置调试连接通信使用的协议,这行不配置也没关系,默认值就是dbgp。dbgp跟http一样,是一种通信协议。
根据remote_host跟remote_port,xdebug就知道该把调试连接发送到哪里。
2. 配置PhpStorm中的php解释器
依次点击菜单File-Settings,打开如下菜单:
3. 配置PHP的Debug
以上截图是PhpStorm的默认值,红框部分的Debug port应该与php.ini中的xdebug.remote_port保持一致。所以只有在php.ini中xdebug.remote_port不是9000的时候,才需要去这个地方设置。
至此,PhpStorm应用xdebug的调试环境就已经配置好了。接下来看看如何使用断点调试,方法主要有两种。
方法一:最原始的方法。
1)主动开启PhpStorm对调试端口的监听
在工具栏上找到如图所示的按钮,点一下就开启了。
2)找到合适的代码位置打断点
3)访问对应的请求,并在请求地址后面添加XDEBUG_SESSION_START的参数,如:
访问后就会进入断点:
这个方法中:
第一步的目的是为了让PhpStorm开启对xdebug.remote_port端口的监听,以便接收到xdebug发出的调试请求。
第三步XDEBUG_SESSION_START参数的值可以随意写,它的作用在于开启一个http的调试会话。这个会话类似平常的登录会话一样,xdebug会把这个值写到cookie里面去:
只要在http(get或者post)请求中包含XDEBUG_SESSION_START参数或者XDEBUG_SESSION这个cookie中,这个请求就会尝试进入调试环境。只需要在第一次请求调试的时候加上XDEBUG_SESSION_START的参数,接下来一个小时内都不需要再加这个参数。如果想要停止调试,只要把调试端口监听关闭即可:
方法二:跟方法一类似,只不过在第三步的时候,不需要在请求后边手动添加XDEBUG_SESSION_START参数,而是借助浏览器的插件来添加。
如果使用chrome浏览器,可以找到下面这个扩展并安装:
安装完成后,在浏览器地址栏旁边就会出现这个插件的小按钮:
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官方的文档中看到了类似的介绍,等来将来有必要的时候再来研究吧。
参考:
https://xdebug.org/docs/remote
https://xdebug.org/docs/all_settings