Laravel アプリケーションのテストはどのように行いますか?

Question

Accepted Answer

Laravel は優れた組み込みテスト機能（PHPUnit ベース、モダンな Pest オプション付き）とテスト専用ヘルパー（テスト用データベース、HTTP テスト、認証ヘルパー、フェイク）を提供しており、アプリケーションは高いテスト可能性を持ちます。テストはフィーチャーテスト（完全なリクエストフロー）とユニットテスト（分離されたロジック）に分かれます。

## フィーチャーテスト — 完全なリクエストフローをテストする

```php
class UserTest extends TestCase {
    use RefreshDatabase;            // fresh, migrated test database per test (isolated)

public function test_can_create_user(): void {
        $response = $this->postJson('/api/users', [    // make a real request to the app
            'name' => 'Ann', 'email' => 'ann@x.com',
        ]);
        $response->assertStatus(201)
                 ->assertJson(['name' => 'Ann']);       // assert the response
        $this->assertDatabaseHas('users', ['email' => 'ann@x.com']);   // assert the DB
    }
}
```

**フィーチャーテスト**は、`get`/`postJson` などのヘルパーを使用して HTTP リクエストを行い、レスポンスとデータベースの状態（`assertDatabaseHas`）をアサートすることで、フルスタック（ルーティング、ミドルウェア、バリデーション、コントローラー、データベース）を実行します。これにより、実際のアプリケーション動作を検証します。

## テストヘルパーにより Laravel は高いテスト可能性を持つ

```php
$this->actingAs($user)->get('/dashboard');         // authenticate as a user
User::factory()->count(10)->create();               // generate test data via factories

Mail::fake(); Mail::assertSent(WelcomeEmail::class);   // assert mail without sending
Queue::fake(); Queue::assertPushed(ProcessJob::class); // assert jobs queued, don't run them
Event::fake(); Storage::fake('s3');                    // fake events, storage, etc.
Http::fake();                                           // fake external HTTP calls
```

Laravel の**フェイク**（`Mail::fake()`、`Queue::fake()`、`Http::fake()` など）を使用すると、メールが送信されたか、ジョブがキューイングされたか、HTTP 呼び出しが行われたかをアサートできます — **実際に実行することなく**高速で分離した確定的なテストが可能になります。`actingAs` とファクトリーヘルパーにより、認証済みで豊富なデータを持つテストシナリオのセットアップが簡単になります。

## ユニットテストと Pest

```php
// unit test — isolated logic, no framework/DB
public function test_discount_calculation(): void {
    $this->assertEquals(90, (new Cart)->applyDiscount(100, 10));
}

// Pest — a modern, expressive testing syntax on top of PHPUnit (popular in Laravel)
it('creates a user', fn() => post('/users', [...])->assertCreated());
```

## なぜ重要なのか

テストは信頼性の高いアプリケーションに不可欠であり、Laravel の優れた組み込みテスト機能（Web に対応したヘルパーでアプリケーションの高いテスト可能性を実現）を理解することは、コード品質とプロフェッショナルな期待の両面で重要です。**フィーチャーテスト**は特に価値があります。実際の HTTP リクエストをアプリケーションに対して行い、レスポンスとデータベースの状態をアサートする（`RefreshDatabase` トレイトが分離されたテスト用データベースを提供）ことで、ルーティング、ミドルウェア、バリデーション、コントローラー、永続化を含む全体的なリクエストフローが正しく連携して動作することを確認し、ユーザーが経験するのと同じ実際の動作をテストします。

Laravel の**テストヘルパーとフェイク**によりこの実装が非常に実用的になります。認証用の `actingAs`、テストデータ生成用の**ファクトリー**、そして特に**フェイク**（`Mail::fake()`、`Queue::fake()`、`Http::fake()`、`Event::fake()`）により、メール送信、ジョブキューイング、外部呼び出しなどの副作用が発生したことをアサートできます — **実際に実行することなく** — 複雑な動作の高速で分離した確定的なテストが可能になります。

フィーチャーテスト対ユニットテスト、テストヘルパーとフェイク、データ用ファクトリー、モダンな Pest オプションの理解は、Laravel を効果的にテストするための実用的な範囲をカバーしています。

Laravel は Web に対応した強力なテストツールを提供しており、十分にテストされたアプリケーションはリグレッションを検出し自信を持ったリファクタリングを実現するため、Laravel のテスト機能を活用する方法 — 特にフィーチャーテストとフェイク/ファクトリーヘルパー — を理解することは、堅牢で保守性の高いアプリケーションを構築する開発者と、テストされていない脆弱なコードをリリースする開発者を区別する重要なシニアレベルの知識であり、プロフェッショナルなエンジニアリング実践を反映しています。