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>