wampserver 3.2.9默认集成xdebug 3.2,无需手动下载dll;只需确认php版本匹配、在对应php.ini中启用zend_extension及xdebug.mode=debug等新参数、禁用已废弃的remote_*配置、设端口为9003,重启服务后通过phpinfo()和触发url验证即可。

WampServer 3.2.9 默认已集成 Xdebug 3.2(对应 PHP 7.4/8.0/8.1 等版本),无需手动下载 DLL 文件。开启它只需两步:确认启用、检查配置、重启服务,不需额外安装。
确认当前 PHP 版本与 Xdebug 是否已加载
左键点击系统托盘 WampServer 图标 → PHP → Version,记下你正在使用的版本(如 7.4.33 或 8.1.25)。
再点击 PHP → phpinfo(),在浏览器打开的页面中搜索 xdebug:
- 若看到 Xdebug 模块信息(含版本号如
xdebug v3.2.2),说明已加载; - 若没出现,说明未启用或版本不匹配,需继续配置。
修改 php.ini 启用 Xdebug 3.2
左键托盘图标 → PHP → php.ini(注意:不是 Apache 的 php.ini,而是 PHP 目录下的主配置文件,路径类似 wamp64\bin\php\php7.4.33\php.ini)
找到 [XDebug] 区块(通常在文件末尾),确保以下配置存在且未被注释(即前面无分号 ;):
-
zend_extension = "D:/wamp64/bin/php/php7.4.33/zend_ext/php_xdebug-3.2.2-7.4-vs16-x86_64.dll"
✅ 路径必须与你当前 PHP 版本完全一致(版本号、VC 编译器、架构 x86/x64 都要对) -
xdebug.mode = debug -
xdebug.start_with_request = trigger或xdebug.start_with_request = yes(推荐trigger,更安全) -
xdebug.client_host = 127.0.0.1 -
xdebug.client_port = 9003(⚠️ Xdebug 3+ 默认端口是9003,不是旧版的9000) -
xdebug.log = "D:/wamp64/logs/xdebug.log"(可选,用于排查连接失败)
删除或注释掉所有旧式配置(如 xdebug.remote_enable、xdebug.remote_host 等 —— 这些在 Xdebug 3 中已废弃,保留会导致启动失败)。
重启并验证
保存 php.ini → 托盘图标 → Restart All Services
再次打开 phpinfo() 页面,搜索 xdebug.mode,应显示 debug;搜索 Loaded Configuration File 确认读取的是你刚编辑的 php.ini。
快速测试是否生效
在 www 目录下新建 test_xdebug.php,内容为:
<?php echo "Xdebug is working!"; ?>
用浏览器访问 http://localhost/test_xdebug.php?XDEBUG_SESSION_START=1(加 ?XDEBUG_SESSION_START=1 触发调试)
若 VSCode 或 PHPStorm 已配置监听,此时断点应能命中;若未配置 IDE,该 URL 不会报错,但日志中会有连接尝试记录(查看 xdebug.log 可确认)。
基本上就这些。只要版本匹配、端口正确、废弃参数清干净,Xdebug 3.2 在 WampServer 3.2.9 中就能稳定启用。











