如何用Laragon测Laravel API？接口调试法-php教程-PHP中文网

laragon测laravel api需四步：①项目放入www目录并配好.env、扩展及密钥；②用postman按虚拟主机域名发请求，启用interceptor同步session；③配置xdebug+phpstorm断点调试；④用phpunit+sqlite写自动化接口测试。

如何用laragon测laravel api？接口调试法

用 Laragon 测 Laravel API，核心是让本地环境跑通项目 + 能发起真实请求 + 支持断点调试。不需要额外装 Apache 或 Nginx 服务，Laragon 自带的 PHP 内置服务器或 Nginx/Apache 都能用，关键在配置和工具链打通。

确保 Laravel 项目在 Laragon 中正常运行

把完整 Laravel 项目（含 .env、artisan、composer.json）放进 D:\laragon\www\your-api（路径可自定）。检查以下三点：

.env 文件存在且基础配置正确：DB_DATABASE 名要与 HeidiSQL 中创建的库名一致；APP_URL 建议设为 http://your-api.test（Laragon 自动解析）或 http://localhost；APP_DEBUG=true 开启错误提示
PHP 扩展已启用：mbstring、openssl、pdo、json、xml、ctype 必须加载；可在 Laragon 主界面点击 PHP → Extensions 查看并勾选
依赖已安装、密钥已生成：右键托盘 → Terminal → your-api，执行：
composer install
php artisan key:generate
php artisan migrate

用 Postman 发起真实 API 请求

Postman 是测 API 最直接的方式，尤其适合 POST/PUT/DELETE 和带 Header 的请求。注意两个细节：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

域名必须匹配 Laragon 虚拟主机：比如项目文件夹叫 api-backend，就访问 http://api-backend.test/api/login，而不是 http://localhost:8000 —— 后者绕过了 Laragon 的 Nginx/Apache，可能丢失重写规则或 HTTPS 配置
如需带 Cookie 或 Session（如登录态），开启 Postman Interceptor 插件：在 Chrome 安装 Postman Interceptor 扩展，打开监控开关，再在 Postman 中点击右上角“Interceptor”图标启用同步。这样登录请求的 session_id 就能自动带上

用 Xdebug + PHPStorm 断点调试接口逻辑

不只是看返回值，更要进代码里查变量、流程、SQL。Laragon 已预装 Xdebug，只需三步激活：

确认 php.ini 已加载 Xdebug：打开 Laragon → PHP → php.ini，在末尾检查是否有类似内容（路径按你实际 PHP 版本调整）：

[xdebug]<br>zend_extension="D:\laragon\bin\php\php-8.2.12-Win32-vs16-x64\ext\php_xdebug-3.2.2-8.2-vs16-x86_64.dll"<br>xdebug.mode=debug<br>xdebug.client_host=127.0.0.1<br>xdebug.client_port=9003<br>xdebug.start_with_request=yes

PHPStorm 中配置监听：菜单 Run → Start Listening for PHP Debug Connections；再打开 Run → Edit Configurations → + → PHP Remote Debug，Server 选 laragon（或新建），IDE key 填 PHPSTORM，端口填 9003
浏览器或 Postman 触发时自动中断：在控制器方法第一行打个断点，访问 http://api-backend.test/api/users?XDEBUG_SESSION_START=PHPSTORM（或用 Chrome Xdebug Helper 插件一键开启）

用 PHPUnit 写自动化接口测试

适合回归验证，尤其改完逻辑后快速确认是否破坏原有行为。推荐搭配 SQLite 测试库，不污染主数据库：

复制 .env.example 为 .env.testing，修改为：

DB_CONNECTION=sqlite<br>DB_DATABASE=D:\laragon\www\your-api\database\testing.sqlite

执行 php artisan make:test Api/UsersTest，在类开头加 use RefreshDatabase;

写一个简单测试，比如验证登录接口返回 200：

public function test_login_returns_token() {<br>  $response = $this->postJson('/api/login', [<br>    'email' => 'test@example.com',<br>    'password' => 'password'<br>  ]);<br>  $response->assertStatus(200)->assertJsonStructure(['token']);<br>}