ubuntu phpstorm如何调试php

在 Ubuntu 下用 PhpStorm 调试 PHP，通常是通过 Xdebug 来实现。下面给你一套从 0 到能断点调试的完整步骤（非常常见、实用）。

一、安装 PHP 和 Xdebug

1. 安装 PHP（以 PHP 8.1 为例）

sudo apt update
sudo apt install php php-cli php-xdebug

如果你用 PHP 7.x，把 php8.1 换成对应版本即可。

2. 确认 Xdebug 已安装

php -v
php -m | grep xdebug

看到 xdebug 说明安装成功。

二、配置 Xdebug（关键）

1. 找到 php.ini

php --ini

通常是：

/etc/php/8.1/cli/php.ini
/etc/php/8.1/apache2/php.ini  # 如果用 Apache

2. 添加 Xdebug 配置

在 php.ini 末尾添加：

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

✅ 9003 是 PhpStorm 默认端口

3. 重启服务

• Apache:

sudo systemctl restart apache2

• PHP-FPM:

sudo systemctl restart php8.1-fpm

三、配置 PhpStorm

1. 设置 PHP 解释器

File → Settings → PHP

• CLI Interpreter → +
• 选择 /usr/bin/php

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（重要！本地和服务器路径一致）

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

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

1. 安装浏览器插件
   • Chrome: Xdebug Helper
2. 在 PhpStorm 中：
   • 点击 电话图标（Start Listening for PHP Debug Connections）
3. 浏览器开启 Xdebug Helper → Debug
4. 访问页面
5. PhpStorm 自动断点

✅ 方式二：命令行调试（CLI）

export XDEBUG_MODE=debug
php your_script.php

PhpStorm 会直接断住。

五、常见问题排查

❌ 连不上 PhpStorm

• 防火墙：9003 是否放行
• client_host 是否 127.0.0.1
• PhpStorm 是否点了 Listen

❌ 断点不生效

• 路径映射错误
• 文件不在项目根目录
• OPcache 影响（可临时关掉）

六、推荐组合

• Ubuntu + PHP + Nginx/Apache
• PhpStorm + Xdebug 3
• Xdebug Helper

如果你用的是 Docker / Laravel / Nginx / PHP-FPM，告诉我，我可以直接给你对应配置。