开发环境:
本地 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
,定位到当前光标。
参考: