以不变应万变-- 如何根据你的Apache+php版本进行正确的Xdebug配置

一、前言
根据网上众多的配置教程，反复配置都没成功。其实配置成功关键与否在于针对不同的软件版本进行相应的配置。授人以鱼不如授之以渔，如果你的软件版本和笔者的不同，那么可以参考我提供的步骤，再结合你实际的版本做相应的调整就可以了。

二、配置环境
系统版本：Win7
phpstorm版本： 8.0.3
Xdebug版本： 2.1.2，PHP 5.3 VC9(32bit)
Chrome 版本： 46.0.2490.86 m
WampServer版本： 2.2(PHP 5.3.10, Apache 2.2.21)

三、安装步骤
1、选择正确的Xdebug版本。
选择正确的Xdebug版本是决定调试功能安装成功与否的关键。网上大多对如何选择Xdebug版本描述过少，其实这一步做好了，接下来的配置就相对简单很多。那如何选择Xdebug版本呢？
选择Xdebug版本要从三个角度来决定:
1）系统是32位还是64位？
2）php的版本是什么？
3）你的配置环境是否支持VC6、VC9、VC11?
以笔者的电脑配置环境为例，我的win7系统是32位，php版本5.3.10，登陆http://xdebug.org/download.php看到符合二者要求的有一大堆（见下图红圈部分）：



那么符合配置环境的到底是哪个呢？
Xdebug.org提供了一个在线测试版本的方法，登陆http://xdebug.org/wizard.php，将你的phpinfo()代码输出的结果，全部复制粘贴到wizard.php的输入框中，点击提交按钮，Xdebug.org会给你合理的版本建议。
但很遗憾，估计是我的php版本太低，Xdebug.org并未告诉我应该选择哪个版本。这里给出几个选择的建议，供大家参考：
1）网上有些文章说VC9版本是用于IIS的，VC6是用于apche服务器的。这里根据我的实践，可告诉大家，VC9版本是说Xdebug程序是用VC2008编译的，VC6版本是用VC6编译的，VC11是用Visual
Studio 2012编译的。如果你的电脑是安装了apache，一般是把PHP作为一个Module load到apache中，那么以apache父进程-多子进程的工作模式，是需要进行线程安全检查的，所以如果是以这种方式执行php，选择ts版本；如果你的电脑使用IIS配置PHP，那么需要选择Non-Thread
Safe(NTS)版本。
2）如果你安装的apache版本在2.2以上，php在5.3以上，建议优先使用VC9或VC11版本；反之，建议优先选择VC6版本。
根据以上原则，笔者选择的是Xdebug
2.1.2，PHP 5.3 VC9(32bit)版本。

2、将下载后的xdebug文件复制到正确的目录下。

下载后的xdebug程序是一个dll文件。 将dll文件拷贝到你的php的ext或zend_ext目录下。我的是拷贝到“zend_ext”文件夹下，如下图所示。对于只有ext文件夹的朋友来说，就可以拷贝到ext文件夹下。



3、PHP正确安装xdebug扩展。

找到你的php.ini文件，做如下配置（仅供参考）：
zend_extension = "C:/wamp/bin/php/php5.3.10/zend_ext/php_xdebug-2.1.2-5.3-vc9.dll"
[xdebug]
;是否开启自动跟踪

xdebug.auto_trace=
On
;是否开启异常跟踪
xdebug.show_exception_trace= On
;是否开启远程调试自动启动
xdebug.remote_autostart= On
;是否开启远程调试
xdebug.remote_enable =
On
;配置远程调试主机ip
xdebug_remote_host = "127.0.0.1"
;是否开启调试扩展信息
xdebug.extended_info=On
;是否开启调试内容
xdebug.profiler_enable
= On
;调试输出路径
xdebug.profiler_output_dir = "c:/wamp/tmp"
;调试插件dbgp
xdebug.remote_handler = dbgp
;远程调试的端口（默认9000）
xdebug.remote_port = 9000
;配置支持调试的ide
xdebug.idekey = phpStorm
;是否收集变量
xdebug.collect_vars= On
;是否收集返回值
xdebug.collect_return= On
;是否收集参数
xdebug.collect_params= On
;跟踪输出路径
xdebug.trace_output_dir="c:/wamp/tmp"

