php单元测试进阶（14）- 核心技术 - 动态mock对象

php单元测试进阶（14）- 核心技术 - 动态mock对象

本系列文章主要代码与文字来源于《单元测试的艺术》，原作者：Roy Osherove。译者：金迎。

本系列文章根据php的语法与使用习惯做了改编。所有代码在本机测试通过。如转载请注明出处。

使用手工mock对象的方法可能会遇到问题，包括：

    编写mock对象和桩件需要花费时间。
    如果类和接口有许多方法，属性和事件，就很难为它编写桩件和mock对象。
    难以在其他测试中重用mock类和桩件类。一旦接口有超过两三个方法需要实现，代码维护会很麻烦。
    要保存mock对象被多次调用的状态，需要手工实现。
    尽管如此，学习手工创建mock对象可以更清楚的学习单元测试的原理，同时，手工编写的mock对象和桩件的代码是更加易读的，并且也确实可以使用。
    决定何时用手工创建mock对象，何时用本节介绍的动态mock对象，也是一种艺术。

动态伪对象

动态伪对象是在运行时创建的任何桩件或mock对象，它的创建不需要先硬编码一个类。
动态mock对象的框架

最常用的有两个，一个是PHPUnit_MockObject，这是phpunit自带的默认的mock框架。
另一个是Prophecy，其原本是另一个单元测试框架phpspec的mock类库，但因为很优秀，可以独立使用，可以被内嵌到phpunit当中，并且默认已经有了，无需额外安装。
使用任意一个都可以。本文分别使用一下。

为了学习动态mock，我们需要再仔细读一遍php单元测试进阶（12）- 核心技术 - mock对象。只是我们现在改成动态mock实现。

源代码中，被测类不变，接口也不变。
测试代码中，去除手工mock类文件（少写一个文件！），然后修改测试类如下
测试代码（PHPUnit_MockObject实现）

LogAnalyzerTest.php

<?php
namespace tests\index\controller;
/**
 * 测试用的类
 */
class LogAnalyzerTest extends \think\testing\TestCase
{

    /**
     * @test
     * 使用动态mock对象断言，注意：断言代码是写在前面的！！
     * 注意，尽量使得测试的方法名称有意义，这非常重要，便于维护测试代码。有规律
     */
    public function analyze_TooShortFileName_CallsWebService()
    {
        $tooShortFileName= 'abc.ext';

        // 为 IWebService 接口建立mock对象，只模仿 logError() 方法。
        $mockService = $this->getMockBuilder('\app\index\controller\IWebService')
                            ->getMock();

        // 现在开始断言：预期该mock对象的 logError() 方法将会被调用一次，
        // 并且将以字符串 "Filename too short:{$tooShortFileName}" 为参数。
        $mockService->expects($this->once())
                    ->method('logError')
                     ->with($this->equalTo("Filename too short:{$tooShortFileName}"));

        // 创建被测类的对象，注入mock对象
        $analyzer = new \app\index\controller\LogAnalyzer($mockService);
        //调用被测对象，等待断言发生。
        $analyzer->analyze($tooShortFileName);
    }
}

cmd下测试通过。
测试代码（Prophecy实现）

LogAnalyzerTest.php

<?php
namespace tests\index\controller;
/**
 * 测试用的类
 */
class LogAnalyzerTest extends \think\testing\TestCase
{

    /**
     * @test
     * 使用动态mock对象断言，注意：断言代码是写在前面的！！
     * 注意，尽量使得测试的方法名称有意义，这非常重要，便于维护测试代码。有规律
     */
    public function analyze_TooShortFileName_CallsWebService()
    {
        $tooShortFileName= 'abc.ext';

        // 为 IWebService 接口建立预言(prophecy)。
        $mockService = $this->prophesize('\app\index\controller\IWebService');

        // 现在开始断言：预期用该mock类生成的对象的 logError() 方法将会被调用一次，
        // 并且将以字符串 "Filename too short:{$tooShortFileName}" 为参数。
        $mockService->logError("Filename too short:{$tooShortFileName}")->shouldBeCalled();

        // 创建被测类的对象，注入mock对象，注意，对象是这里生成，但断言在上面
        $analyzer = new \app\index\controller\LogAnalyzer($mockService->reveal());
        //调用被测对象，等待断言发生。
        $analyzer->analyze($tooShortFileName);
    }
}

cmd下测试也通过。其实也能发现用Prophecy做动态mock代码很简洁。
现在可以不手工写mock了！

本系列文章结束。

上一篇：php单元测试进阶（13）- 核心技术 - mock对象 - 同时使用mock和stub