vscode 配置 Xdebug 调试

安装 Xdebug 扩展

首先到 Xdebug 的官网下载页面 https://xdebug.org/download 下载对应 php 版本的 Xdebug 扩展。将其放入 php 目录下的 ext 文件夹中。例如：原本的 php 是放在 D:\php\php74 中, Xdebug 扩展文件就放在 D:\php\php74\ext 目录下。

然后在配置文件 php.ini 末尾添加如下几项配置：

zend_extension = php_xdebug-3.0.4-7.4-vc15-x86_64.dll
xdebug.mode = coverage,debug,develop
xdebug.client_host=127.0.0.1
xdebug.client_port = 9003
xdebug.start_with_request = yes
xdebug.log="D:\\php\\php74\\xdebug_log\\xdebug.log"

配置简要说明

配置项	备注
zend_extension	扩展文件存放的路径
xdebug.mode	开启 Xdebug 的模式，可以同时设置多个值
xdebug.log	日志文件输出位置

具体的配置详情见官网说明 https://xdebug.org/docs/install#mode

vscode 配置

安装 vscode 扩展

按 F1 然后输入 ext install php-debug 进行安装。或者在扩展商店里搜索 php-debug 进行安装。

设置调试相关配置

在项目的根目录下创建 vscode 的调试配置文件 .vscode/launch.json。

{
    // 使用 IntelliSense 了解相关属性。
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003
        },
        {
            "name": "Launch Built-in web server",
            "type": "php",
            "request": "launch",
            "runtimeArgs": [
                "-dxdebug.mode=debug,develop",
                "-dxdebug.start_with_request=yes",
                "-S",
                "localhost:8080"
            ],
            "program": "${workspaceFolder}\\public\\index.php",
            "cwd": "${workspaceRoot}",
            "port": 9003,
            "serverReadyAction": {
                "pattern": "Development Server \\(http://localhost:([0-9]+)\\) started",
                "uriFormat": "http://localhost:%s",
                "action": "openExternally"
            }
        }
    ]
}

配置说明

上面是配置了两个的 debug 模式。name 字段是配置名称。名称为 Listen for Xdebug 是默认使用 php.ini 里设置的模式进行调试。Launch Built-in web server 这个配置中可以看到在 runtimeArgs 字段里传入了 debug 的模式等配置。并且通过 -S 命令在本地的 8080 端口开启 php 内置服务器。program 字段是指定程序的入口文件。serverReadyAction 字段是指定开启服务后的动作。示例配置是直接在浏览器打开。更多详细说明参考官方的说明 https://github.com/xdebug/vscode-php-debug#supported-launchjson-settings