คุณทดสอบโค้ด PHP ด้วย PHPUnit อย่างไร?

Question

Accepted Answer

**PHPUnit** คือเฟรมเวิร์กทดสอบมาตรฐานสำหรับ PHP ใช้เขียน unit test และ integration test เพื่อยืนยันว่าโค้ดทำงานถูกต้อง เมื่อรวมกับ dependency injection (สำหรับการทำ mock) และเครื่องมืออย่าง data provider มันช่วยให้ทำการทดสอบที่ครอบคลุมและบำรุงรักษาได้

## การทดสอบพื้นฐาน

```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);   // assert it throws
        (new Calculator())->divide(1, 0);
    }
}
// run with: ./vendor/bin/phpunit
```

คลาสทดสอบ extend จาก `TestCase`, เมธอดทดสอบขึ้นต้นด้วย `test` (หรือใช้ attribute `#[Test]`) และใช้เมธอด `assert*` เพื่อยืนยันความคาดหวัง (`assertEquals`, `assertTrue`, `assertCount` ฯลฯ) ส่วน `expectException` ใช้ทดสอบเส้นทางของข้อผิดพลาด

## การ mock dependency (การแยกตัว via DI)

```php
public function testSendsWelcomeEmail(): void {
    // create a MOCK of a dependency — no real mailer needed
    $mailer = $this->createMock(MailerInterface::class);
    $mailer->expects($this->once())          // assert it's called exactly once
           ->method('send')
           ->with('ann@x.com', $this->stringContains('Welcome'));

$service = new UserService($mailer);     // INJECT the mock (DI makes this easy)
    $service->register('ann@x.com');
}
```

การ mock ของ PHPUnit ช่วยให้คุณแทนที่ dependency (mailer, repository, API) ด้วยของปลอมที่ควบคุมได้ และ dependency injection ทำให้การฉีดมันเข้ามาง่ายมาก คุณสามารถยืนยันได้ว่า mock ถูกเรียกอย่างถูกต้อง นี่คือรากฐานของ unit test ที่รวดเร็วและแยกตัว

## Data providers (ทดสอบหลายกรณี)

```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));
}
```

**Data providers** รันการทดสอบเดียวกันกับชุด input หลาย ๆ ชุด เป็นการครอบคลุมหลายกรณีอย่างสะอาดโดยไม่มีความซ้ำซ้อน

## แนวปฏิบัติที่ดี

```text
✓ Test behavior/public API, not implementation details (so refactors don't break tests)
✓ Mock external dependencies (DB, APIs, mailers) for fast, isolated unit tests
✓ Use a test database for integration tests; setUp/tearDown for fixtures
✓ Measure coverage; test edge cases and error paths, not just the happy path
✓ Frameworks (Laravel, Symfony) build on PHPUnit with extra testing helpers
```

## ทำไมจึงสำคัญ

การทดสอบจำเป็นต่อการสร้างแอปพลิเคชัน PHP ที่เชื่อถือได้และบำรุงรักษาได้ และ **PHPUnit** คือเครื่องมือมาตรฐาน การเข้าใจวิธีทดสอบ PHP จึงสำคัญทั้งต่อคุณภาพของโค้ดและในฐานะความคาดหวังระดับมืออาชีพ

การรู้วิธีเขียนการทดสอบ (extend `TestCase`, ใช้ assertion, ทดสอบเส้นทางของ exception) เป็นพื้นฐาน แต่ข้อคิดที่มีคุณค่าที่สุดคือวิธีที่ **dependency injection เปิดทางให้การทดสอบที่สะอาด**: เพราะคลาส PHP ที่ออกแบบมาดีรับ dependency ของมัน การ mock ของ PHPUnit จึงช่วยให้คุณแทนที่ dependency จริง (ฐานข้อมูล, mailer, API ภายนอก) ด้วยของปลอมที่ควบคุมได้ ทำให้ทำ unit test ที่รวดเร็วและแยกตัวได้โดยไม่ต้องใช้โครงสร้างพื้นฐานจริง และทำให้คุณยืนยันการโต้ตอบได้ (ตรวจว่า mock ถูกเรียกอย่างถูกต้อง)

ความเชื่อมโยงระหว่าง DI กับความสามารถในการทดสอบนี้คือเหตุผลที่แพตเทิร์น dependency injection มีความสำคัญมาก

การเข้าใจการ mock, **data providers** (ทดสอบ input หลายกรณีอย่างมีประสิทธิภาพ) และแนวปฏิบัติที่ดีในการทดสอบ (ทดสอบพฤติกรรมไม่ใช่ implementation, mock dependency ภายนอก, ครอบคลุม edge case และเส้นทางของข้อผิดพลาด, ใช้ฐานข้อมูลทดสอบสำหรับ integration test) ครอบคลุมขอบเขตในทางปฏิบัติของการทดสอบ PHP ที่มีประสิทธิภาพ

PHP ที่ทดสอบมาดีช่วยดักจับการถดถอย (regression) เปิดทางให้ refactor ได้อย่างมั่นใจ และทำหน้าที่เป็นเอกสารของพฤติกรรมที่คาดหวัง และเนื่องจากเฟรมเวิร์กสมัยใหม่ (Laravel, Symfony) สร้างระบบทดสอบของตนบน PHPUnit การรู้จักมันจึงนำไปใช้ได้อย่างกว้างขวาง

การเชี่ยวชาญ PHPUnit โดยเฉพาะการใช้ประโยชน์จากการ mock และ DI เพื่อทำการทดสอบที่แยกตัว เป็นความรู้ระดับ senior ที่สำคัญ ซึ่งแยกแยะนักพัฒนาที่สร้างแอปพลิเคชันที่แข็งแกร่ง บำรุงรักษาได้ และทดสอบมาดี ออกจากผู้ที่ส่งมอบโค้ดที่ไม่ได้ทดสอบและเปราะบาง ทำให้มันเป็นหัวข้อที่เกี่ยวข้องบ่อยและสำคัญในระดับมืออาชีพ