返回博客

4 步在 VSCode 中设置 DDEV 和 Xdebug

2023-08-142 分钟阅读

如何在 VSCode 中设置 DDEV 和 Xdebug:只需四个简单的步骤,即可在这款流行的编辑器中提升您的编码和调试体验,本文将详细介绍。

Xdebug 是 PHP 的调试和性能分析工具。它提供堆栈跟踪、变量检查和断点,以及代码覆盖率和性能分析,以优化 PHP 应用程序。

调试是识别、诊断和纠正软件错误或 bug 的过程。这些错误可能表现为不正确的代码、逻辑错误或阻止软件按预期运行的不良行为。

1. 安装先决条件:

确保您已安装以下工具:

2. 配置 DDEV 以使用 Xdebug:

DDEV 开箱即用地预配置了 Xdebug。您只需启用它:

  1. 导航到您的 DDEV 项目目录。
  2. 运行命令:
ddev xdebug on

要验证 Xdebug 是否已启用:

ddev describe

查找 Xdebug 部分;它应该表明 Xdebug 已启用。

3. 配置 VSCode:

  1. 在 VSCode 中,单击顶部的工具栏上的“运行”。
  2. 单击“打开配置”(或类似措辞,具体取决于您的 VSCode 版本)。
  3. 添加以下配置:
{
    "name": "Listen for Xdebug",
    "type": "php",
    "request": "launch",
    "hostname": "0.0.0.0",
    "port": 9003,
    "pathMappings": {
        "/var/www/html": "${workspaceFolder}"
    }
}

确保此配置保存在项目 .vscode 文件夹中的 launch.json 文件中。

xdebug configuration in vscode
VSCode 配置

4. 开始调试:

  1. 在您的 PHP 代码中设置断点。
  2. 在 VSCode 中,单击顶部的工具栏上的“运行”,然后单击“开始调试”。
  3. 在您的 Web 应用程序中触发断点的操作。
Start debugging vscode and xdebug

VSCode 现在应该会捕获断点,允许您检查变量、单步执行代码等。

Debugging with vs code and xdebug
来源:https://marketplace.visualstudio.com/items?itemName=xdebug.php-debug

5. 在 DDEV 中禁用 Xdebug(可选):

调试完成后,您可能希望在 DDEV 中禁用 Xdebug 以提高性能:

ddev xdebug off

祝您调试愉快!