PHP 单元测试：实践中遇到的常见问题及解决方案

php 单元测试陷阱：依赖项注入困难：使用依赖项注入容器（例如 prophecy 或 mockery）和接口/抽象类。模拟数据库交互困难：使用依赖抽象层（例如 doctrine），模拟查询，或在虚拟环境中运行数据库。测试覆盖率低：使用覆盖率报告（–coverage-text）识别低覆盖率区域，编写更多测试。难以测试私有方法：使用 setaccessible() 方法、反射（已弃用）或公开方法。测试 fixture 设置/清理：使用 setup() 和 teardown() 方法，将 fixture 存储在公共静态属性中。

PHP 单元测试：实战中常见的陷阱和对策

单元测试对于编写健壮、无错误的 PHP 代码至关重要。然而，在实际应用中，您可能会遇到各种陷阱。本文将探讨常见的单元测试问题及其解决方案，帮助您提升测试效率和代码质量。

问题 1：依赖项注入困难

单元测试需要隔离各个组件，因此依赖项注入可能很困难。

解决方案：

• 使用依赖项注入容器，例如 PHPUnit 的 Prophecy 或 Mockery。
• 在需要依赖项的类中使用接口或抽象类，使您可以在测试中使用模拟。

问题 2：难以模拟数据库交互

数据库交互可能会给单元测试带来挑战，因为您需要确保不会修改实际数据库。

解决方案：

• 使用像 PHPUnit_MockObject_Generator_MockObjectForInvocationMocker 这样的库来模拟数据库查询。
• 通过隔离进行测试，在虚拟环境中运行数据库。
• 依赖抽象层，例如 Doctrine，它可以轻松模拟数据库操作。

问题 3：测试覆盖率低

低测试覆盖率表明您的测试可能遗漏了某些可能出现问题的情况。

解决方案：

• 使用 PHPUnit 的 –coverage-text 选项来生成覆盖率报告。
• 检查报告并识别覆盖率较低的区域，以编写更多测试。
• 使用 PHPUnit 的 –filter 选项专注于特定类或方法。

问题 4：难以测试私有方法

PHP 的私有方法默认不可测试。

解决方案：

• 使用 PHPUnit 的 setAccessible() 方法手动使私有方法可访问。
• 使用反射来调用私有方法，但这种方法在 PHP 8 中已弃用。

问题 5：测试 Fixture 的设置和清理

在测试中设置和清理测试 Fixture（数据或资源）至关重要，以确保测试的隔离性。

解决方案：

• 使用 PHPUnit 的 setUp() 和 tearDown() 方法，它们会在每个测试之前和之后运行。
• 将 Fixture 存储在公共静态属性中，以便在整个测试期间访问它们。

实战案例：

以下是一个模拟用户存储库的简单测试：

class UserRepoTest extends TestCase
{
    private $repo;

    public function setUp(): void
    {
        $this->repo = new UserRepo();
    }

    public function testFindById()
    {
        $user = $this->createMock(User::class);
        $this->repo->method('findById')->willReturn($user);
        $this->assertEquals($user, $this->repo->findById(1));
    }
}

结论：

解决单元测试的常见问题至关重要，以确保编写无错误、高质量的 PHP 代码。通过使用依赖项注入、模拟数据库交互、提高测试覆盖率、测试私有方法和设置测试 Fixture，您可以提高单元测试的效率和可靠性。