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

テストクラスは`TestCase`を継承し、テストメソッドは`test`で始まる（または`#[Test]`属性を使用）、`assert*`メソッドを使用して期待値を検証します（`assertEquals`、`assertTrue`、`assertCount`など）。`expectException`はエラーパスをテストします。

## 依存性のモッキング（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');
}
```

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
✓ 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のテスト方法を理解することは、コード品質と専門職としての期待の両面で重要です。

テストを書く方法（`TestCase`を継承、アサーションを使用、例外パスをテスト）を理解することは基本的ですが、最も価値のある洞察は**依存性注入がクリーンなテストを可能にする**ということです。設計が良好なPHPクラスは依存性を受け取るため、PHPUnitのモッキングにより、実際の依存性（データベース、メーラー、外部API）を制御可能な偽物に置き換えることができます。これにより、実際のインフラなしに高速で分離されたユニットテストが可能になり、モックが正しく呼び出されたかを検証できます。

DIとテスト可能性の間のこの接続は、依存性注入パターンが非常に重要である理由そのものです。

モッキング、**データプロバイダー**（複数の入力ケースを効率的にテスト）、テストベストプラクティス（実装ではなく動作をテスト、外部依存性をモック、エッジケースとエラーパスをカバー、統合テストにはテストデータベースを使用）を理解すれば、効果的なPHPテストの実践的な範囲をカバーできます。

テストが充実したPHPは、リグレッションを検出し、自信を持ってリファクタリングできるようにし、期待される動作を文書化します。また、モダンなフレームワーク（Laravel、Symfony）はテストをPHPUnitの上に構築しているため、PHPUnitを理解することは広く適用できます。

PHPUnitをマスターすること、特にモッキングとDIを活用して分離されたテストを実行することは、堅牢で保守性が高く、テストが充実したアプリケーションを構築する開発者とテストされていない脆いコードをリリースする開発者を区別する重要なシニアレベルの知識です。そのため、これは頻繁に関連する専門職として重要なトピックです。