这里啰嗦几句，有三处也是极易出错的地方：
一是要找到正确的php.ini文件进行配置。我电脑上安装的是wamp，后来发现“C:\wamp\bin\apache\Apache2.2.21\bin”和“C:\wamp\bin\php\php5.3.10”两个文件路径下都有php.ini文件，但对于wamp而言，真正起作用的是“apache\Apache2.2.21\bin”路径下的php.ini文件，这点还需要读者留意；
二是配置“ zend_extension”的时候，注意要加引号，且文件路径是斜杠，而不是反斜杠。当然有人用反斜杠也是可以的，保险起见推荐用斜杠+引号格式；
三是配置远程调试的端口，请朋友查看是9000的端口是否被别的程序占用。查看方法请见百度经验“http://jingyan.baidu.com/article/3c48dd34491d47e10be358b8.html”。如果是被别的程序占用，建议改用9001或其他未被占用的端口试试。

4.验证PHP安装Xdebug扩展是否成功。
利用phpinfo(),查看输出是否有“xdebug”字样，如下图所示。如果出现了如下图的“xdebug”字样和相应的版本信息，则说明安装成功。如果没有出现“xdebug”,则原因很可能出现xdebug的版本选择错误，笔者之前反复安装没有成功，问题就出自版本的选择上。不知道如何选择版本的，建议读者多试试几个xdebug版本进行测试。



再对比下图红色部分的数据是否与php.ini的xdebug配置数据一致。如果一致则说明配置正确，否则建议进一步核查原因。



5.PhpStorm配置。
安装完php的xdebug扩展后，接下来就要在phpstorm上做好配置了。打开“File->"Settings..."，进入“Languages&Frameworks->PHP”,进行配置。



"PHP lanuage level:"选择你的php版本，“Interpreter”要选择你的php.exe所在的路径。当出现下图“PHP version:5.3.10”和“Debugger:Xdebug 2.1.2”时，说明你在phpstrom上已经成功配置了Xdebug。如果没有成功安装，"Debugger"会显示"Not installed"。笔者完成前面4步时，选择了正确的php.exe路径，"Debugger"会显示"not
installed"，无奈笔者先将"PHP executable:"的路径先设置为php_xdebug-2.1.2-5.3-vc9.dll所在的路径，后又重新选择php.exe的安装路径，“Not
installed”神奇地变成了“Xdebug 2.1.2”。



“PHP->Servers”请参考如下配置。



“PHP->Debug”请参考如下红框里的配置。Debug port要和php.ini的Xdebug端口配置一致。



“PHP->Debug->DBGp
Proxy”请参考如下配置。这里DBGp是一种在PHP和xdebug调试器之间传递通信的一种协议。注意要和前面php.ini的xdebug.remote_handler = dbgp、xdebug.idekey = phpStorm保持一致。



6.Chrome的Xdebug
helper插件配置。

做到这一步，笔者觉得还是挺繁琐的:D ，不过，Chrome作为php脚本语言的最终输出界面，必须要相应的支持xdebug功能，我们才能真正实现phpstorm调试功能。登陆http://www.chromein.com/crx_11294.html下载Xdebug
helper(1.3.0)插件，在chrome的“设置->扩展程序”下面，拖动下载的后的文件到里面去。如下两图所示。







成功安装后，会发现打开的页面输入栏里有个小虫子图标，对于我们要进行调试的页面，选择Debug模式，如下图所示。






7.开始你的调试之旅吧！

请参照如下设置进行调试。



8.验证你的phpstorm具备调试功能。
若发现Debugger窗口下“Frames”和“Variables”都有调试的相关信息，且Step Over、Step Into等按钮都是可用的，那么恭喜你，此时你已成功实现了phpstrome的调试功能了。



(全文完)