SuperAPI AI 工具集

laravel-testing

测试与质量

查看项目

更新于 10-26 16:21

技能介绍

Laravel Testing 是一份面向 Laravel 应用的测试实践指南与技能插件,主要服务于编写控制器、服务和模型测试以及实践测试驱动开发(TDD)的场景。根据资料,它适用于 Laravel 13 配合 Pest 5 / PHPUnit 13,若应用仍在 PHP 8.3 上运行则使用 Pest 4 / PHPUnit 12。

主要能力

  • 测试类型划分:Feature 测试(位于 tests/Feature/,覆盖 HTTP 与全栈流程)、Unit 测试(位于 tests/Unit/,针对隔离类)、Arch 测试(位于 tests/Arch.php,校验代码架构)、E2E 测试(覆盖用户旅程)。
  • 决策引导:按测试对象选择类型,例如 HTTP 端点用 Feature 测试、Service 或 Policy 逻辑用 Unit 测试、代码结构用 Arch 测试、外部 API 用 Http::fake() 模拟、邮件/队列/事件使用 Fakes、数据库状态用 assertDatabaseHas()。策略上给出 Feature 约 70%、Unit 约 25%、E2E 约 5% 的参考配比。
  • 关键规则:使用 RefreshDatabase 保证数据库隔离,用工厂生成测试数据而非原始插入,模拟外部服务而不调用真实 API,覆盖空值、null、边界等边缘情况,并用 pest --parallel 并行提速。
  • 参考主题:Pest 基础与数据集、HTTP 请求与 JSON API 断言、认证、数据库基础与工厂及断言、模拟服务与 Fakes、时间与 HTTP 模拟、控制台测试、故障排查等。
  • 模板:Feature、Unit、Arch、API 测试模板与 Pest 配置模板。
  • 命令:php artisan test、./vendor/bin/pest、--parallel、--filter、--coverage --min=80、--profile 等。

使用方式 资料为代理工作流设定了强制步骤:在实现前并行启动三个代理,分别用于分析现有测试模式、通过 Context7 核对 Pest/PHPUnit 文档、查询断言与模拟模式;实现后运行 sniper 做验证。使用者可按决策指南选择测试类型,套用模板编写测试,再用列出的命令运行。

适用场景 适用于 Laravel 项目的控制器、服务、模型测试与 TDD 实践,也适合需要结构化测试策略、HTTP 与数据库断言、外部服务模拟和架构约束校验的团队。

版本说明与限制 Laravel 13 使用 PHPUnit 12/13 与 Pest 4/5,PHP 属性取代了 docblock 注解(如 #[Test]、#[Seed]、#[Seeder]),并提供 #[UnitTest] 跳过应用启动;Laravel 13 会在测试收尾时重置自定义 Str 工厂,依赖跨方法持久化的测试需在每个测试或 setup 中设置。Pest 3 迁移到 4 需升级插件、执行 --update-snapshots,watch 与 faker 插件已归档;Pest 5 需要 PHP 8.4+,新增 --tia(仅本地)、PHPStan/Rector 插件、Agent 与 Evals 插件、按时间均衡分片。资料未提供收费、价格或平台支持等信息,相关事实暂未提供。