Xdebug+Phpstorm远程调试

开发环境：

本地 Windows10 日常开发使用的环境 装有PHPStorm 

远程主机 Linux  服务器 装php-fpm/nginx等所有开发依赖环境

本地可以访问远程主机 但远程主机无法访问本地 

目的

远程调试（remote debug）在windows本地环境下 调试远程服务器（Linux）上的代码

问题

之前一直认为 php-xdebug 的扩展的remote_debug 只能够支持本地环境下调试

其实原因是没有准备好调试环境  (远程的服务器上无法访问到本地的调试端口 需要通过ssh隧道端口映射 建立连接)

其client 和 server 的对应关系如下图 

本地的PHPSTORM 在开启断点服务后 会打开一个的调试服务 (默认端口为 9000)

用于与服务器进通过DBGP行通信

但本地环境是处于局域网内 服务器无法通过IP 直接访问IDE的调试端口

步骤

1. 远程主机上安装 php_xdebug 扩展

　　1) 下载xdebug扩展包  https://xdebug.org/docs/install

　　2）之前安装依赖

yum install php-devel autoconf automake

　　3）解压

tar -xvzf xdebug-2.9.0.tgz

 　　4）执行编译安装

cd xdebug-2.9.0

phpize

./configure

make && make install

2. 修改配置文件php.ini 并重启php-fpm

[xdebug]

zend_extension=/webser/soft/php72/lib/php/extensions/xdebug.so

xdebug.remote_enable=1

xdebug.remote_port=9001

xdebug.remote_host=127.0.0.1

xdebug.remote_log=/var/log/php-xdebug.log

xdebug.idekey="PHPSTORM"

然后查看phpinfo信息 检查配置是否生效

3. 本地与远程主机建立ssh隧道>端口转移 使远程主机能够访问到IDE的9001端口

 

远程主机上键入telnet命令# telnet 127.0.0.1 9001 检查是否能够访问9001 端口

(这里因为端口冲突 默认9000 改为9001 php.ini 与 PHPSTORM配置 保持一致)

4. PHPSTORM debug配置

 

添加Server 并配置IDE KEY (需与php.ini 中保持一致)

最后点击绿色的甲虫和电话筒 打开调试 并打上断点

 

Run (运行) > Break at first line in PHP scripts 设置php断点在脚本第一行

5. 安装xdebug_helper 或者 在请求中携带 IDEKey 即可触发调试

扩展: 当我们在需要再命令行模式中启用xdebug 时 可以通过以下方式 配置session_key

## When running the script from the command line 
## you need to set an environment variable, like:
Linux 环境中:
export XDEBUG_CONFIG="idekey=session_name"
php myscript.php

Windows 环境中:
set XDEBUG_CONFIG="idekey=session_name"

面板使用：

左侧
绿色三角形 ： Resume Program，表示將继续执行，直到下一个中断点停止。
红色方形 ： Stop，表示中断当前程序调试。

上方
第一个图形示 ： Step Over，跳过当前函数。
第二个图形示 ： Step Into，进入当前函数內部的程序（相当于观察程序一步一步执行）。
第三个图形示 ： Force Step Into，強制进入当前函数內部的程序。
第四个图形示 ： Step Out，跳出当前函数內部的程式。
第五个图形示 ： Run to Cursor，定位到当前光标。

 参考：

　　https://juejin.im/post/6844903728193994766

　　https://learnku.com/articles/39479