PhpStorm Ubuntu如何调试

在 Ubuntu 下使用 PhpStorm 调试 PHP，最常用的是 Xdebug。下面给你一套从 0 到能断点调试的完整流程（适用于 PHP CLI / Web 项目）。

一、环境准备

1️⃣ 安装 PHP 和 Xdebug

sudo apt update
sudo apt install php php-cli

查看 PHP 版本：

php -v

安装 Xdebug（以 PHP 8.2 为例）：

sudo apt install php8.2-xdebug

如果是其他版本：

sudo apt install php8.1-xdebug
sudo apt install php8.3-xdebug

确认是否安装成功：

php -m | grep xdebug

二、配置 Xdebug（关键）

1️⃣ 找到 php.ini

php --ini

通常路径：

/etc/php/8.2/cli/php.ini

或：

/etc/php/8.2/apache2/php.ini

2️⃣ 添加 Xdebug 配置

在 php.ini 末尾添加：

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=yes

✅ Xdebug 3 默认端口是 9003（不是 9000）

重启服务（如果是 Web 项目）：

sudo systemctl restart apache2
# 或
sudo systemctl restart php8.2-fpm

三、PhpStorm 配置

1️⃣ 打开 PHP 解释器设置

Settings → PHP

• PHP language level：选择你的版本
• CLI Interpreter：
  • 点击 ...
  • 选择 /usr/bin/php
  • 确认能看到 Xdebug

2️⃣ 启用 Debug

Settings → PHP → Debug

确认：

• ✅ Debug port：9003
• ✅ Can accept external connections

3️⃣ 配置 Server（Web 项目必须）

Settings → PHP → Servers

• Name：随意（如 local)
• Host：localhost
• Port：80 或 8000
• Debugger：Xdebug
• ✅ Use path mappings
  • 把项目目录映射到服务器路径

四、开始调试

✅ 方式一：PHP CLI 调试（脚本）

1. 在代码里打断点
2. 右上角选择：

   Run → Debug 'xxx.php'
   

3. 程序会在断点处停住

✅ 方式二：浏览器调试（Web）

1️⃣ 安装浏览器插件

• Xdebug Helper（Chrome / Firefox）

2️⃣ 启动 Debug 监听

Run → Start Listening for PHP Debug Connections

3️⃣ 浏览器访问页面

• 点击 Xdebug Helper → Debug
• 刷新页面
• PhpStorm 自动断点

五、常见问题排查

❌ 断点不起作用

✅ 检查：

php -i | grep xdebug

✅ 确认：

• PhpStorm 在 Listening
• xdebug.client_port=9003
• 没有防火墙拦截

❌ 端口冲突

sudo netstat -tlnp | grep 9003

六、常用调试快捷键

七、推荐调试方式总结

如果你愿意，可以告诉我：

• ✅ PHP 版本
• ✅ 是 CLI 还是 Web
• ✅ 是否用 Laravel / ThinkPHP

我可以给你 针对你项目的精确配置方案。