ubuntu phpstorm怎么调试

在 Ubuntu 下使用 PHPStorm 调试 PHP，通常是通过 Xdebug 来实现的。下面给你一个从 0 到可调试的完整流程（以 PHP 7.x / 8.x + PHPStorm 2022+ 为例）。

一、安装 Xdebug

1. 确认 PHP 版本

php -v

2. 安装 Xdebug

如果是用 apt 安装的 PHP：

sudo apt install php-xdebug

如果你用的是 PHP 8.1：

sudo apt install php8.1-xdebug

安装完成后查看：

php -m | grep xdebug

二、配置 Xdebug（关键）

1. 找到 php.ini

php --ini

一般路径是：

/etc/php/8.1/cli/php.ini
/etc/php/8.1/apache2/php.ini

Web 调试改 apache/fpm 的 ini 命令行调试改 cli 的 ini

2. 添加 Xdebug 配置

在对应 php.ini 末尾添加：

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

⚠️ PHPStorm 2020+ 默认端口是 9003（不是 9000）

重启服务：

sudo service apache2 restart
# 或
sudo service php8.1-fpm restart

三、PHPStorm 配置

1. 设置 PHP 解释器

File → Settings → PHP

• CLI Interpreter → 选择 Ubuntu 的 PHP
• 确认 Xdebug 已识别 ✅

2. 配置 Debug

Settings → PHP → Debug

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

3. 配置 Server

Settings → PHP → Servers

• Name: localhost
• Host: localhost
• Port: 80 或 8080
• Debugger: Xdebug
• 勾选 Use path mappings
  • 本地项目路径 ↔ 服务器路径（如果是本地就一样）

四、开始调试

方式一：浏览器调试（Web）

1. 安装浏览器插件
   • Chrome: Xdebug Helper
2. 选择 Debug
3. PHPStorm 点 电话图标（Listen for debug connections）
4. 浏览器访问页面
5. 命中断点 ✅

方式二：命令行调试

export XDEBUG_MODE=debug
export XDEBUG_CONFIG="idekey=PHPSTORM"
php index.php

PHPStorm 会直接弹窗进入调试。

五、常见问题

1. 连不上

• 防火墙
• port 不对（9000 vs 9003）
• 没开 Listen

2. 断点不生效

• path mapping 没配
• 调试的是 CLI 但配的是 Web

3. 多个 PHP 版本

update-alternatives --config php

六、示例组合

• Ubuntu 22.04
• PHP 8.1
• PHPStorm 2023
• Apache / Nginx + FPM

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

• PHP 版本
• Web 服务器（Apache / Nginx）
• 本地还是远程项目

我可以直接给你 精确配置。