PhpStorm本地断点调试

封面图 • 2026-01-14 • PHP

在 PhpStorm 中进行 **本地断点调试** 是一个非常常见的操作，尤其对于 PHP 开发者来说。下面是使用 PhpStorm 进行本地断点调试的详细步骤：

---

## ✅ 一、准备工作

### 1. 安装 Xdebug
Xdebug 是 PHP 的一个调试扩展，必须安装并配置好。

#### 安装 Xdebug：
```bash
sudo pecl install xdebug
```

#### 配置 `php.ini`（根据你的 PHP 版本）：
```ini
[xdebug]
zend_extension=/path/to/xdebug.so
xdebug.mode=debug
xdebug.remote_enable=1
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9000
xdebug.idekey=PHPSTORM
```

> 注意：路径 `/path/to/xdebug.so` 可以通过以下命令查看：
> ```bash
> php -i | grep 'xdebug.so'
> ```

### 2. 启动 PHP 服务器
你可以使用内置的 PHP 服务器，或者使用 Apache/Nginx + PHP-FPM。

例如启动 PHP 内置服务器：
```bash
php -S localhost:8000 -t /path/to/your/project
```

---

## ✅ 二、配置 PhpStorm

### 1. 打开 PhpStorm 并加载项目

### 2. 配置 PHP 解释器

- 点击菜单栏：`File > Settings (or Ctrl+Alt+S)`
- 选择 `Languages & Frameworks > PHP`
- 点击 `...` 选择你的 PHP 解释器（比如 `/usr/bin/php` 或者你用的 PHP 版本）

### 3. 配置 Xdebug

- 在 `Settings` 中，选择 `Languages & Frameworks > PHP > Debug`
- 设置：
  - `Xdebug` 作为调试器
  - `Port` 为 `9000`
  - `IDE key` 设置为 `PHPSTORM`

---

## ✅ 三、设置断点

1. 在代码中点击行号左侧空白处，添加断点。
2. 你可以设置条件断点、临时断点等。

---

## ✅ 四、启动调试会话

### 方法一：使用内置服务器

1. 启动 PHP 内置服务器（如上面所述）。
2. 在浏览器中访问你的应用（如 http://localhost:8000/index.php）。
3. PhpStorm 会自动检测到调试请求并进入调试模式。

### 方法二：使用 Run/Debug 配置

1. 点击右上角的 `Run` 菜单 → `Edit Configurations...`
2. 添加新的 `PHP Web Application` 配置：
   - 选择 `Server`（如果之前配置过）
   - 设置 `URL` 为你要访问的页面
   - 设置 `Script path` 为入口文件（如 `index.php`）
3. 点击 `OK` 保存配置。
4. 点击运行按钮（绿色三角）或调试按钮（绿色虫子）开始调试。

---

## ✅ 五、调试操作

- **Step Over（F8）**：执行当前行，不进入函数内部。
- **Step Into（F7）**：进入当前行的函数内部。
- **Step Out（Shift + F8）**：退出当前函数。
- **Resume Program（F9）**：继续执行程序。
- **Stop（Ctrl + F2）**：停止调试。

---

## ✅ 六、常见问题排查

### 1. PhpStorm 不提示调试连接？

- 检查 `xdebug.remote_host` 是否是 `127.0.0.1`
- 检查 `xdebug.remote_port` 是否为 `9000`
- 检查防火墙是否阻止了端口 9000
- 确保 `xdebug.mode=debug` 或 `xdebug.mode=develop`

### 2. 无法在 PhpStorm 中看到变量值？

- 确保你正在使用 `Xdebug` 作为调试器
- 检查 `php.ini` 中是否有错误配置
- 重启 PHP 服务和 PhpStorm

---

## ✅ 七、调试小技巧

- 使用 `var_dump()` 或 `dd()` 时，可以配合 PhpStorm 的“Watch”功能观察变量。
- 使用 `Breakpoint` 条件判断，只在特定条件下触发。
- 使用 `Evaluate Expression` 动态执行代码。

---

如果你告诉我你使用的 PHP 环境（如 PHP 8.1 + Apache + Xdebug 3），我可以提供更具体的配置示例。

需要我帮你生成一个完整的 `php.ini` 配置吗？