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