将 php -i 输出的结果复制粘贴到 Xdebug Wizard中，自动分析出适配的版本

下面是详细的安装步骤：

第一步：放置 Xdebug 文件

  1. 找到 PHP 扩展目录 (ext)
    这个目录是你存放所有 PHP 扩展（.dll 文件）的地方。最准确的查找方法是再次查看 phpinfo() 页面：

    • 在 phpinfo() 页面中，按 Ctrl + F 搜索 extension_dir。
    • 它会告诉你一个路径，例如 C:\php\ext 或者 D:\xampp\php\ext。这就是你的目标文件夹。

  2. 复制并重命名文件

    • 将你刚刚下载的 Xdebug 的 .dll 文件（文件名可能很长，像 php_xdebug-3.1.6-7.4-vc15-ts-x64.dll）复制到上面找到的 ext 文件夹里。
    • 强烈建议： 将这个长文件名重命名为一个更简洁的名字，例如：php_xdebug.dll。这样配置起来更方便，以后升级也只需要替换这个文件。

第二步：修改 php.ini 配置文件

  1. 找到并打开 php.ini 文件
    同样，phpinfo() 页面会告诉你当前加载的是哪个 php.ini 文件。

    • 在 phpinfo() 页面顶部找到 Loaded Configuration File 这一行。
    • 这里显示的路径就是你需要编辑的 php.ini 文件。用记事本或任何代码编辑器（如 VS Code）打开它。

  2. 添加 Xdebug 配置
    在 php.ini 文件的 最末尾，添加以下配置代码。这是 Xdebug 3 的标准配置，适用于大多数开发环境。

    [xdebug]
; 下面这行的路径一定要是上一步你放置的dll文件的绝对路径
zend_extension="C:\php\ext\php_xdebug.dll"

; Xdebug 3 的核心配置
xdebug.mode=debug
xdebug.start_with_request=trigger
xdebug.client_port=9003
xdebug.client_host="127.0.0.1"
xdebug.log="C:\xampp\tmp\xdebug.log" ; (可选) 记录日志，方便排查问题，请确保路径存在且可写

    配置解释:

    • zend_extension: 这是最重要的一行！ 它的值必须是你刚刚放置的 php_xdebug.dll 文件的 绝对路径。请务必根据你的实际情况修改 C:\php\ext\php_xdebug.dll 这个路径。
    • xdebug.mode=debug: 开启调试模式。
    • xdebug.start_with_request=trigger: 这是一个非常好的设置。它意味着 Xdebug 不会尝试连接每个请求，只有在你通过浏览器插件等方式发出“触发”信号时，它才会启动调试，这样不会影响网站的正常浏览速度。
    • xdebug.client_port=9003: 这是 Xdebug 3 默认监听的端口。注意，它和旧版 Xdebug 2 的 9000 不同。请确保你的 IDE (如 VS Code, PhpStorm) 也是监听 9003 端口。
    • xdebug.client_host="127.0.0.1": 你的 IDE (代码编辑器) 所在的 IP 地址，通常就是本机。
    • xdebug.log: 这一行是可选的，但在初次配置时强烈推荐加上。如果 Xdebug 连接不上，你可以查看这个日志文件来找到问题原因。

第三步：重启并验证

  1. 重启你的 Web 服务器

    • 如果你用的是 XAMPP, WampServer 等集成环境，请通过它们的控制面板重启 Apache 服务。
    • 如果你是自己搭建的环境，请重启对应的 Apache 或 Nginx 服务。
    • 这一步是必须的！ 否则 php.ini 的修改不会生效。

  2. 验证安装

    • 再次刷新你的 phpinfo() 页面。
    • 如果你能看到一个大大的 Xdebug 的 logo 和相关的配置信息，那就说明 Xdebug 已经成功加载了！
    • 你可以滚动页面查看，或者直接按 Ctrl + F 搜索 xdebug。

Vscode的launch.json配置如下

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
    
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003
        }
    ]
}
转载请注明出处