ubuntuphpstorm如何调试

在 Ubuntu 下使用 PhpStorm 调试 PHP，通常有两种方式：

• ✅ 本地调试（CLI / Web）
• ✅ 远程调试（Xdebug + PHP-FPM / Docker）

下面以 最常用、最标准的 Xdebug 方案 来说明。

一、安装 Xdebug（Ubuntu）

1. 安装 PHP 和 Xdebug

sudo apt update
sudo apt install php php-xdebug

查看是否安装成功：

php -v
php -m | grep xdebug

二、配置 Xdebug（关键）

2. 找到 xdebug 配置文件

php --ini

一般在：

/etc/php/8.x/cli/conf.d/20-xdebug.ini

3. 编辑 Xdebug 配置

sudo nano /etc/php/8.x/cli/conf.d/20-xdebug.ini

写入（示例，PHP 8.x + Xdebug 3）：

zend_extension=xdebug.so

[xdebug]
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=PHPSTORM

⚠️ 如果是 Web 调试（Apache/Nginx），要改 fpm 配置

/etc/php/8.x/fpm/conf.d/20-xdebug.ini

重启 PHP-FPM：

sudo systemctl restart php8.x-fpm

三、配置 PhpStorm

4. 设置 PHP 解释器

1. File → Settings → PHP
2. CLI Interpreter → +
3. 选择系统 PHP

   /usr/bin/php
   

5. 配置 Debug 端口

Settings → PHP → Debug

• Debug port: 9003
• ✅ 勾选 Can accept external connections

6. 配置 Server（Web 调试必须）

Settings → PHP → Servers

• Name: localhost
• Host: localhost
• Port: 80
• Debugger: Xdebug
• ✅ Use path mappings（本地项目路径）

四、开始调试

✅ CLI 调试（命令行）

在 PhpStorm 中：

1. 打好断点
2. 右上角 ▶ 选择 Run → Debug
3. 执行：

php index.php

✅ Web 调试（浏览器）

1. PhpStorm 开启：

   Run → Start Listening for PHP Debug Connections
   

2. 浏览器安装插件：
   • Xdebug Helper（Chrome / Firefox）
3. 启用调试（绿色虫子）
4. 访问：

   http://localhost/project
   

五、常见问题

❌ 断点不生效

• 检查 xdebug.mode=debug
• 确认是 CLI 还是 FPM 配置
• 检查 path mapping

❌ 连接不上

telnet 127.0.0.1 9003

或检查防火墙

六、Docker / WSL 特殊情况（可选）

如果你是：

• Docker
• WSL2
• 远程服务器

告诉我你的环境，我可以给你 针对性配置方案。

如果你愿意，可以告诉我： ✅ Ubuntu 版本
✅ PHP 版本
✅ 本地 / 远程 / Docker
✅ Web 还是 CLI

我可以直接给你 一份完整可用的配置。