PHPUnit

PHPUnit에서 테스트 케이스는 PHPUnit\Framework\TestCase 클래스를 상속받는 클래스로 작성한다. 각 테스트 케이스 클래스는 테스트하고자 하는 대상 클래스나 기능에 대응하여 생성되며, 클래스 내의 각 test 접두사로 시작하는 공개 메서드가 하나의 개별 테스트를 의미한다. 예를 들어, Calculator 클래스를 테스트하는 CalculatorTest 클래스를 만들고, 그 안에 testAddition 메서드를 정의하는 방식이다.

테스트 메서드 내에서는 주로 어설션 메서드를 사용하여 예상 결과와 실제 결과를 비교한다. assertEquals, assertTrue, assertFalse, assertSame 등의 다양한 어설션 메서드를 제공하여 코드의 동작을 검증할 수 있다. 테스트 대상 코드를 실행한 후, 어설션을 통해 반환값이나 객체 상태, 예외 발생 여부 등을 확인하는 것이 기본 패턴이다.

테스트 케이스 작성 시 네이밍 컨벤션과 코드 구성은 중요하다. 클래스명은 일반적으로 테스트대상클래스명Test 형식을 따르며, 메서드명은 test기능설명 형태로 작성하여 가독성을 높인다. 또한, 각 테스트는 서로 독립적으로 실행되어야 하므로, 테스트 간 의존성을 만들지 않도록 주의해야 한다. 이를 위해 setUp과 tearDown 메서드를 오버라이드하여 각 테스트 실행 전후에 공통 초기화 및 정리 작업을 수행할 수 있다.

어설션은 PHPUnit 테스트의 핵심 구성 요소로, 테스트 중인 코드의 실제 결과가 예상한 조건을 만족하는지 검증하는 명령문이다. 테스트 케이스 내에서 어설션 메서드를 호출하여 값의 동등성, 자료형, 불리언 상태, 예외 발생 여부 등을 확인한다. 어설션이 실패하면 해당 테스트는 실패로 간주되며, PHPUnit은 실패한 어설션의 위치와 이유를 상세히 보고한다.

PHPUnit은 다양한 검증 요구에 대응하기 위해 풍부한 내장 어설션 메서드를 제공한다. 가장 기본적인 것은 assertEquals($expected, $actual)로, 두 값이 동일한지 비교한다. 그 외에도 assertTrue()나 assertFalse()로 불리언 조건을, assertSame()으로 값과 자료형이 모두 일치하는지(strict comparison)를, assertCount()로 배열이나 Countable 객체의 요소 수를 검증할 수 있다. 또한 assertException()을 사용해 특정 예외 처리가 발생하는지 테스트할 수 있다.

이러한 어설션들은 테스트 대상 단위(Unit), 즉 개별 함수나 메서드의 행위를 명시적으로 정의하고 검증하는 수단이 된다. 이를 통해 개발자는 코드 변경 후 의도하지 않은 회귀 버그(Regression Bug)가 발생하지 않았음을 빠르게 확인할 수 있다. 효과적인 어설션 작성은 견고하고 유지보수 가능한 테스트 주도 개발(TDD) 및 단위 테스트 슈트 구축의 기초가 된다.

PHPUnit으로 작성한 테스트는 명령줄 인터페이스를 통해 실행한다. 가장 기본적인 방법은 phpunit 명령 뒤에 테스트 파일이나 디렉토리 경로를 지정하는 것이다. 예를 들어, MyTest.php 파일을 실행하려면 phpunit MyTest.php 명령을 사용한다. 특정 디렉토리 내의 모든 테스트를 실행하려면 phpunit tests/와 같이 디렉토리 경로를 인자로 전달할 수 있다.

테스트 실행을 세부적으로 제어하기 위해 다양한 옵션을 사용할 수 있다. --filter 옵션으로 특정 테스트 메서드 이름을 필터링하거나, --testsuite 옵션으로 사전에 정의된 테스트 스위트를 지정하여 실행할 수 있다. 또한, --coverage-html 옵션을 사용하면 테스트 커버리지 리포트를 HTML 형식으로 생성하여 코드의 어느 부분이 테스트되었는지 시각적으로 확인할 수 있다. 이러한 리포트는 소프트웨어 품질 관리에 유용하게 활용된다.

테스트 실행 결과는 성공, 실패, 에러, 스킵 등으로 구분되어 출력된다. 각 테스트 케이스의 통과 여부는 어설션의 결과에 따라 결정된다. 실패한 테스트는 기대값과 실제값의 차이를 보여주며, 개발자가 문제를 신속히 진단하고 수정할 수 있도록 돕는다. 지속적 통합 환경에서는 이러한 테스트 실행을 CI/CD 파이프라인에 통합하여 코드 변경 시마다 자동으로 테스트를 수행하고 품질 게이트 역할을 하도록 구성하는 것이 일반적이다.

