如何在PHP中调试请求重定向？含跨项目SSO重定向调试场景

我之前在做跨项目SSO调试的时候也碰到过一模一样的问题——重定向后调试直接终止，根本没法跟踪整个授权流程。其实核心原因是PhpStorm默认只监听当前请求的进程，而重定向是发起了一个全新的HTTP请求，属于另一个独立进程，所以需要调整配置让调试器能捕获后续的所有请求。下面是我亲测有效的步骤：

1. 正确配置两个项目的服务器路径映射 #

PhpStorm需要明确知道每个项目的本地文件和服务器URL的对应关系，否则断点会直接失效：

• 打开File > Settings > Languages & Frameworks > PHP > Servers
• 分别给PLM和SSO系统添加服务器配置：
  • 对于PLM项目：命名为PLM_Server，Host填localhost，Port用默认的80（如果你的服务用了其他端口就填对应值），然后在Path mappings里把本地PLM项目的根目录映射到/PLM
  • 对于SSO项目：同理添加SSO_Server，把本地SSO项目根目录映射到/SSO
• 一定要勾选Use path mappings，这是跨项目调试的关键前提

2. 开启PhpStorm的调试监听 #

在PhpStorm右上角的调试工具栏，找到那个类似电话听筒的图标（Start Listening for PHP Debug Connections），点击它让图标亮起。这样调试器会主动捕获所有符合条件的PHP请求，不管是来自PLM还是SSO项目。

3. 调整Xdebug配置捕获所有请求 #

打开你的php.ini文件，确保Xdebug的配置能让每个PHP请求都触发调试：

xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.client_host = 127.0.0.1  # 有时候用127.0.0.1比localhost更稳定
xdebug.client_port = 9003  # 和PhpStorm的调试端口保持一致，默认是9003
xdebug.idekey = PHPSTORM

这里xdebug.start_with_request = yes是核心，它会强制每个PHP请求都自动连接到调试器，哪怕不是从PhpStorm主动发起的请求（比如重定向后的SSO请求）。

4. 优化重定向URL并设置断点 #

把你的重定向代码改成完整的HTTP URL，避免路径解析问题：

header("Location: http://localhost/SSO/index.php?reURL=http://localhost/PLM/index.php");
exit;  // 别忘了加exit，确保后续代码不会执行

然后分别在：

• PLM项目的重定向代码前一行设置断点，确认触发重定向的逻辑
• SSO项目的index.php开头设置断点，这样重定向过来后就能直接进入调试

5. 把两个项目导入同一个PhpStorm窗口（可选但推荐） #

如果之前是分开打开两个项目，现在可以把SSO项目附加到PLM的窗口：

• 打开File > Open，选择SSO项目的根目录，然后选择Attach选项
  这样PhpStorm能同时识别两个项目的文件，断点会更准确，调试时切换也更方便。

常见坑点排查 #

• 检查PhpStorm的调试端口：Settings > Languages & Frameworks > PHP > Debug里的Debug port要和Xdebug的client_port完全一致
• 浏览器安装Xdebug Helper插件：可以手动强制请求带上调试标识，避免偶尔出现的连接失败
• 确保两个项目的PHP版本和Xdebug版本兼容：不同PHP版本对应的Xdebug版本不一样，版本不匹配会导致调试失效

按照这些步骤配置后，你再测试整个流程：访问PLM页面触发重定向，PhpStorm会自动跳转到SSO项目的断点，调试完SSO的令牌逻辑后，当SSO重定向回PLM时，又会触发PLM项目的断点，整个流程就能完整跟踪了。

内容的提问来源于stack exchange，提问作者Martin Bre