ubuntu phpstorm怎样调试

在 Ubuntu 下用 PhpStorm 调试 PHP，通常有两种方式：Xdebug（最常用） 和 Zend Debugger（较少用）。下面以 Xdebug + PHP-FPM / CLI 为例，一步步说明。

一、安装 Xdebug（Ubuntu）

1. 安装 Xdebug

sudo apt update
sudo apt install php-xdebug

如果你用的是 PHP 8.1：

sudo apt install php8.1-xdebug

2. 确认安装成功

php -m | grep xdebug

有输出说明安装成功。

二、配置 Xdebug（php.ini）

1. 找到 php.ini

php --ini

2. 编辑 Xdebug 配置

在 php.ini 或 /etc/php/8.x/cli/conf.d/20-xdebug.ini 中添加：

zend_extension=xdebug

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

⚠️ 如果是 PHP-FPM，需要改： /etc/php/8.x/fpm/conf.d/20-xdebug.ini

3. 重启服务

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

三、配置 PhpStorm

1. 设置 PHP 解释器

File → Settings → PHP
CLI Interpreter → +
选择系统 PHP（如 /usr/bin/php)

2. 配置 Debug

Settings → PHP → Debug
Xdebug port: 9003
勾选 Can accept external connections

3. 配置 Servers

Settings → PHP → Servers
添加：
- Name: localhost
- Host: localhost
- Port: 80
- Debugger: Xdebug
勾选 Use path mappings（如果是 Docker / 虚拟机）

四、调试方式

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

在 PhpStorm 点 电话图标（Start Listening）
浏览器安装：
- Xdebug Helper（Chrome）
- 或 Firefox Xdebug
设置 IDE Key = PHPSTORM
访问页面
PhpStorm 自动断点

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

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

或在 PhpStorm：

Run → Edit Configurations
添加 PHP Script
选择入口文件
点 Debug ▶

五、常见问题

❌ 断点不生效

没开 Listening
php.ini 没加载
path mapping 不对
端口被占用

❌ 连接超时

sudo ufw allow 9003

六、如果你用 Docker

告诉我：

PHP 版本
是否 Docker
WebServer（Nginx/Apache）

我可以给你 Docker + PhpStorm 的完整配置。

如果你愿意，我也可以： ✅ 给你一份 完整 php.ini ✅ 教你 单步调试 / 变量监视 ✅ 配 Laravel / ThinkPHP 调试

直接说你的环境即可。