테스트 더블은 실제 객체를 대신하여 테스트를 수행하는 객체를 총칭하는 개념이다. PHPUnit에서는 외부 의존성을 가진 코드를 격리하여 테스트할 수 있도록 다양한 종류의 테스트 더블을 제공한다. 가장 일반적으로 사용되는 것은 목 객체와 스텁이다. 목 객체는 테스트 중에 호출되는 메서드의 호출 여부, 호출 횟수, 전달된 인자 등을 검증하는 데 사용된다. 반면 스텁은 미리 정의된 값을 반환하거나 특정 동작을 수행하도록 설정하여, 실제 객체 없이도 테스트 대상 코드가 필요한 값을 받아 실행되도록 한다.

이 외에도 페이크 객체, 스파이, 더미 객체 등이 상황에 따라 활용된다. 페이크 객체는 실제 객체를 단순화한 구현체로, 운영 환경에서는 적합하지 않지만 테스트에는 충분한 기능을 제공한다. 스파이는 목 객체와 유사하지만, 호출에 대한 검증을 메서드 실행 후에 수행한다는 차이가 있다. 더미 객체는 단순히 인자 목록을 채우기 위해 전달될 뿐 실제로는 사용되지 않는 객체이다.

PHPUnit의 createMock() 메서드나 getMockBuilder()를 사용하면 이러한 테스트 더블을 쉽게 생성할 수 있다. 또한, 프로퍼시 기반의 목 객체 생성 방식을 통해 final 클래스나 private 메서드, 생성자 등에 대한 모의 처리가 가능하다. 이를 통해 단위 테스트의 핵심 원칙인 '격리된 테스트'를 효과적으로 달성하여, 테스트의 신뢰성과 유지보수성을 높인다.

데이터 제공자는 PHPUnit에서 동일한 테스트 메서드를 여러 세트의 인자로 반복 실행할 수 있게 해주는 기능이다. 이를 통해 다양한 입력값에 대해 동일한 검증 로직을 수행하는 테스트를 효율적으로 작성할 수 있으며, 코드 중복을 크게 줄여준다. 테스트 메서드에 @dataProvider 어노테이션을 사용하여 특정 데이터 제공자 메서드를 연결하면, 해당 제공자 메서드가 반환하는 각 배열이 테스트 메서드의 인자로 순차적으로 전달된다.

데이터 제공자 메서드는 반드시 public 접근 제어자를 가져야 하며, 배열의 배열(array[]) 또는 이터레이터(Iterator)를 반환해야 한다. 각 내부 배열(또는 이터레이터가 제공하는 각 값)은 테스트 메서드의 매개변수에 순서대로 대응된다. 예를 들어, 두 개의 숫자를 더하는 함수를 테스트할 때, [[1, 2, 3], [4, 5, 9]]와 같은 데이터 세트를 제공하면 첫 번째 실행에서는 (1, 2, 3), 두 번째 실행에서는 (4, 5, 9)가 인자로 전달되어 예상된 합계를 검증하는 데 사용된다.

이 기능은 경계값 분석이나 다양한 예외 케이스를 체계적으로 검증할 때 특히 유용하다. 또한, 테스트 커버리지를 넓히고 테스트의 신뢰성을 높이는 데 기여한다. 데이터 제공자를 사용하면 테스트 로직과 테스트 데이터를 분리할 수 있어, 가독성이 향상되고 새로운 테스트 케이스를 추가하기도 쉬워진다.

테스트 픽스처는 테스트를 실행하기 위해 필요한 일련의 사전 조건이나 상태를 의미한다. 이는 테스트가 반복 가능하고 신뢰할 수 있는 환경에서 실행되도록 보장하는 데 핵심적인 역할을 한다. 일반적으로 테스트 픽스처는 테스트 대상 객체의 초기 상태, 데이터베이스의 특정 데이터 세트, 특정 파일 구조, 또는 네트워크 서비스의 모의 응답 등을 포함할 수 있다.

PHPUnit에서는 테스트 픽스처를 설정하고 정리하는 작업을 setUp()과 tearDown() 메서드를 통해 관리한다. setUp() 메서드는 각 테스트 메서드가 실행되기 전에 호출되어 공통적인 초기화 작업을 수행한다. 반대로 tearDown() 메서드는 각 테스트 메서드 실행 후에 호출되어 사용한 자원을 정리하거나 상태를 원래대로 복원하는 역할을 한다. 이 방식을 사용하면 각 테스트 케이스가 독립적으로 실행될 수 있으며, 한 테스트의 결과가 다른 테스트에 영향을 미치는 부작용을 방지할 수 있다.

테스트 픽스처를 효율적으로 구성하는 것은 테스트 더블과 같은 기법과 밀접한 관련이 있다. 예를 들어, 실제 데이터베이스에 의존하기보다는 목 객체나 스텁을 사용하여 가상의 데이터를 제공함으로써 테스트 실행 속도를 높이고 외부 시스템의 불안정성을 제거할 수 있다. 또한 데이터 제공자를 활용하면 동일한 테스트 로직을 다양한 픽스처 데이터 세트로 반복 실행할 수 있어 테스트 커버리지를 확장하는 데 유용하다.

적절한 테스트 픽스처 관리는 유지보수성이 높은 테스트 스위트를 구축하는 기반이 된다. 이는 리팩토링을 안전하게 수행하고 회귀 테스트를 효과적으로 진행하며, 궁극적으로 소프트웨어 품질을 유지하는 데 기여한다.