PHP8.0 + Xdebug3.0.3 快速安装与配置指南

一、核心前提

• 运行环境：phpstudy_pro / Windows
• 适配版本：PHP 8.0.2 NTS（需与 Xdebug 版本匹配）
• 最终目标：IDE 断点调试、代码单步排错

二、Xdebug3.0.3 安装步骤（phpstudy_pro 环境）

1. 打开 phpstudy_pro → 切换至「软件管理」→ 找到「PHP 8.0.2 NTS」→ 点击「设置」→「扩展组件」；
2. 在扩展列表中找到「Xdebug 3.0.3」→ 勾选启用（自动完成 dll 文件部署和基础配置）；
3. 重启 PHP 服务（必须重启，否则扩展不生效）。

三、验证安装是否成功

创建 phpinfo.php 文件，放入网站根目录，内容如下：

<?php phpinfo(); ?>

访问该文件，搜索「Xdebug」：

• 若出现 Xdebug 相关配置信息，说明安装成功；
• 重点确认 xdebug.mode 包含 debug，xdebug.client_port 为 9003。

四、最优配置（直接覆盖 php.ini）

打开 PHP 配置文件（phpstudy_pro → PHP 8.0.2 NTS → 「配置文件」→「php.ini」），粘贴以下配置：

; Xdebug3.0.3 调试最优配置
[xdebug]
xdebug.mode = debug,develop       ; 调试+开发辅助模式
xdebug.client_host = 127.0.0.1    ; 本地 IP，避免解析问题
xdebug.client_port = 9003         ; 默认调试端口，不可随意修改
xdebug.start_with_request = yes   ; 请求自动触发调试
xdebug.idekey = PHPSTORM          ; 适配主流 IDE，多项目隔离
xdebug.log = "C:\Windows\Temp\xdebug.log"  ; 日志路径，用于排错
xdebug.log_level = 7              ; 完整日志级别
xdebug.max_nesting_level = 512    ; 适配复杂代码嵌套

保存后，重启 PHP 服务 使配置生效。

五、IDE 关键配置（以 PhpStorm/VSCode 为例）

1. PhpStorm

• 打开「File」→「Settings」→「PHP」→「Debug」；
• 确认「Xdebug」的「Debug port」为 9003（与 php.ini 一致）；
• 点击「Validate」验证连接，提示成功即可。

2. VSCode

• 安装插件「PHP Debug」；
• 打开「运行和调试」→「创建 launch.json 文件」，选择「PHP」；

• 替换配置为：

  {
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Xdebug 调试",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "${workspaceFolder}": "你的项目根目录绝对路径"
            }
        }
    ]
  }

六、必做注意事项

1. 防火墙放行 9003 端口（本地调试需开放）；
2. 多项目调试时，确保所有项目的 idekey 与 IDE 配置一致；
3. 若调试失败，查看日志文件 C:\Windows\Temp\xdebug.log 排查问题；
4. 禁止同时开启 Xdebug 性能分析、代码追踪等非必要功能，避免影响项目运行速度。