Ubuntu上PHPStorm的调试功能怎么用

Ubuntu上PHPStorm调试功能配置与使用指南

1. 安装Xdebug扩展

首先确保Ubuntu系统已安装PHP及Xdebug扩展。通过终端执行以下命令安装：

sudo apt-get update
sudo apt-get install php-xdebug  # 若使用特定PHP版本（如8.1），替换为php8.1-xdebug

安装完成后，通过php -v命令检查Xdebug是否加载成功（输出中应包含“with Xdebug”字样）。

2. 配置php.ini文件

找到PHP配置文件（路径可通过php --ini命令查看，通常为/etc/php/{version}/cli/php.ini或/etc/php/{version}/fpm/php.ini），在文件末尾添加以下Xdebug配置：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1  # 本地调试，若远程调试需改为服务器IP
xdebug.client_port=9003       # PHPStorm默认监听端口（需与后续配置一致）
xdebug.start_with_request=yes # 自动启动调试（可选：trigger/yes）

保存后重启PHP服务（根据环境选择）：

sudo systemctl restart php{version}-fpm  # PHP-FPM环境
sudo systemctl restart apache2           # Apache环境
sudo systemctl restart nginx             # Nginx环境

3. 配置PHPStorm

3.1 设置PHP解释器

打开PHPStorm，点击顶部菜单栏File > Settings（或PhpStorm > Preferences，macOS用户）。
导航至Languages & Frameworks > PHP，点击CLI Interpreter右侧的齿轮图标，选择Add。
选择Local Path to Interpreter，浏览至PHP可执行文件路径（如/usr/bin/php），点击OK保存。

3.2 配置调试服务器

在Settings中，导航至Languages & Frameworks > PHP > Servers，点击+添加新服务器。
输入服务器名称（如Local Server），设置Host为localhost（远程调试则填服务器IP），Port为80（HTTP）或443（HTTPS）。
勾选Use path mappings（若项目在远程服务器，需映射本地项目路径至远程路径，如本地/home/user/project→远程/var/www/html）。
点击OK保存服务器配置。

3.3 配置调试选项

导航至Languages & Frameworks > PHP > Debug，确保Xdebug选项已启用。
检查Debug port是否为9003（与php.ini中的client_port一致）。
（可选）勾选Can accept external connections（远程调试需开启）。

4. 设置断点

在PHP代码中，点击行号左侧的空白区域，设置断点（红色圆圈标识）。可选择多个断点，调试时会在这些位置暂停。

5. 启动调试会话

5.1 浏览器调试

点击PHPStorm顶部工具栏的绿色蜘蛛图标（或按Shift+F9），选择已配置的服务器（如Local Server），点击OK。
在浏览器中访问项目URL（如http://localhost），请求会触发Xdebug，PhpStorm自动切换至调试视图，暂停在第一个断点处。

5.2 CLI脚本调试

点击顶部菜单栏Run > Edit Configurations，点击+选择PHP Script。
设置Script path为要调试的CLI脚本路径（如/home/user/script.php），选择已配置的PHP解释器。
点击OK保存，然后点击工具栏的绿色三角形图标（或按Shift+F10）启动调试。

6. 使用调试工具

调试启动后，PhpStorm会显示Debug工具窗口，包含以下功能：

Step Over（F8）：执行当前行，跳至下一行。
Step Into（F7）：进入当前行的函数/方法内部。
Step Out（Shift+F8）：跳出当前函数/方法，返回调用处。
Resume Program（F9）：继续执行至下一个断点或结束。
Stop（Ctrl+F2）：终止调试会话。
Variables面板：查看当前作用域的变量值（可修改变量值进行测试）。
Call Stack面板：查看函数调用堆栈，了解代码执行流程。

注意事项

防火墙设置：确保Ubuntu防火墙（ufw）允许调试端口（如9003）的流量：sudo ufw allow 9003/tcp。
路径映射：远程调试时，必须正确配置本地与远程项目的路径映射，否则无法定位文件。
Xdebug版本：建议使用Xdebug 3.x版本（Ubuntu默认仓库通常提供），若使用旧版（2.x），配置参数（如xdebug.remote_enable）需调整。