PHPStorm在Ubuntu上的调试功能怎么设置

PHPStorm在Ubuntu上的调试功能设置步骤

1. 安装Xdebug扩展

首先确保Ubuntu系统已安装PHP和Xdebug。通过终端运行以下命令安装Xdebug：

sudo apt-get update
sudo apt-get install php-xdebug

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

2. 配置php.ini文件

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

[Xdebug]
zend_extension=xdebug.so  # 加载Xdebug扩展（Ubuntu下通常无需指定完整路径）
xdebug.mode=debug         # 启用调试模式
xdebug.client_host=127.0.0.1  # 调试客户端IP（本地开发设为127.0.0.1）
xdebug.client_port=9003   # 调试端口（Xdebug 3默认端口，需与PHPStorm一致）
xdebug.start_with_request=yes  # 自动启动调试（可选：trigger/yes）
xdebug.idekey=PHPSTORM    # IDE标识（需与PHPStorm设置一致）

修改后保存文件，并重启Web服务器（Apache/Nginx）和PHP-FPM使配置生效：

# 重启Apache
sudo systemctl restart apache2

# 重启PHP-FPM（根据PHP版本调整，如php8.2-fpm）
sudo systemctl restart php8.2-fpm

# 若使用Nginx，需同时重启Nginx
sudo systemctl restart nginx

3. 配置PHPStorm

3.1 设置PHP解释器

打开PHPStorm，点击顶部菜单栏File > Settings（或Ctrl+Alt+S），展开Languages & Frameworks > PHP，点击Interpreter右侧的...按钮，选择本地PHP解释器（如/usr/bin/php），点击OK保存。

3.2 添加Servers配置

在Languages & Frameworks > PHP > Servers中点击+号，输入服务器名称（如Local），设置Host为localhost、Port为80（或你的Web服务器端口），点击OK。

3.3 配置Debug设置

进入Languages & Frameworks > PHP > Debug，确保Xdebug选项已启用，Debugger port设置为9003（与php.ini中的client_port一致）。点击右上角齿轮图标，确认PHP Web Page配置正确。

4. 设置断点

在PHPStorm中打开需要调试的PHP文件，在代码行号左侧单击，设置断点（红色圆圈表示断点已启用）。

5. 启动调试会话

5.1 启动调试模式

点击PHPStorm顶部工具栏的绿色电话图标（或按Shift+F9），选择已配置的服务器（如Local），启动调试会话。

5.2 触发断点

在浏览器中访问你的PHP应用（如http://localhost/your_project/index.php），当代码执行到断点时，PHPStorm会自动切换到调试视图，显示变量值、调用堆栈等信息。

6. 调试控制

• Step Over（F8）：执行当前行，跳过函数内部。
• Step Into（F7）：进入当前行的函数内部。
• Step Out（Shift+F8）：跳出当前函数。
• Resume Program（F9）：继续执行到下一个断点。
• Stop（Ctrl+F2）：终止调试会话。

常见问题排查

• Xdebug未加载：检查php.ini中zend_extension路径是否正确，重启Web服务器。
• 端口冲突：确保xdebug.client_port（默认9003）未被其他程序占用，可在php.ini中修改为其他端口（如9004）。
• 断点不生效：确认xdebug.start_with_request=yes已设置，检查PHPStorm的Debug配置是否正确。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！