PHP 单元测试实战指南：如何使用 Mock 对象提高测试效率

M66 2025-09-29

单元测试中的 Mock 对象概述

Mock 对象是单元测试中常用的测试替身，用于模拟类或接口的行为，并且可以精确控制其返回值或抛出异常的行为。通过 Mock 对象，开发者可以在不实例化实际依赖的情况下测试函数或方法的交互逻辑。

创建 Mock 对象

在 PHP 中，可以使用 getMockBuilder 方法创建 Mock 对象。该方法接受以下参数：

$originalClassName：要模拟的类或接口名称。
$methods（可选）：需要模拟的方法数组。

// 模拟 MyInterface 接口
$mock = $this->getMockBuilder(MyInterface::class)
             ->getMock();

// 模拟 MyClass 类并模拟其方法
$mock = $this->getMockBuilder(MyClass::class)
             ->setMethods(['myMethod'])
             ->getMock();

配置 Mock 对象

创建 Mock 对象后，可以通过 method 方法配置其行为，例如设置返回值或抛出异常：

// 配置 Mock 对象以返回 'foo'
$mock->method('getMyMethod')
     ->willReturn('foo');

// 配置 Mock 对象以抛出异常
$mock->method('myOtherMethod')
     ->willThrowException(new RuntimeException());

实战案例

下面是一个示例，展示如何在单元测试中使用 Mock 对象。假设有一个 MyClass 类，它依赖于 MyService 类：

class MyClass
{
    private $myService;

    public function __construct(MyService $myService)
    {
        $this->myService = $myService;
    }

    public function doSomething(): string
    {
        return $this->myService->getData();
    }
}

MyService 类包含一个 getData 方法返回字符串 "foo"。为了测试 MyClass::doSomething 方法，可以使用 Mock 对象：

class MyClassTest extends PHPUnit_Framework_TestCase
{
    public function testDoSomething()
    {
        // 创建 MyService Mock 对象
        $mockService = $this->getMockBuilder(MyService::class)
                            ->setMethods(['getData'])
                            ->getMock();

        // 配置 Mock 对象返回 "bar"
        $mockService->method('getData')
                    ->willReturn('bar');

        // 创建 MyClass 实例并注入 Mock 对象
        $myClass = new MyClass($mockService);

        // 断言 MyClass::doSomething 返回 "bar"
        $this->assertEquals('bar', $myClass->doSomething());
    }
}

在此测试中，我们创建了 MyService 的 Mock 对象并设置其返回值为 "bar"。然后将该 Mock 对象注入 MyClass 实例，最后通过断言验证 MyClass 与 MyService 的交互是否正确。

通过使用 Mock 对象，开发者可以在单元测试中高效验证依赖关系和业务逻辑，而无需依赖实际服务或复杂环境。