php单元测试进阶（2）-入门

php单元测试进阶（2）-入门

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

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

首先清空tests目录下所有文件，其实就2个。

假设有一个项目，用于分析日志文件，在其中搜索特定的情况和事件，找到后，自动通知相关的人员。
先做一个最简单的类和方法，测试方法名是否有效。如下。

在t2\application\index\controller下建文件LogAnalyzer.php

<?php
namespace app\index\controller;

/**
 * 日志分析器类，也是被测类
 *
 */
class LogAnalyzer
{
    /**
     * 判断文件名是否有效，.slf结尾的文件名就是有效的，返回真
     * @param string $filename
     */
    public function isValidLogFileName($filename)
    {
        if (preg_match('/\.SLF$/', $filename)){
            return false;
        }
        return true;
    }
}

请注意上面的代码，故意写错了，在if后面漏了一个!运算符。
现在我们来做单元测试。

在t2\tests\index\controller\下建立LogAnalyzerTest.php，内容如下

<?php
namespace tests\index\controller;

class LogAnalyzerTest extends \think\testing\TestCase
{

    /**
     * @test
     * 注意，尽量使得测试的方法名称有意义，这非常重要，便于维护测试代码。有规律
     */
    public function isValidFileName_BadExtension_RetrunFalse()
    {
        $analyzer = new \app\index\controller\LogAnalyzer();
        $result = $analyzer->isValidLogFileName("file_with_bad_extension.foo");
        $this->assertFalse($result);
    }
}

建议的测试方法名称规范：

[UnitOfWorkName]_[ScenarioUnderTest]_[ExpectedBehavior]

UnitOfWorkName：工作单元名，既可以对应于被测类的一个方法，也可能对应于被测项目的多个类或方法。前者可以直接引用原方法名，后者可以象UserLogin，RemoveUser或Startup等。一个工作单元，至少应该有一个测试方法。
ScenarioUnderTest：发生什么状况，当事情怎样的时候，指定什么条件，例如“登入失败”，“无效用户”，“密码正确”等
ExpectedBehavior：在测试场景指定条件下，你对被测方法行为的预期。

对于上面的被测类的测试文件名是否正确的那个方法，我们的测试方法可以命名为 isValidFileName_BadExtension_RetrunFalse。
一个单元测试通常包含3个步骤

（1）准备对象，创建对象，进行必要的设置，也包括建立初始数据。
（2）操作对象
（3）断言某件事情符合预期

cmd窗口下，在t2目录下，执行php think unit
看到测试未通过，因为我们的源代码错了，
修改后的代码应该如下所示

if (!preg_match('/\.SLF$/', $filename)){
    return false;
}

现在测试通过了，在我的电脑，显示如下

D:\workspace\t2>php think unit
PHPUnit 4.8.35 by Sebastian Bergmann and contributors.

.

Time: 398 ms, Memory: 4.00MB

OK (1 test, 1 assertion)

D:\workspace\t2>

上一篇：php单元测试进阶（1）-安装
下一篇：php单元测试进阶（3）- 入门 - 添加检验