IDEA集成xdebug远程调试功能

博客原文链接

在使用php调试代码的时候，我通常都是使用简单暴力的echo之类的输出调试。这种调试方法的效率与个人能力正相关，你加一个echo多数是为了验证自己的一个推测，那么你对代码越熟悉，你推测的就会越准确，bug解决的就越快，相反则往往如无头苍蝇般，东一头西一头，不知所谓地输出一些无意义的调试信息，效率奇低。此时单步调试工具便成了救命稻草，有了它，你可以查看代码执行过程中所有变量的值，心如明镜，解个bug还不手到擒来。对于php，常用的就是xdebug，我这里就简单讲下IDEA里面如何使用xdebug进行代码调试。

安装

我们先把xdebug安装好，由于这里是远程调试，所以xdebug要安装到php运行的服务器上，如果php是在本地环境中，那就直接安装到本地，官方安装文档在这里，我这里简单讲一下Centos 6.6+PHP 5.4的安装方法。

1. 下载并且编译xdebug。
   下载链接-xdebug-2.2.7.tgz

   wget http://xdebug.org/files/xdebug-2.2.7.tgz
   tar zxvf xdebug-2.2.7.tgz
   cd xdebug-2.2.7
   phpize&make&make install

2. 修改php配置

在php.ini中增加如下一行：
zend_extension = /usr/local/lib/php/extensions/no-debug-non-zts-20100525/xdebug.so

安装完毕！

运行原理

在实际使用前，我们来简单了解xdebug远程调试的原理，这样当xdebug不听话的时候，我们也知道从哪里收拾它。详细文档参见此处。

xdebug远程调试分为两部分：调试客户端和xdebug服务端。前者就是运行我们代码调试器的地方，我这里是IDEA，后者是xdebug运行的地方。当我们尝试使用xdebug进行调试时，客户端会监听一个端口，等待xdebug来连接，一旦连接成功，双方就开始通信，进行代码调试。

图一，源图

图一动态展示了xdebug运行的原理，左边是调试客户端，比如IDEA、eclipse之类的IDE，右边是xdebug，运行按照如下步骤进行：

1. IDE监听一个调试端口，默认是9000，可以自行配置。

2. 用户访问右边php环境的server，我们这里使用浏览器访问，一般IDE会自动帮我们在正常的url后面增加XDEBUG_SESSION_START=name的参数。这个参数是用来通知xdebug主动连接IDE的9000端口进行调试的，没有这个参数，xdebug不会去主动连接IDE，调试也就不会触发。

3. xdebug主动去连接IDE的9000端口， 连接成功后，调试开始。

细心的同学可能会问，xdebug是如何知道IDE监听9000端口的呢？好问题，答案就在配置文件里面。xdebug有两个配置：remote_host和remote_port，分别代表IDE的ip地址和监听端口。由此可见，IDE和xdebug必须协商好监听端口。

另一个问题又来了，端口好办，但是如果我的ip会变化，那我换一个ip，岂不是要修改下xdebug.remote_host配置吗？好麻烦！！！不知道ip没关系，xdebug可以自己知道，只要设置xdebug.remote_connect_back为1就可以了，其运行原理见图二，实现很简单，xdebug可以从http请求的头部获取ip地址，之后就用该ip地址作为remote_host来连接。

图二，源图

php.ini配置

到这里，相信大家已经基本了解xdebug的原理了，本着好记性不如烂笔头的准则，这里把我的配置列一下，方便查阅。

[xdebug]
zend_extension = /usr/local/lib/php/extensions/no-debug-non-zts-20100525/xdebug.so
xdebug.remote_connect_back=1
xdebug.remote_enable=1
xdebug.remote_port=9444
xdebug.remote_autostart=1
xdebug.profiler_enable=1
xdebug.profiler_output_dir="/home/logs/xdebug/xdebug-profiler"

没讲到的配置，大家自行查阅文档，太懒会变成猪的！！！

IDEA配置

最后一步就是IDEA，也即IDE的配置了。主要有两方面要配置：

其一，监听端口配置，对于IDEA系列，可以在配置中搜索Debug或者xdebug就能迅速定位了，图三是我的配置。

图三

其二，是本地开发路径和远程路径的映射配置，也就是要让本地代码和远程代码可以对应起来。配置位置在项目的Run/Debug Configuration里面，也就是去新建一个调试项目，截图如下。

图四

图五

按照图五中配置好mapping关系后，开始使用xdebug的调试功能吧，告别简单粗暴甚至低效的echo输出调试吧！

后记

使用echo输出调试，很多时候是因为开发者懒，懒得集成调试工具，懒得去优化自己的开发环境。碰到小bug使用echo还行，一旦遇到诡异bug或者复杂的框架，紧紧靠echo已然无能为力。当然，单步调试的另一个好处是可以让初学者快速掌握项目的架构和执行流程。

书山有路勤为径，学海无涯苦作舟！！！