Laravel Tdd

affaan-m/ECC/docs/zh-CN/skills/laravel-tdd

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775无许可证275K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库4天前更新

使用 PHPUnit 和 Pest、工厂、数据库测试、模拟以及覆盖率目标进行 Laravel 的测试驱动开发。

仅含说明Software Development
AI 生成的概览

指导 Laravel 应用的测试驱动开发，涵盖 PHPUnit 与 Pest、工厂、数据库策略和覆盖率目标。

功能
该技能提供基于红-绿-重构循环的 Laravel TDD 工作流，覆盖单元、功能和集成测试层级。它给出 PHPUnit 与 Pest 的具体指导和代码示例，包括模型工厂与状态、RefreshDatabase 等数据库策略、作业/队列/邮件/通知/事件的伪造、Sanctum 身份验证、HTTP 伪造、授权断言以及 Inertia 断言。它还设定单元加功能测试 80% 以上的覆盖率目标，并列出测试命令与 phpunit.xml 配置。
适用场景
适用于新增 Laravel 功能或端点、修复缺陷或重构，以及为 Eloquent 模型、策略、作业和通知编写测试的场景。也适合在 Pest 与 PHPUnit 之间做选择，或为 Laravel 测试套件制定数据库与覆盖率规范的团队。
运行要求
需要一个已安装 PHPUnit 或 Pest 的 Laravel 项目，覆盖率统计可选使用 pcov 或 Xdebug。该技能不包含脚本，仅为说明与代码示例。

Laravel TDD 工作流

使用 PHPUnit 和 Pest 为 Laravel 应用程序进行测试驱动开发，覆盖率（单元 + 功能）达到 80% 以上。

使用时机

  • Laravel 中的新功能或端点
  • 错误修复或重构
  • 测试 Eloquent 模型、策略、作业和通知
  • 除非项目已标准化使用 PHPUnit，否则新测试首选 Pest

工作原理

红-绿-重构循环

  1. 编写一个失败的测试
  2. 实施最小更改以通过测试
  3. 在保持测试通过的同时进行重构

测试层级

  • 单元：纯 PHP 类、值对象、服务
  • 功能：HTTP 端点、身份验证、验证、策略
  • 集成：数据库 + 队列 + 外部边界

根据范围选择层级：

  • 对纯业务逻辑和服务使用单元测试。
  • 对 HTTP、身份验证、验证和响应结构使用功能测试。
  • 当需要验证数据库/队列/外部服务组合时使用集成测试。

数据库策略

  • 对于大多数功能/集成测试使用 RefreshDatabase（每次测试运行运行一次迁移，然后在支持时将每个测试包装在事务中；内存数据库可能每次测试重新迁移）
  • 当模式已迁移且仅需要每次测试回滚时使用 DatabaseTransactions
  • 当每次测试都需要完整迁移/刷新且可以承担其开销时使用 DatabaseMigrations

将 RefreshDatabase 作为触及数据库的测试的默认选择：对于支持事务的数据库，它每次测试运行运行一次迁移（通过静态标志）并将每个测试包装在事务中；对于 :memory: SQLite 或不支持事务的连接，它在每次测试前进行迁移。当模式已迁移且仅需要每次测试回滚时使用 DatabaseTransactions。

测试框架选择

  • 新测试默认使用 Pest（当可用时）。
  • 仅在项目已标准化使用它或需要 PHPUnit 特定工具时使用 PHPUnit。

示例

PHPUnit 示例

php
use App\Models\User;use Illuminate\Foundation\Testing\RefreshDatabase;use Tests\TestCase;
final class ProjectControllerTest extends TestCase{    use RefreshDatabase;
    public function test_owner_can_create_project(): void    {        $user = User::factory()->create();
        $response = $this->actingAs($user)->postJson('/api/projects', [            'name' => 'New Project',        ]);
        $response->assertCreated();        $this->assertDatabaseHas('projects', ['name' => 'New Project']);    }}

功能测试示例（HTTP 层）

php
use App\Models\Project;use App\Models\User;use Illuminate\Foundation\Testing\RefreshDatabase;use Tests\TestCase;
final class ProjectIndexTest extends TestCase{    use RefreshDatabase;
    public function test_projects_index_returns_paginated_results(): void    {        $user = User::factory()->create();        Project::factory()->count(3)->for($user)->create();
        $response = $this->actingAs($user)->getJson('/api/projects');
        $response->assertOk();        $response->assertJsonStructure(['success', 'data', 'error', 'meta']);    }}

Pest 示例

php
use App\Models\User;use Illuminate\Foundation\Testing\RefreshDatabase;
use function Pest\Laravel\actingAs;use function Pest\Laravel\assertDatabaseHas;
uses(RefreshDatabase::class);
test('owner can create project', function () {    $user = User::factory()->create();
    $response = actingAs($user)->postJson('/api/projects', [        'name' => 'New Project',    ]);
    $response->assertCreated();    assertDatabaseHas('projects', ['name' => 'New Project']);});

Pest 功能测试示例（HTTP 层）

php
use App\Models\Project;use App\Models\User;use Illuminate\Foundation\Testing\RefreshDatabase;
use function Pest\Laravel\actingAs;
uses(RefreshDatabase::class);
test('projects index returns paginated results', function () {    $user = User::factory()->create();    Project::factory()->count(3)->for($user)->create();
    $response = actingAs($user)->getJson('/api/projects');
    $response->assertOk();    $response->assertJsonStructure(['success', 'data', 'error', 'meta']);});

