VsCode 配置PHP Debug 调试代码

封面图 • 2025-11-25 • PHP

在 Visual Studio Code (VSCode) 中配置 PHP 调试（Debug）通常需要以下几项工具：

1. **PHP 环境**（如 XAMPP、WAMP、Laravel Valet 或手动安装）
2. **Xdebug**（PHP 的调试扩展）
3. **VSCode 的 PHP Debug 插件**
4. **Launch.json 配置文件**

下面我将一步步指导你如何在 VSCode 中配置 PHP 调试。

---

## ✅ 第一步：安装 PHP 和 Xdebug

确保你的系统中已经安装了 PHP，并且启用了 Xdebug 扩展。

### 1. 安装 PHP（以 Linux 为例）

```bash
sudo apt update
sudo apt install php php-cli php-mbstring php-xml
```

### 2. 安装 Xdebug

```bash
sudo apt install php-xdebug
```

或者使用 `pecl` 安装：

```bash
sudo pecl install xdebug
```

然后在 `php.ini` 文件中添加：

```ini
zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9000
xdebug.remote_mode = req
xdebug.remote_handler = dbgp
```

> 注意：根据你的 PHP 版本，路径可能不同。可以使用 `php --ini` 查看 `php.ini` 的位置。

### 3. 检查 Xdebug 是否启用

运行以下命令查看是否加载了 Xdebug：

```bash
php -m | grep xdebug
```

---

## ✅ 第二步：安装 VSCode 的 PHP Debug 插件

1. 打开 VSCode。
2. 在左侧活动栏点击扩展图标（或按 `Ctrl+Shift+X`）。
3. 搜索 `PHP Debug`，找到由 **Xdebug** 提供的插件（通常为 `PHP Debug` by Xdebug）。
4. 安装它。

---

## ✅ 第三步：创建 `launch.json` 配置文件

1. 在 VSCode 中打开你的 PHP 项目文件夹。
2. 点击左侧边栏的“运行和调试”图标（或按 `Ctrl+Shift+D`）。
3. 点击“创建 launch.json 文件”。
4. 选择 `PHP` 作为环境。

这会自动生成一个 `launch.json` 文件，内容如下：

```json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9000,
            "pathMappings": {
                "/var/www/html": "${workspaceFolder}"
            }
        }
    ]
}
```

> 如果你使用的是其他路径（例如 Laravel 项目），请修改 `pathMappings` 为你自己的路径。

---

## ✅ 第四步：启动调试器

1. 在代码中设置断点（点击行号左侧）。
2. 点击“运行和调试”中的“开始调试”按钮（绿色三角形）。
3. 在浏览器中访问你的 PHP 页面（例如 `http://localhost/yourfile.php`）。
4. 程序会在断点处暂停，你可以查看变量、调用栈等信息。

---

## ✅ 常见问题解决

### ❌ 无法连接到 Xdebug

- 检查 `php.ini` 中的 `xdebug.remote_host` 是否是 `127.0.0.1`。
- 检查防火墙是否允许 9000 端口。
- 确保 `xdebug.remote_enable=1`。

### ❌ 无法设置断点

- 确保 `xdebug.remote_mode = req` 或 `start_with_request = 1`。
- 使用 `xdebug.start_with_request = 1` 可以让调试器自动启动。

---

## 🛠 示例：Laravel 项目配置

如果你使用 Laravel，建议将 `pathMappings` 设置为：

```json
"pathMappings": {
    "/home/user/Projects/myapp": "${workspaceFolder}"
}
```

---

## ✅ 总结

| 步骤 | 内容 |
|------|------|
| 1 | 安装 PHP + Xdebug |
| 2 | 安装 VSCode 的 PHP Debug 插件 |
| 3 | 创建 `launch.json` 配置文件 |
| 4 | 启动调试并测试 |

---

如果你告诉我你使用的 PHP 环境（如 XAMPP、Laravel、本地服务器等），我可以提供更具体的配置示例。欢迎继续提问！