Ubuntu PHPStorm如何调试

在 Ubuntu + PhpStorm 下调试 PHP，最常用的是 Xdebug。下面给你一套从 0 到能断点调试的完整流程（适用于 PHP 7.x / 8.x）。

一、安装 Xdebug（Ubuntu）

1️⃣ 确认 PHP 版本

php -v

2️⃣ 安装 Xdebug

sudo apt update
sudo apt install php-xdebug

如果是 PHP 8+，Ubuntu 仓库通常已支持。

3️⃣ 确认是否安装成功

php -m | grep xdebug

看到 xdebug 即成功。

二、配置 Xdebug（关键）

1️⃣ 找到 php.ini

php --ini

通常是：

/etc/php/8.x/cli/php.ini
/etc/php/8.x/apache2/php.ini 或 fpm/php.ini

2️⃣ 添加 Xdebug 配置（推荐）

[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

3️⃣ 重启服务

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

三、PhpStorm 配置

1️⃣ 设置 PHP 解释器

Settings → PHP → CLI Interpreter

选择系统 PHP（如 /usr/bin/php）

2️⃣ 启用 Xdebug 调试

Settings → PHP → Debug

确认：

Debug port：9003
✅ Can accept external connections

3️⃣ 配置 Server

Settings → PHP → Servers

Name：随意（如 local)
Host：localhost
Port：80 或 443
Debugger：Xdebug
✅ Use path mappings（本地项目路径 ↔ 服务器路径）

四、开始调试（两种方式）

✅ 方式一：浏览器调试（最常用）

1️⃣ 安装浏览器插件

Chrome：Xdebug Helper
Firefox：Xdebug Helper

2️⃣ 打开插件

选择 Debug

3️⃣ PhpStorm 开启监听

Run → Start Listening for PHP Debug Connections

4️⃣ 访问页面

http://localhost/your-project

✅ 命中断点即成功！

✅ 方式二：PhpStorm 一键调试（推荐）

Run → Edit Configurations

新建 PHP Web Page
Server：选择刚才配置的
Start URL：/index.php

点击 ▶ Debug 按钮

五、常见问题排查

❌ 断点不生效

✅ 检查：

xdebug.mode=debug
PhpStorm 是否监听
浏览器插件是否开启
端口是否一致（9003）

❌ 端口被占用

netstat -tunlp | grep 9003

❌ CLI 调试失败

CLI 调试需设置：

export XDEBUG_MODE=debug
php your_script.php

六、常用调试技巧

功能	说明
F8	单步跳过
F7	进入函数
Shift+F8	跳出
查看变量	Debug 窗口
条件断点	右键断点设置

七、总结一句话

Ubuntu + PhpStorm 调试 PHP = 安装 Xdebug + 配置 9003 + PhpStorm 监听 + 浏览器触发

如果你用的是：

✅ Docker
✅ Laravel / ThinkPHP
✅ CLI 调试
✅ Nginx + PHP-FPM

告诉我，我可以给你对应环境的专用配置方案。