Laravel 애플리케이션을 어떻게 테스트하나요?

Question

Accepted Answer

Laravel은 (PHPUnit 기반, 현대적인 Pest 옵션과 함께) 뛰어난 내장 테스트 지원과 테스트 전용 헬퍼 — 테스트 데이터베이스, HTTP 테스트, 인증 헬퍼, fake — 를 제공하여 애플리케이션을 매우 테스트 가능하게 만듭니다. 테스트는 기능 테스트(전체 요청 흐름)와 단위 테스트(격리된 로직)로 나뉩니다.

## 기능 테스트 — 전체 요청 흐름 테스트

```php
class UserTest extends TestCase {
    use RefreshDatabase;            // 테스트당 새로 마이그레이션된 테스트 DB (격리)

public function test_can_create_user(): void {
        $response = $this->postJson('/api/users', [    // 앱에 실제 요청 보내기
            'name' => 'Ann', 'email' => 'ann@x.com',
        ]);
        $response->assertStatus(201)
                 ->assertJson(['name' => 'Ann']);       // 응답 단언
        $this->assertDatabaseHas('users', ['email' => 'ann@x.com']);   // DB 단언
    }
}
```

**기능 테스트**는 `get`/`postJson` 같은 헬퍼로 HTTP 요청을 보내 전체 스택(라우팅, middleware, 검증, 컨트롤러, 데이터베이스)을 실행한 다음, 응답과 데이터베이스 상태(`assertDatabaseHas`)를 단언합니다. 이는 실제 애플리케이션 동작을 검증합니다.

## 테스트 헬퍼가 Laravel을 매우 테스트 가능하게 만듦

```php
$this->actingAs($user)->get('/dashboard');         // 사용자로 인증
User::factory()->count(10)->create();               // 팩토리로 테스트 데이터 생성

Mail::fake(); Mail::assertSent(WelcomeEmail::class);   // 보내지 않고 메일 단언
Queue::fake(); Queue::assertPushed(ProcessJob::class); // 실행하지 않고 작업 큐 단언
Event::fake(); Storage::fake('s3');                    // 이벤트, 스토리지 등 fake
Http::fake();                                           // 외부 HTTP 호출 fake
```

Laravel의 **fake**(`Mail::fake()`, `Queue::fake()`, `Http::fake()` 등)는 이메일이 전송되었거나, 작업이 큐에 쌓였거나, HTTP 호출이 이루어졌음을 — 실제로 *수행하지 않고* — 단언할 수 있게 하여 빠르고 격리되며 결정론적인 테스트를 가능하게 합니다. `actingAs`와 팩토리 헬퍼는 인증되고 데이터가 풍부한 테스트 시나리오를 설정하기 쉽게 만듭니다.

## 단위 테스트와 Pest

```php
// 단위 테스트 — 격리된 로직, 프레임워크/DB 없음
public function test_discount_calculation(): void {
    $this->assertEquals(90, (new Cart)->applyDiscount(100, 10));
}

// Pest — PHPUnit 위의 현대적이고 표현력 있는 테스트 문법 (Laravel에서 인기)
it('creates a user', fn() => post('/users', [...])->assertCreated());
```

## 왜 중요한가

테스트는 신뢰할 수 있는 애플리케이션에 필수적이며, Laravel의 뛰어난 내장 테스트 지원 — 애플리케이션을 눈에 띄게 테스트 가능하게 만드는 웹 인식 헬퍼와 함께 — 은 어떻게 테스트하는지 이해하는 것이 코드 품질과 전문적 기대 모두를 위해 중요함을 의미합니다. **기능 테스트**는 특히 가치가 있습니다: 애플리케이션에 실제 HTTP 요청을 보내고 응답과 데이터베이스 상태를 단언함으로써(`RefreshDatabase` 트레이트가 격리된 테스트 데이터베이스를 제공), 전체 요청 흐름(라우팅, middleware, 검증, 컨트롤러, 영속성)이 함께 올바르게 동작하는지 검증합니다 — 사용자가 경험하는 대로 실제 동작을 테스트합니다.

Laravel의 **테스트 헬퍼와 fake**가 이를 매우 실용적으로 만드는 것입니다: 인증을 위한 `actingAs`, 테스트 데이터 생성을 위한 **팩토리**, 그리고 특히 부작용이 일어났음(이메일 전송, 작업 큐 쌓임, 외부 호출 이루어짐)을 실제로 *수행하지 않고* 단언하게 하는 **fake**(`Mail::fake()`, `Queue::fake()`, `Http::fake()`, `Event::fake()`) — 복잡한 동작의 빠르고 격리되며 결정론적인 테스트를 가능하게 합니다.

기능 테스트 대 단위 테스트, 테스트 헬퍼와 fake, 데이터를 위한 팩토리, 그리고 현대적인 Pest 옵션을 이해하는 것은 Laravel을 효과적으로 테스트하는 실용적 범위를 다룹니다.

Laravel이 그렇게 강력한 웹 인식 테스트 도구를 제공하고, 잘 테스트된 애플리케이션이 회귀를 잡고 자신 있는 리팩터링을 가능하게 하므로, Laravel의 테스트 지원 — 특히 기능 테스트와 fake/팩토리 헬퍼 — 을 활용하는 방법을 아는 것은 견고하고 유지보수 가능한 애플리케이션을 구축하는 개발자를, 테스트되지 않은 깨지기 쉬운 코드를 출시하는 개발자와 구별하는 중요한 시니어 수준의 지식이며, 전문적인 엔지니어링 관행을 반영합니다.