php项目使用xdebug远程调试

2022-03-10 作者: try catch

0. 目的、原理和调用流程

访问测试环境的页面，在本地开发机打断点调试。相当流弊的功能，方便代码排查原因。

原理：

运行xdebug需要客户端IDE（phpstorm）、远程服务器配合，首先是客户端配置好端口，发送debug请求，请求会通过浏览器或者IDE的http请求，携带特定的参数发送到服务端，服务端收到请求后，发现这是一个xdebug请求，则与IDE建立dpgp连接，当遇到断点时候，返回调试信息给IDE

服务器的IP是10.0.1.2，端口80上有HTTP
IDE位于未知IP上，因此xdebug.remote_connect_back设置为1
IDE侦听端口9000，因此xdebug.remote_port设置为9000
发出HTTP请求，Xdebug从HTTP头中检测IP地址
Xdebug连接到端口9000上检测到的IP（10.0.1.42）
调试运行，提供HTTP响应

调用流程：

以上内容摘自，感谢原作者。

好的，搞清楚原理之后，把上面的Ip、端口号这些统统忘记，以免跟下面演示的IP、端口搞混。（搞不清楚就算了，反正也要忘记 ^ _ ^ ）现在我们正式开始一段愉快的学习之旅吧。

1.机器环境：

2.Linux服务器安装xdebug扩展

2.1.下载对应版本的xdebug扩展包

最新版本下载地址：
历史版本下载地址：我下载的是这个版本。

2.2.上传到服务器的目录下，解压并进入目录：

tar-zxvf xdebug-2.5.4-tgz
cd /opt/xdebug-2.5.4

2.3.执行php安装扩展包的命令

/opt/remi/php56/root/bin/phpize

我在执行此命令后报错，原因是没有安装php-devel开发工具:

于是先安装php-dev工具:

#列出安装包的所有版本
yum list | grep php-devel
#找到对应版本的安装包，执行安装
yum install php56-php-devel.x86_64

操作过程如下图：

2.4.重新执行命令

/opt/remi/php56/root/bin/phpize

2.5. 编译xdebug扩展包

./configure --enable-xdebug --with-php-config=/opt/remi/php56/root/bin/php-config

执行成功，再执行:

make && make install

2.6. 安装成功后，去php modules路径下看看，是否有xdebug.so文件：

3. Linux服务器配置php.ini

3.1. 在php.ini文件中追加参数：

zend_extension="xdebug.so"
xdebug.remote_enable=On
#本地开发机端口，测试服务器会讲debug信息发送到此端口
xdebug.remote_port=9009
xdebug.idekey=PHPSTORM
#如果开启此remote_connect_back，则忽略xdebug.remote_host的参数
xdebug.remote_connect_back = 1
xdebug.remote_handler = dbgp
xdebug.auto_trace = 1
xdebug.remote_log = /tmp/xdebug.log