PHPUnit으로 PHP 코드를 어떻게 테스트하나요?

Question

Accepted Answer

**PHPUnit**은 PHP의 표준 테스트 프레임워크입니다 — 코드가 올바르게 동작하는지 검증하는 단위 및 통합 테스트를 작성하는 데 사용됩니다. (모킹을 위한) 의존성 주입 및 데이터 프로바이더 같은 도구와 결합하면 철저하고 유지보수 가능한 테스트가 가능합니다.

## 기본 테스트

```php
<?php
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
    public function testAdd(): void {
        $calc = new Calculator();
        $result = $calc->add(2, 3);
        $this->assertEquals(5, $result);          // 어서션
        $this->assertIsInt($result);
    }

public function testDivideByZeroThrows(): void {
        $this->expectException(DivisionByZeroError::class);   // 던지는지 어서션
        (new Calculator())->divide(1, 0);
    }
}
// 실행: ./vendor/bin/phpunit
```

테스트 클래스는 `TestCase`를 확장하고, 테스트 메서드는 `test`로 시작하며(또는 `#[Test]` 속성 사용), `assert*` 메서드로 기대를 검증합니다(`assertEquals`, `assertTrue`, `assertCount` 등). `expectException`은 오류 경로를 테스트합니다.

## 의존성 모킹 (DI를 통한 격리)

```php
public function testSendsWelcomeEmail(): void {
    // 의존성의 모킹 생성 — 실제 메일러 불필요
    $mailer = $this->createMock(MailerInterface::class);
    $mailer->expects($this->once())          // 정확히 한 번 호출되는지 어서션
           ->method('send')
           ->with('ann@x.com', $this->stringContains('Welcome'));

$service = new UserService($mailer);     // 모킹 주입 (DI가 이를 쉽게 만듦)
    $service->register('ann@x.com');
}
```

PHPUnit의 모킹은 의존성(메일러, 리포지토리, API)을 제어 가능한 페이크로 대체하게 합니다 — 그리고 의존성 주입이 이들의 주입을 간단하게 만듭니다. 모킹이 올바르게 호출되는지 어서션할 수 있습니다. 이것이 빠르고 격리된 단위 테스트의 기반입니다.

## 데이터 프로바이더 (여러 케이스 테스트)

```php
public static function additionCases(): array {
    return [[1, 1, 2], [0, 5, 5], [-1, 1, 0]];   // [a, b, expected]
}

#[DataProvider('additionCases')]
public function testAdd(int $a, int $b, int $expected): void {
    $this->assertEquals($expected, (new Calculator())->add($a, $b));
}
```

**데이터 프로바이더**는 같은 테스트를 여러 입력 집합에 대해 실행합니다 — 중복 없이 여러 케이스를 깔끔하게 커버합니다.

## 모범 사례

```text
✓ 구현 세부사항이 아닌 동작/공개 API를 테스트 (리팩터링이 테스트를 깨지 않도록)
✓ 빠르고 격리된 단위 테스트를 위해 외부 의존성(DB, API, 메일러) 모킹
✓ 통합 테스트에는 테스트 DB 사용; 픽스처에는 setUp/tearDown
✓ 커버리지 측정; 해피 패스뿐 아니라 엣지 케이스와 오류 경로 테스트
✓ 프레임워크(Laravel, Symfony)는 PHPUnit 위에 추가 테스트 헬퍼를 구축
```

## 왜 중요한가

테스트는 신뢰할 수 있고 유지보수 가능한 PHP 애플리케이션을 구축하는 데 필수적이며, **PHPUnit**은 표준 도구입니다 — 그래서 PHP 테스트 방법을 이해하는 것은 코드 품질을 위해서나 전문적인 기대로서나 중요합니다.

테스트 작성법(`TestCase` 확장, 어서션 사용, 예외 경로 테스트)을 아는 것은 기초적이지만, 가장 가치 있는 통찰은 **의존성 주입이 깔끔한 테스트를 어떻게 가능하게 하는지**입니다. 잘 설계된 PHP 클래스는 의존성을 받으므로, PHPUnit의 모킹으로 실제 의존성(데이터베이스, 메일러, 외부 API)을 제어 가능한 페이크로 대체할 수 있습니다 — 실제 인프라 없이 빠르고 격리된 단위 테스트를 가능하게 하고, 상호작용을 검증하게 합니다(모킹이 올바르게 호출되었는지 어서션).

이 DI와 테스트 가능성의 연결이 바로 의존성 주입 패턴이 그토록 중요한 이유입니다.

모킹, **데이터 프로바이더**(여러 입력 케이스를 효율적으로 테스트), 테스트 모범 사례(구현이 아닌 동작 테스트, 외부 의존성 모킹, 엣지 케이스와 오류 경로 커버, 통합 테스트에 테스트 DB 사용)를 이해하는 것은 효과적인 PHP 테스트의 실용적 범위를 다룹니다.

잘 테스트된 PHP는 회귀를 잡고, 자신 있는 리팩터링을 가능하게 하며, 기대 동작을 문서화하고, 현대 프레임워크(Laravel, Symfony)가 테스트를 PHPUnit 위에 구축하므로 이를 아는 것은 폭넓게 적용됩니다.

PHPUnit을 숙달하는 것 — 특히 격리된 테스트를 위해 모킹과 DI를 활용하는 것 — 은 견고하고 유지보수 가능하며 잘 테스트된 애플리케이션을 구축하는 개발자를, 테스트되지 않은 취약한 코드를 출시하는 개발자와 구별 짓는 중요한 시니어 수준 지식이며, 자주 관련되고 전문적으로 중요한 주제입니다.