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 扩展

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"
复制代码