在配置过程中参考了一些文章, 中英文的都有.. 但是都不能完整地解决这个问题. 经过一些折腾终于可以调试了, 现记录如下, 希望对后来人有所帮助.
1. 安装xdebug
第一步: 得到本地PHP配置信息
在终端中运行: php -i > outputphp.txt
然后将得到的txt文件中的信息拷贝并复制到http://xdebug.org/wizard.php 这个页面提供的一个textarea中. 然后点击下方的Analyze按钮, 它会自动帮你解析你本地的PHP环境信息从而得到你需要下载的xdebug版本和相关配置指令.
第二步: 得到需要下载的版本和相关指令
立即学习“PHP免费学习笔记（深入）”；
比如, 我得到的信息如下:
- Download xdebug-2.3.2.tgz
- Unpack the downloaded file with tar -xvzf xdebug-2.3.2.tgz
- Run: cd xdebug-2.3.2
Run: phpize (See the FAQ if you don’t have phpize.
部分输出如下所示:
Configuring for:
…
Zend Module Api No: 20121212
Zend Extension Api No: 220121212
如果没有以上输出, 那么代表你的phpize有问题. 参考FAQ.Run: ./configure
- Run: make
- Run: cp modules/xdebug.so /usr/lib/php5/20121212
以上有些步骤也许需要sudo.
第三步: 向php.ini中添加配置项
sudo vim /etc/php5/cli/php.ini
zend_extension = /usr/lib/php5/20090626/xdebug.so
xdebug.remote_host = 127.0.0.1
xdebug.remote_enable = 1
xdebug.remote_port = 9000
xdebug.remote_handler = dbgp
xdebug.remote_mode = req
如非必要, 以上的配置项不需要修改. 之前我就是想当然的将remote_port那一项修改成了我的应用在Server上的端口号, 导致无法调试. 花了好些时间才定位到是这里的问题.
到这里, xdebug就安装成功了. 可以通过php ?version命令进行验证:
PHP 5.5.9-1ubuntu4.7 (cli) (built: Mar 16 2015 20:47:39) Copyright
(c) 1997-2014 The PHP Group Zend Engine v2.5.0, Copyright (c)
1998-2014 Zend Technologies
with Xdebug v2.3.2, Copyright (c) 2002-2015, by Derick Rethans
with Zend OPcache v7.0.3, Copyright (c) 1999-2014, by Zend Technologies
可以发现输出中已经存在了Xdebug的信息.
2. 安装 Xdebug extension helper
在主流的浏览器上都有xdebug的扩展助手插件, 能够帮助你方便的打开或者关闭调试功能, 为什么需要这个插件, 可以参考这篇文章中的4, 5, 6小节(是英文的, 有兴趣的同学可以自行查阅)
以Chrome为例, 在这里找到插件的安装地址:
https://chrome.google.com/webstore/detail/xdebug-helper/eadndfjplgieldjbigjakmdgkmoaaaoc?hl=en
如果打不开, 可以参考这篇文章, 介绍了如何利用插件的ID进行离线下载, 毕竟现在Google的服务全面被墙…..
Xdebug helper的插件ID是: eadndfjplgieldjbigjakmdgkmoaaaoc
安装完毕之后, 打开该插件的options, 设置IDEKey为PhpStorm.
3. 配置PhpStorm
终于到最后一步了, 这一步很简单.
就是勾选Run菜单下的Start Listening for PHP Debug Connections.
然后在你需要调试的地方打个断点, 最后在浏览器中输入PHP脚本的地址就可以了. 注意要启用之前安装的Xdebug Helper.
启用的方法是:
OK, 开心地进行调试吧!!!
原理示意图(从xdebug的官网上引用的)
主要参考文章:
https://confluence.jetbrains.com/display/PhpStorm/Zero-configuration+Web+Application+Debugging+with+Xdebug+and+PhpStorm
http://icephoenix.us/php/how-to-setup-local-php-debugging-with-phpstorm-and-xdebug/
http://xdebug.org/docs/remote#starting
