ubuntu phpstorm远程调试方法

Ubuntu下PhpStorm远程调试PHP代码步骤

1. 安装Xdebug扩展

在Ubuntu远程服务器上，通过终端安装Xdebug扩展（以Ubuntu 22.04+、PHP 8.1为例）：

sudo apt update
sudo apt install php-xdebug

安装完成后，Xdebug会自动集成到PHP环境中，但需进一步配置。

2. 配置Xdebug参数

编辑PHP配置文件（根据PHP运行模式选择对应文件，如Apache用apache2/php.ini，PHP-FPM用fpm/php.ini）：

sudo nano /etc/php/8.1/apache2/php.ini

在文件末尾添加以下配置（关键参数说明见注释）：

[xdebug]
zend_extension=xdebug.so                # Xdebug扩展路径（Ubuntu自动填充）
xdebug.mode=debug                       # 启用调试模式
xdebug.client_host=192.168.1.100        # 本地机器（PhpStorm所在）的IP地址
xdebug.client_port=9003                 # 调试端口（需与PhpStorm设置一致）
xdebug.start_with_request=yes           # 自动启动调试（可选：trigger/yes）
xdebug.idekey=PHPSTORM                  # IDE标识（需与PhpStorm一致）

保存文件后，重启Apache服务使配置生效：

sudo systemctl restart apache2

注意：若使用PHP-FPM，需重启php8.1-fpm服务；client_host需替换为本地机器的实际IP（可通过ip a命令查看）。

3. 配置PhpStorm远程解释器

1. 打开PhpStorm，点击顶部菜单File > Settings（或Ctrl+Alt+S）。
2. 导航至Languages & Frameworks > PHP > Servers，点击+添加新服务器：
   • Name：自定义服务器名称（如Remote Ubuntu Server）。
   • Host：远程服务器的IP地址或域名（如192.168.1.100）。
   • Port：Web服务器端口（默认80或443）。
   • Debugger：选择Xdebug。
3. 点击Test Connection验证与远程服务器的连接（需确保网络可达），确认后点击OK保存。

4. 配置调试监听端口

1. 在Settings窗口中，导航至Languages & Frameworks > PHP > Debug。
2. 确认Debug port设置为与Xconfig中client_port一致的值（如9003）。
3. （可选）勾选Use path mappings，将本地项目目录映射到远程服务器目录（如本地/home/user/project映射到远程/var/www/html/project），避免路径错误。

5. 启动远程调试会话

1. 在PhpStorm中打开远程项目（通过Deployment配置同步远程代码至本地，或直接打开本地副本）。
2. 在代码行号左侧点击设置断点（红色圆圈）。
3. 点击顶部工具栏的电话听筒图标（Start Listening for PHP Debug Connections），启动调试监听。

6. 触发断点调试

在浏览器中访问远程PHP应用，需在URL中添加Xdebug会话参数（以Chrome为例）：

http://192.168.1.100/project/index.php?XDEBUG_SESSION_START=PHPSTORM

或安装Xdebug Helper浏览器插件（设置IDE Key为PHPSTORM），点击插件图标即可触发调试。
当代码执行到断点时，PhpStorm会自动切换至调试视图，可查看变量、调用堆栈、单步执行（F7/F8）等。

常见问题排查

• 无法连接：检查本地机器防火墙是否允许client_port（如9003）的入站连接；确认client_host为本地正确IP。
• 端口冲突：若9003端口被占用，修改php.ini中的client_port为其他端口（如9004），并同步更新PhpStorm设置。
• 路径映射错误：确保Servers配置中的Path mappings正确，否则断点无法命中。