为 PhpStorm 配置 Xdebug 来调试代码

当项目越来越复杂，排错就越发困难。
你以为代码是这么运行的，但就是有未想到的功能导致流程变得不可捉摸。
此时我们需要调试啊调试...

PhpStorm 是一款优秀的 PHP IDE，排除其 Java 系出身导致的资源占用情况不理想外，其功能和易用性是毋庸质疑的。
好，再说下去就是软文了。

PhpStorm 内建了 Zend Debugger 和 Xdebug 支持，使用简单的配置我们就可以开始调试代码了。我们以 Xdebug 为例来说明下。

为 PHP 安装 Xdebug 扩展

Win 下的安装较为简单，直接下载适合的版本的 dll 文件，写入到 php.ini 配置中就可以了。
我们介绍下源代码编译方式。

在 Xdebug 下载页面找到最新的源代码，现在的版本是 2.2.1：

cd /Users/micate/Downloads/
wget http://xdebug.org/files/xdebug-2.2.1.tgz
tar zxvf xdebug-2.2.1.tgz
cd xdebug-2.2.1/
phpize
./configure; make
sudo make install

嗯，不出意外的话，会提示 xdebug.so 已经被放置在 ... 位置上。记住这个位置，复制下来。

打开 php.ini，在最后面追加下述配置：

[xdebug]
zend_extension="/usr/lib/php/extensions/no-debug-non-zts-20090626/xdebug.so"
xdebug.idekey="PHPSTORM"
xdebug.remote_host=127.0.0.1
xdebug.remote_enable=on

上面的位置要与刚刚安装的位置保持一致。关于 xdebug.so 如何配置，Xdebug 文档中有说明：

Configure PHP to Use Xdebug

add the following line to php.ini: zend_extension="/wherever/you/put/it/xdebug.so" (for non-threaded use of PHP, for example the CLI, CGI or Apache 1.3 module) or: zend_extension_ts="/wherever/you/put/it/xdebug.so" (for threaded usage of PHP, for example the Apache 2 work MPM or the the ISAPI module). Note: In case you compiled PHP yourself and used --enable-debug you would have to use zend_extension_debug=. From PHP 5.3 onwards, you always need to use the zend_extension PHP.ini setting name, and not zend_extension_ts, nor zend_extension_debug. However, your compile options (ZTS/normal build; debug/non-debug) still need to match with what PHP is using.
Restart your webserver.
Write a PHP page that calls 'phpinfo()' Load it in a browser and look for the info on the Xdebug module. If you see it next to the Zend logo, you have been successful! You can also use 'php -m' if you have a command line version of PHP, it lists all loaded modules. Xdebug should appear twice there (once under 'PHP Modules' and once under 'Zend Modules').

其中使用 zend_extension_ts 还是 zend_extension 还是神马神马，与 PHP 版本有关，仔细看上面的说明。

重启下 Web Server（Apache / Nginx），使用 phpinfo() 页面或命令行工具，确认模块安装完成。