你如何使用 PHPUnit 测试 PHP 代码？

Question

Accepted Answer

**PHPUnit** 是 PHP 的标准测试框架 — 用于编写单元和集成测试，验证代码行为是否正确。结合依赖注入（用于 mocking）和 data providers 等工具，它能够进行全面的、可维护的测试。

## 一个基本的测试

```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 的 mocking 允许你用可控的虚拟对象替换依赖（邮件器、仓储、API）— 而依赖注入使得注入它们变得简单。你可以断言 mocks 被正确调用。这是快速、隔离单元测试的基础。

## 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** 针对多个输入集合运行相同的测试 — 干净地覆盖多个案例，无需重复。

## 最佳实践

```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 的 mocking 让你用可控的虚拟对象替换真实依赖（数据库、邮件器、外部 API）— 在没有真实基础设施的情况下启用快速、隔离的单元测试，并让你验证交互（断言 mock 被正确调用）。

DI 和可测性之间的这种联系正是依赖注入模式如此重要的原因。

理解 mocking、**data providers**（高效地测试多个输入案例）和测试最佳实践（测试行为而非实现、模拟外部依赖、覆盖边界情况和错误路径、为集成测试使用测试数据库）涵盖了有效 PHP 测试的实际范围。

经过良好测试的 PHP 能够捕获回归、支持自信重构并记录预期行为，而且由于现代框架（Laravel、Symfony）在 PHPUnit 基础上构建测试，了解它广泛适用。

掌握 PHPUnit — 特别是利用 mocking 和 DI 进行隔离测试 — 是重要的高级知识，它区分了构建健壮、可维护、经过充分测试应用的开发者和发布未测试、易损坏代码的开发者，使其成为频繁相关、专业重要的话题。