Làm sao test code PHP với PHPUnit?

Question

Accepted Answer

**PHPUnit** là framework test tiêu chuẩn cho PHP — dùng để viết các unit test và integration test xác minh code hoạt động đúng. Kết hợp với dependency injection (để mock) và các công cụ như data provider, nó cho phép test kỹ lưỡng, dễ bảo trì.

## Một test cơ bản

```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);          // assertion
        $this->assertIsInt($result);
    }

public function testDivideByZeroThrows(): void {
        $this->expectException(DivisionByZeroError::class);   // khẳng định nó ném lỗi
        (new Calculator())->divide(1, 0);
    }
}
// chạy với: ./vendor/bin/phpunit
```

Các class test extend `TestCase`, các method test bắt đầu bằng `test` (hoặc dùng attribute `#[Test]`), và dùng các method `assert*` để xác minh kỳ vọng (`assertEquals`, `assertTrue`, `assertCount`, v.v.). `expectException` test các nhánh lỗi.

## Mock các phụ thuộc (cô lập qua DI)

```php
public function testSendsWelcomeEmail(): void {
    // tạo một MOCK của một phụ thuộc — không cần mailer thật
    $mailer = $this->createMock(MailerInterface::class);
    $mailer->expects($this->once())          // khẳng định nó được gọi đúng một lần
           ->method('send')
           ->with('ann@x.com', $this->stringContains('Welcome'));

$service = new UserService($mailer);     // TIÊM mock vào (DI khiến điều này dễ dàng)
    $service->register('ann@x.com');
}
```

Mocking của PHPUnit cho phép bạn thay thế các phụ thuộc (mailer, repository, API) bằng các đối tượng giả kiểm soát được — và dependency injection khiến việc tiêm chúng vào trở nên đơn giản. Bạn có thể khẳng định rằng các mock được gọi đúng. Đây là nền tảng của các unit test nhanh, cô lập.

## Data provider (test nhiều trường hợp)

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

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

**Data provider** chạy cùng một test với nhiều tập input — bao phủ gọn gàng nhiều trường hợp mà không trùng lặp.

## Thực hành tốt

```text
✓ Test hành vi/API công khai, không phải chi tiết triển khai (để refactor không làm hỏng test)
✓ Mock các phụ thuộc bên ngoài (DB, API, mailer) cho unit test nhanh, cô lập
✓ Dùng cơ sở dữ liệu test cho integration test; setUp/tearDown cho fixture
✓ Đo độ phủ; test các ca biên và nhánh lỗi, không chỉ luồng thuận lợi
✓ Các framework (Laravel, Symfony) xây trên PHPUnit với các helper test thêm
```

## Tại sao điều này quan trọng

Test là thiết yếu để xây ứng dụng PHP đáng tin cậy, dễ bảo trì, và **PHPUnit** là công cụ tiêu chuẩn — nên hiểu cách test PHP là quan trọng cả cho chất lượng code lẫn như một kỳ vọng chuyên nghiệp.

Biết cách viết test (extend `TestCase`, dùng các assertion, test các nhánh exception) là nền tảng, nhưng điểm giá trị nhất là cách **dependency injection cho phép test gọn gàng**: vì các class PHP được thiết kế tốt nhận các phụ thuộc của chúng, mocking của PHPUnit cho phép bạn thay thế các phụ thuộc thật (cơ sở dữ liệu, mailer, API bên ngoài) bằng các đối tượng giả kiểm soát được — cho phép các unit test nhanh, cô lập mà không cần hạ tầng thật, và cho bạn xác minh các tương tác (khẳng định một mock được gọi đúng).

Mối liên hệ giữa DI và khả năng test này chính xác là lý do mẫu dependency injection quan trọng đến vậy.

Hiểu mocking, **data provider** (test nhiều ca input một cách hiệu quả), và các thực hành test tốt (test hành vi không phải triển khai, mock các phụ thuộc bên ngoài, bao phủ các ca biên và nhánh lỗi, dùng cơ sở dữ liệu test cho integration test) bao phủ phạm vi thực tế của test PHP hiệu quả.

PHP được test tốt bắt được regression, cho phép refactor tự tin, và làm tài liệu cho hành vi kỳ vọng, và vì các framework hiện đại (Laravel, Symfony) xây test của chúng trên PHPUnit, biết nó có thể áp dụng rộng rãi.

Thành thạo PHPUnit — đặc biệt tận dụng mocking và DI cho các test cô lập — là kiến thức cấp senior quan trọng phân biệt các lập trình viên xây ứng dụng vững chắc, dễ bảo trì, được test tốt với những người ship code chưa test, mong manh, khiến nó là một chủ đề thường xuyên liên quan, quan trọng về mặt chuyên nghiệp.