如何用Laragon调试Laravel？Xdebug配置-php教程-PHP中文网

laragon调试laravel的核心是xdebug与laragon内置php、web服务及ide（如phpstorm/vs code）协同：先匹配php版本下载对应xdebug dll并放入ext目录，重启laragon后在php.ini中配置xdebug.mode=debug等参数（禁用remote_*旧参数），phpstorm需开启监听、正确设置servers路径映射（本地与服务器路径严格一致），vs code则通过launch.json配置pathmappings，最后借助xdebug helper插件触发调试。

如何用laragon调试laravel？xdebug配置

用 Laragon 调试 Laravel，核心是让 Xdebug 与 Laragon 内置的 PHP、Web 服务及你的 IDE（如 PHPStorm 或 VS Code）协同工作。Laragon 自带 PHP 和 Nginx/Apache，配置相对集中，但容易卡在路径映射或端口不一致上。

确认 Laragon 的 PHP 版本并匹配 Xdebug

Laragon 每个 PHP 版本都独立管理扩展，必须严格对应：

打开 Laragon，点击菜单 PHP → Version 查看当前版本（如 PHP 8.2.12 x64 NTS）
访问 xdebug.org/wizard，粘贴 php --version 和 php --ini 输出内容，获取定制安装指令
下载推荐的 php_xdebug-*.dll（Windows），放入对应 PHP 的 ext/ 目录（例如：D:\laragon\bin\php\php-8.2.12-Win32-vs16-x64\ext\）
重启 Laragon（右键托盘图标 → Restart All），再运行 php -m | findstr xdebug（Windows）验证是否加载

修改 php.ini 启用调试模式

在 Laragon 中，php.ini 位于当前 PHP 版本目录下（如 D:\laragon\bin\php\php-8.2.12-Win32-vs16-x64\php.ini），末尾添加：

[XDebug]
zend_extension=php_xdebug-3.3.0-8.2-vs16-x64.dll
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.log=D:\laragon\logs\xdebug.log
xdebug.file_link_format=vscode://file/%f:%l

注意：不要使用已废弃的 xdebug.remote_* 参数（如 remote_enable）；PHP 8.0+ 必须用 xdebug.mode=debug；日志路径可选，但排查连接失败时非常有用。

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

PHPStorm：监听 + 正确路径映射

这是 Laragon + PHPStorm 调试失败最常见的原因——URL 路径和本地磁盘路径没对齐：

打开 Run → Start Listening for PHP Debug Connections（确保右下角显示 “Debug listening…”）
进入 Preferences → Languages & Frameworks → PHP → Servers，新增服务器：
– Name: laragon-local
– Host: localhost
– Port: 80（或你实际用的端口，如 8080）
– Check “Use path mappings”
在映射表中添加：
– Left（服务器路径）：D:/laragon/www/your-project
– Right（本地路径）：D:/laragon/www/your-project
（两者完全一致即可，Laragon 默认项目都在 www 下）
断点打在 app/Http/Controllers/ 或 routes/web.php 等可执行逻辑行，不要打在注释或空行

VS Code：轻量调试配置

适合快速验证，无需复杂 IDE：

安装官方扩展：PHP Debug（作者 Felix Becker）
在项目根目录创建 .vscode/launch.json，内容如下：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "D:/laragon/www/your-project": "${workspaceFolder}"
      }
    }
  ]
}

把 D:/laragon/www/your-project 替换为你实际的项目路径；${workspaceFolder} 是 VS Code 自动识别的本地路径，必须与左侧完全匹配。