工厂和状态

  • 使用工厂生成测试数据
  • 为边缘情况定义状态（已归档、管理员、试用）
php
$user = User::factory()->state(['role' => 'admin'])->create();

数据库测试

  • 使用 RefreshDatabase 保持干净状态
  • 保持测试隔离和确定性
  • 优先使用 assertDatabaseHas 而非手动查询

持久性测试示例

php
use App\Models\Project;use Illuminate\Foundation\Testing\RefreshDatabase;use Tests\TestCase;
final class ProjectRepositoryTest extends TestCase{    use RefreshDatabase;
    public function test_project_can_be_retrieved_by_slug(): void    {        $project = Project::factory()->create(['slug' => 'alpha']);
        $found = Project::query()->where('slug', 'alpha')->firstOrFail();
        $this->assertSame($project->id, $found->id);    }}

副作用模拟

  • 作业使用 Bus::fake()
  • 队列工作使用 Queue::fake()
  • 通知使用 Mail::fake() 和 Notification::fake()
  • 领域事件使用 Event::fake()
php
use Illuminate\Support\Facades\Queue;
Queue::fake();
dispatch(new SendOrderConfirmation($order->id));
Queue::assertPushed(SendOrderConfirmation::class);
php
use Illuminate\Support\Facades\Notification;
Notification::fake();
$user->notify(new InvoiceReady($invoice));
Notification::assertSentTo($user, InvoiceReady::class);

身份验证测试（Sanctum）

php
use Laravel\Sanctum\Sanctum;
Sanctum::actingAs($user);
$response = $this->getJson('/api/projects');$response->assertOk();

HTTP 和外部服务

  • 使用 Http::fake() 隔离外部 API
  • 使用 Http::assertSent() 断言出站负载

覆盖率目标

  • 对单元 + 功能测试强制执行 80% 以上的覆盖率
  • 在 CI 中使用 pcov 或 XDEBUG_MODE=coverage

测试命令

  • php artisan test
  • vendor/bin/phpunit
  • vendor/bin/pest

测试配置

  • 使用 phpunit.xml 设置 DB_CONNECTION=sqlite 和 DB_DATABASE=:memory: 以进行快速测试
  • 为测试保持独立的环境，以避免触及开发/生产数据

授权测试

php
use Illuminate\Support\Facades\Gate;
$this->assertTrue(Gate::forUser($user)->allows('update', $project));$this->assertFalse(Gate::forUser($otherUser)->allows('update', $project));

Inertia 功能测试

使用 Inertia.js 时，使用 Inertia 测试辅助函数来断言组件名称和属性。

php
use App\Models\User;use Inertia\Testing\AssertableInertia;use Illuminate\Foundation\Testing\RefreshDatabase;use Tests\TestCase;
final class DashboardInertiaTest extends TestCase{    use RefreshDatabase;
    public function test_dashboard_inertia_props(): void    {        $user = User::factory()->create();
        $response = $this->actingAs($user)->get('/dashboard');
        $response->assertOk();        $response->assertInertia(fn (AssertableInertia $page) => $page            ->component('Dashboard')            ->where('user.id', $user->id)            ->has('projects')        );    }}

优先使用 assertInertia 而非原始 JSON 断言，以保持测试与 Inertia 响应一致。

来源与署名

来源：affaan-m/ECC位于docs/zh-CN/skills/laravel-tdd提交ef648e0

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 affaan-m/ECC 的技能

Unified Notifications Ops

affaan-m

设计统一的通知策略，对来自 GitHub、Linear、钩子和聊天工具的通知进行分类、路由、去重和升级。

Productivity & Workflow275K4天前更新

Verification Loop

affaan-m

执行六阶段代码验证流程，并生成 PASS/FAIL 就绪报告。

Software Development275K4天前更新

Ui To Vue

affaan-m

将批量 UI 设计截图转换为使用 Vant、Element Plus 或 Ant Design Vue 的 Vue 3 组件。

Software Development275K4天前更新

Unified Memory

affaan-m

指导智能体通过本地 ECC Memory Vault 在不同执行框架之间共享持久上下文与交接信息。

AI & Agents275K4天前更新

Visa Doc Translate

affaan-m

通过 OCR 将签证文件图片翻译成英文，并生成原图与译文对照的双语 PDF。

Documents & Office275K4天前更新

Team Builder

affaan-m

交互式选择器：发现可用的智能体角色，让用户最多选择五个，并行执行同一任务并汇总结果。

AI & Agents275K4天前更新

更多Software Development技能

Playground

anthropics

精选

构建自包含的交互式 HTML 演练场，包含控件、实时预览和可复制的提示词输出。

Software Development37K今天更新

M5 Onboard

anthropics

精选

通过 USB 检测 M5Stack ESP32 开发板，刷写 UIFlow 2.0 固件并安装 MicroPython 应用包。

Software Development37K今天更新

Cardputer Buddy

anthropics

精选

指导迭代 Cardputer-Adv 的 MicroPython 应用包：添加应用、通过 USB 串口推送文件、查看日志并运行 REPL 命令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精选

依据从远程来源获取的 Web Interface Guidelines 审查 UI 代码，并以 file:line 形式报告问题。

Software Development32K5周前更新

Vercel React Native Skills

vercel-labs

精选

React Native 与 Expo 最佳实践规则，涵盖列表性能、动画、导航、UI 模式、状态与 monorepo 配置。

Software Development32K5周前更新

Vercel React Best Practices

vercel-labs

精选

Vercel 的 React 与 Next.js 性能指南，以 70 条规则的形式用于编写、审查和重构代码。

Software Development32K5周前更新