XDEBUG_SESSION_START参数可临时触发Xdebug调试，需在URL后添加如?XDEBUG_SESSION_START=1，且xdebug.mode=debug已启用、xdebug.start_with_request≠no；该方式仅对当前请求生效，适合手动测试单个URL。
用 XDEBUG_SESSION_START 参数临时触发调试
Xdebug 默认不会为每个请求启动调试会话，必须显式激活。最简单、最常用的方式是在 URL 后追加 XDEBUG_SESSION_START=PHPSTORM（或任意非空字符串），比如：https://example.com/test.php?XDEBUG_SESSION_START=1。Xdebug 会检测该 GET/POST 参数，并自动建立与 IDE 的 DBGp 连接。
注意：这要求 xdebug.mode 已设为 debug（PHP 8.0+）或 xdebug.remote_enable=1（旧版），且 xdebug.start_with_request 不能设为 no（否则参数会被忽略）。
- 仅对当前请求生效，不影响其他请求，适合手动测试单个 URL
- 如果使用 Nginx/Apache 反向代理，确保
XDEBUG_SESSION_START没被代理层过滤或重写（常见于某些安全规则或 CDN） - 浏览器插件（如 Xdebug Helper）本质也是自动注入这个参数，但依赖 Cookie 或请求头，不如直接加参数可靠
通过 Cookie 持续启用调试（适合多页跳转）
当请求涉及重定向、AJAX 或前端路由（如 Vue Router、React Router），URL 参数容易丢失，此时改用 Cookie 更稳定。发送一个名为 XDEBUG_SESSION 的 Cookie，值任意（如 PHPSTORM），Xdebug 会识别并开启调试。
可手动在浏览器开发者工具的 Application → Cookies 中添加，也可用 curl 测试：
curl -H "Cookie: XDEBUG_SESSION=PHPSTORM" https://example.com/api/data.php
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
- Cookie 域名需匹配目标域名（
example.com不会触发www.example.com的调试，除非设置Domain=.example.com） - 若 PHP 运行在 CLI 或命令行环境（如 Artisan 命令），无法用 Cookie，必须改用
export XDEBUG_CONFIG="idekey=PHPSTORM"+xdebug.mode=debug - 某些 SaaS 环境（如 Laravel Vapor、Vercel）不支持运行时调试，此方法无效
按 Host 或 Path 条件启用（Nginx/Apache 配置级控制）
不想每次手动加参数或 Cookie？可以在 Web 服务器层根据域名或路径自动注入调试开关。例如 Nginx 中针对开发子域强制启用：
location ~ \.php$ {
if ($host ~* "^dev\.example\.com$") {
set $args "$args&XDEBUG_SESSION_START=1";
}
fastcgi_pass php-fpm;
}Apache 则可用 RewriteCond + RewriteRule 实现类似逻辑。这种方式把调试开关和环境绑定，避免误开到生产流量。
- 务必限制条件足够精确（如只匹配
dev.example.com，而非example.com），否则线上请求可能意外触发调试，拖慢响应甚至暴露调试端口 - 修改后需 reload Web 服务器配置，且要确认 PHP 是以 FPM/FastCGI 模式运行（mod_php 不适用此法）
- 该方法无法控制 CLI 脚本，也不能覆盖已存在的
XDEBUG_SESSION_START参数（Nginx 的$args拼接可能重复）
为什么 Xdebug 不断连或根本没触发？检查这几个点
最常见的不是配置错，而是连接链路中断。Xdebug 需要三端协同：PHP 进程 → Xdebug 扩展 → IDE 监听端口（默认 9003）。任一环节失败都会静默失效。
-
xdebug.client_host必须指向 IDE 所在机器的 IP（Docker 环境常错填为127.0.0.1，实际应填宿主机 IP 或host.docker.internal） -
xdebug.log日志文件路径需 PHP 进程有写权限，日志里出现Connecting to configured address/port但无后续，大概率是网络不通 - IDE 的「Accept external connections」必须勾选，且防火墙放行 9003 端口（macOS 系统防火墙有时会拦截 PhpStorm）
- PHP 8.0+ 的
xdebug.mode=debug是硬性前提，旧版配置（如xdebug.remote_enable）在新版中完全无效
复杂点在于：同一台机器跑多个 PHP 项目时，不同项目的 xdebug.client_host 可能指向不同 IDE 实例，而 Xdebug 日志不会明确告诉你连到了谁——它只记录“尝试连接”，连不上就放弃，不留痕迹。
