Laragon配置PHP与Xdebug后非调试状态服务器无法启动问题

问题根源 #

你当前的php.ini配置存在核心问题：

xdebug.mode=debug
xdebug.start_with_request=yes

这两个参数组合会让Xdebug在每一次请求启动时强制尝试建立调试客户端连接。当没有IDE或调试工具监听9003端口时，Xdebug会一直阻塞等待连接超时，直接导致服务器卡住、应用无法运行。

解决方案 #

1. 修改全局php.ini配置（日常运行默认关闭强制调试）

将配置调整为：

[xdebug]
zend_extension=php_xdebug.dll
xdebug.mode=develop  # 日常运行仅启用开发辅助功能（错误提示、栈跟踪等），不强制触发调试
xdebug.start_with_request=trigger  # 仅通过触发条件启动调试（比如请求参数、浏览器插件）

• xdebug.mode=develop：保留Xdebug的开发辅助能力，同时避免强制调试连接
• xdebug.start_with_request=trigger：只有当检测到调试触发信号时，才启动调试流程

2. 调试时的两种启动方式

• 手动触发调试：需要调试时，在请求URL后追加?XDEBUG_TRIGGER=1，或者使用浏览器Xdebug扩展（如Xdebug Helper）一键触发，Xdebug会自动尝试连接监听中的IDE
• IDE调试配置自动覆盖：你现有的launch.json配置已经做了正确的临时覆盖：
  • "Launch currently open script"通过env.XDEBUG_MODE=debug,develop临时开启调试模式
  • "Launch Built-in web server"通过runtimeArgs=-dxdebug.mode=debug强制开启调试
    启动这些IDE调试配置时，会自动覆盖php.ini的全局设置，正常触发调试流程，无需修改全局配置。

验证效果 #

修改php.ini后重启服务器，日常运行时不会再出现卡住加载的情况；需要调试时，触发Xdebug或启动IDE调试配置即可正常进入调试模式。

内容的提问来源于stack exchange，提问作者B. Fateh