phpstorm ＋ xdebug 远程断点调试

2024-11-28 技术教程

CentOS（Linux）下安装Xdebug

Xdebug是一个开放源代码的PHP程序调试器(即一个Debug工具)，可以用来跟踪，调试和分析PHP程序的运行状况，本文主要记录一下在centos（linux）下xdebug的安装和配置方法。

首先让php错误显示，只需要修改php.ini当中的2条指令，把 displayerrors和htmlerrors都设置为On，如下所示：

html_errors = On
display_errors = On

当然如果你要需要查看更多信息，比如说打印调用栈，哪就需要安装xdebug，这个对于比较复杂的代码系统特别有帮助。

xdebug是php的一个module，需要编译安装，我用lnmp安装的php，php被默认安装到/usr/local/php，然后做一个硬链接到/usr/bin。

（1）下载xdebug

xdebug 下载地址页：https://xdebug.org/download.php

wget https://xdebug.org/files/xdebug-2.4.0rc4.tgz

注意：xdebug的版本需与您的php版本相对应，由于我的php是5.6，所以这里下载是：xdebug2.4

（2）编译xdebug

然后开始编译

tar xzf xdebug-2.4.0rc4.tgz

cd xdebug-2.4.0RC4/

phpize

注意这里如果你的phpize没有加入到环境变量的话，需要带该文件的全路径

./configure --enable-xdebug --with-php-config=/usr/local/php/bin/php-config

这里的php-config参数要改为你实际的php-config地址额，不知道的话自己搜吧。

make

make test

make install

（4）配置php.ini

编译完成之后可以去php的安装目录通过find搜索一下是否生成了xdebug.so文件。如果生成成功，就可以直接配置php.ini文件了。具体配置代码如下：

[Xdebug]
zend_extension="/usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/xdebug.so"
xdebug.profiler_enable=on
xdebug.trace_output_dir="/usr/local/php5/xdebug/"
xdebug.profiler_output_dir="/usr/local/php5/xdebug/"
xdebug.remote_enable=on
xdebug.remote_handler=dbgp
;xdebug.remote_host=localhost
xdebug.remote_port=9999

重启php-fpm，可以通过phpinfo()检查你的xdebug是否安装成功，也可以随便写段错误的php代码，刷新浏览器，就能看到错误提示。

xdebug配置

1.在php.ini配置文件中添加如下内容
zend_extension="/wherever/you/put/it/xdebug.so"
2.如果是php5.3之前版本线程安全，添加如下内容代替上面1的内容
zend_extension_ts="/wherever/you/put/it/xdebug.so"
3.自从php5.3之后zend_extension_ts, zend_extension_debug不再使用

4.xdebug的一些其他配置

;显示错误信息xdebug.default_enable=1;函数调试xdebug.auto_trace=onxdebug.trace_output_dirxdebug.trace_output_name;Type:string,Defaultvalue:trace.%cxdebug.collect_params=1|3|4(参数长度，参数值，参数=值)xdebug.show_mem_delta=1显示内存xdebug.collect_return=1显示返回值xdebug.trace_options=1追加日志xdebug.collect_params=1xdebug.collect_vars=1;开启性能分析xdebug.profiler_enable=1;性能分析日志保存目录xdebug.profiler_output_dir=/data/logs/xdebug/;性能分析日志文件名称xdebug.profiler_output_name=cachegrind.out.log;默认是如下格式,t时间,p进程id;xdebug.profiler_output_name=cachegrind.out.%t.%p;代码覆盖率xdebug.coverage_enable=1;以下是远程调试配置xdebug.remote_host=127.0.0.1xdebug.remote_connect_back=1xdebug.remote_port=9000xdebug.remote_log="/data/logs/xdebug/xdebug.log"

4.重启php使配置生效

性能分析日志工具

1.linux平台

工具KCacheGrind (Linux, KDE)https://kcachegrind.github.io/

2.win平台查看工具WinCacheGrind