如何为Laradock 3部署的Laravel 10项目配置Xdebug调试器

一、关联PHP解释器与Xdebug #

• 打开IntelliJ IDEA，进入 File > Settings > Languages & Frameworks > PHP
• 在「CLI Interpreter」下拉框点击「...」，再点「+」添加新解释器
• 选择对应环境的PHP解释器（Docker环境选Docker/Docker Compose，关联项目容器）
• 切换到「Debug」标签，确认Xdebug被正常检测：
  • 核对Xdebug版本与PHP版本兼容
  • 确认「Debug port」和容器内Xdebug配置一致（Xdebug 3.x默认9003，2.x默认9000）

二、配置调试服务器 #

• 进入 File > Settings > Languages & Frameworks > PHP > Servers
• 点击「+」新建服务器：
  • Name：自定义名称（如「Laravel Local」）
  • Host：项目访问域名（如localhost或自定义域名）
  • Port：服务对应端口（如80/443）
  • Debugger：选择「Xdebug」
  • 勾选「Use path mappings」，将本地项目根目录映射到容器内项目路径（如本地/xxx/laravel-project对应容器/var/www/html）

三、开启IDE调试监听 #

• 点击IDE右上角的「电话」图标（或通过Run > Start Listening for PHP Debug Connections），图标变绿色即表示监听已开启

四、API请求触发调试 #

API为无浏览器请求，需手动添加调试标识：

• 方式一：URL后追加参数

  ?XDEBUG_SESSION_START=idea
  

• 方式二：请求头添加字段

  XDEBUG_SESSION: idea
  

五、断点调试 #

• 在Laravel控制器、模型或路由文件的行号左侧点击，添加红色断点
• 发送带调试标识的API请求，IDE自动捕获会话并进入断点
• 用调试工具栏按钮（步过、步入、步出、继续）查看变量、调用栈等信息

内容的提问来源于stack exchange，提问作者vivek.p.n manu