PHP Windows调试核心是正确配置php.exe调用及Xdebug扩展:需匹配TS/NTS版本,正确放置DLL并配置php.ini启用xdebug.mode=debug、client_host/port等,注意CLI与Web使用不同php.ini,防火墙可能拦截9003端口。
PHP 在 Windows 下调试,核心是让
能被 IDE 或命令行正确调用,并加载调试扩展(如
或
)。不配对扩展或路径写错,
就看不到
,IDE 断点直接失效。
确认 PHP 是线程安全版(TS)还是非线程安全版(NTS)
Windows 下 PHP 二进制包分 TS/NTS 两种,Xdebug 扩展必须严格匹配。用命令行执行:
输出
表示是 TS 版,
表示是 NTS 版。下载 Xdebug 时务必选对应版本,否则
加载会静默失败 ——
不显示
,
显示配置已加载,但就是不工作。
从
xdebug.org/download
下载对应 PHP 版本、TS/NTS 类型、架构(x64/x86)的
把 DLL 放进
目录(不是
子目录下再套一层)
在
末尾加(注意路径用正斜杠或双反斜杠):
配置 xdebug 启用远程调试(
vscode
/
php
storm 均适用)
Xdebug 3 默认关闭远程调试,仅启用 profiling 或 tracing 不等于能断点。必须显式开启并指定通信方式。在
中添加:
立即学习
“
PHP免费学习笔记(深入)
”;
关键点:
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
是必须项,Xdebug 3 不再支持
表示每次请求都尝试连接 IDE,适合 CLI 和 Web 场景;若只想手动触发,改用
+ 浏览器插件
端口默认是
(不是旧版的
),VS Code 的
和 PHPStorm 的 Debug 配置必须同步改
路径要确保目录存在且有写权限,出问题时第一手线索就在这里
CLI 脚本调试时常见失败原因
在命令行运行
却无法停在断点,大概率是 CLI 使用了和 Web 不同的
。执行以下命令确认:
你会发现 CLI 的配置文件路径常是
,而 Apache 或 Nginx 可能读的是
。Xdebug 配置必须出现在 CLI 实际加载的那个
里。
用
确认 CLI 加载的是哪个文件,别只改了 Apache 对应的 ini
检查
是否指向正确的
目录(路径末尾不能有多余斜杠)
如果用 Composer 安装的依赖含
或
,它们可能自带内置服务器,此时需额外传参启用调试,例如:
浏览器中触发 Xdebug 的几种方式
Web 请求不触发断点?不是代码问题,而是没发带调试参数的请求。有三类可靠方式:
URL 加参数:
(前提是
)
浏览器安装 Xdebug Helper 插件(Chrome/Firefox),点击图标启用后自动加
cookie
用 curl 手动发带 header 的请求:
(注意 cookie 值要和 IDE 设置的 key 一致)
最易忽略的一点:Windows 防火墙默认阻止入站连接,
虽然走本地回环,但某些企业版防火墙策略仍会拦截 9003 端口 —— 临时关闭防火墙或添加入站规则,比反复检查配置更有效。
php.exexdebugzend_extensionphp -vxdebugphp -i | findstr "Thread Safety"enableddisabledphp.iniphp -mxdebugphp --iniphp_xdebug-*.dllphp/ext/extphp.inizend_extension="C:/php/ext/php_xdebug-3.3.1-8.2-ts-vs16-x86_64.dll"php.ini[XDebug]
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.log="C:/tmp/xdebug.log"xdebug.mode=debugxdebug.remote_enable=1xdebug.start_with_request=yestrigger_value90039000launch.jsonxdebug.logphp script.phpphp.iniphp --ini
php -r "echo ini_get('extension_dir');"C:\php\php.iniC:\php\php-apache.iniphp.iniphp --iniextension_dirext/phpunitsymfony/consolephp -dxdebug.mode=debug -dxdebug.start_with_request=yes vendor/bin/phpunithttp://localhost/test.php?XDEBUG_SESSION_START=1xdebug.start_with_request=triggerXDEBUG_SESSION_STARTcurl -H "Cookie: XDEBUG_SESSION=PHPSTORM" http://localhost/test.phpxdebug.client_host=127.0.0.1