PHPUnit学习04---PHPUnit实用技巧收录

本文目的

本文目的是收录一些PHPUnit的有用技巧，这些技巧能够为给PHPUnit单元测试带来很多便利。本文将要介绍的技巧如下：

函数依赖测试

数据提供函数

异常测试

跳过忽略测试

自动生成测试框架

有时候，类中的函数有依赖，而且你的逻辑需要被依赖函数正确执行，此时，你可以通过phpunit的依赖标签显示的标明这种依赖关系，如果任意被依赖的函数执行失败，那么依赖函数将会被自动跳过。如下所示代码（dependenceDemo.cpp）：

<code>class</code> <code>DependanceDemo</code><code>extends</code> <code>PHPUnit_Framework_TestCase</code>

<code> </code><code>public</code> <code>function</code> <code>testOne()</code>

<code> </code><code>echo</code> <code>"testOne\n"</code><code>;</code>

<code> </code><code>$this</code><code>->assertTrue(TRUE);</code>

<code> </code><code>public</code> <code>function</code> <code>testTwo()</code>

<code> </code><code>echo</code> <code>"testTwo\n"</code><code>;</code>

<code> </code><code>$this</code><code>->assertTrue(FALSE);</code>

<code> </code><code>* @depends testOne</code>

<code> </code><code>* @depends testTwo</code>

<code> </code><code>public</code> <code>function</code> <code>testThree()</code>

上面的代码执行结果如下图：

可以看到，testThree依赖testOne和testTwo，但是testTwo失败，所以testThree被跳过，使用S表示。

@depends标签还可以依赖返回值。如下例子所示（paramDependence.php），

<code> </code><code>return</code> <code>"testOne"</code><code>;</code>

<code> </code><code>return</code> <code>"testTwo"</code><code>;</code>

<code> </code><code>public</code> <code>function</code> <code>testThree(</code><code>$param1</code><code>,</code><code>$param2</code><code>)</code>

<code> </code><code>echo</code> <code>'First param: '</code><code>.</code><code>$param1</code><code>.</code><code>"\n"</code><code>;</code>

<code> </code><code>echo</code> <code>'Second param: '</code><code>.</code><code>$param2</code><code>.</code><code>"\n"</code><code>;</code>

上面代码的执行结果如下：

值得注意的是，函数的顺序与依赖标签的数序一致。

函数一般会有多组不同的输入参数，如果每一组参数都写一个测试函数，那么写测试比较麻烦，如果能提供一种批量的参数输入方法，那么测试代码将会简洁许多。好在，phpunit提供@dataProvider标签，支持这种特性，看如下代码(dataProviderDemo.php):

<code>class</code> <code>DataTest</code><code>extends</code> <code>PHPUnit_Framework_TestCase</code>

<code> </code><code>* @dataProvider provider </code>

<code> </code><code>public</code> <code>function</code> <code>testAdd(</code><code>$a</code><code>,</code><code>$b</code><code>,</code><code>$c</code><code>) </code>

<code> </code><code>$this</code><code>->assertEquals(</code><code>$c</code><code>,</code><code>$a</code> <code>+</code><code>$b</code><code>);</code>

<code> </code><code>public</code> <code>function</code> <code>provider()</code>

<code> </code><code>return</code> <code>array</code><code>(</code>

<code> </code><code>array</code><code>(0, 0, 0),</code>

<code> </code><code>array</code><code>(0, 1, 1),</code>

<code> </code><code>array</code><code>(1, 1, 1),</code>

<code> </code><code>array</code><code>(1, 2, 3)</code>

上面的代码输出如下所示：

可以看到，函数testAdd遍历了函数provider的返回的结果，并将他们作为参数，被@dataProvider标记的函数的唯一要求就是返回数组。

PHPUnit提供三种方法测试异常，如下面代码所示（exceptionsDemo.php）：

<code>class</code> <code>ExceptionsDemo</code><code>extends</code> <code>PHPUnit_Framework_TestCase</code>

<code> </code><code>* @expectedException InvalidArgumentException</code>

<code> </code><code>public</code> <code>function</code> <code>testTagException()</code>

<code> </code><code>throw</code> <code>new</code> <code>InvalidArgumentException;</code>

<code> </code><code>public</code> <code>function</code> <code>testApiException()</code>

<code> </code><code>$this</code><code>->setExpectedException(</code><code>'InvalidArgumentException'</code><code>);</code>

<code> </code><code>public</code> <code>function</code> <code>testTryException()</code>

<code> </code><code>throw</code> <code>new</code> <code>InvalidArgumentException;</code>

<code> </code><code>catch</code> <code>(InvalidArgumentException</code><code>$expected</code><code>)</code>

<code> </code><code>return</code><code>; </code>

<code> </code><code>$this</code><code>->fail(</code><code>'An expected exception has not been raised.'</code><code>);</code>

当然，这三种方法各有用处，效果等同，使用时看需要而定。

在编写单元测试过程中，有时候只写出了测试方法名称，没有写具体的测试内容。这样，PHPUnit框架默认的认为此测试通过，这样，我们很可能忘记了该测试方法还没有实现，如果使用$this->fail()，只能表明该测试失败，但是该测试并没有失败，令人误解。所以，我们需要PHPUnit提供一组方法，使得可以跳过没有实现的测试，并且给与正确的提示。PHPUnit提供下面这四个方法，帮助我们办到这一点：

方法

意义

void markTestSkipped()

标记当前的测试被跳过，用“S”标记

void markTestSkipped(string $message)

标记当前的测试被跳过，用“S”标记，并且输出一段示消息

void markTestIncomplete

标记当前的测试不完全，用“I”标记

void markTestIncomplete(string $message)

标记当前的测试不完全，用“I”标记，并且输出一段提示消息

下面的代码演示了上面四个方法的使用（SIMarkDemo.php）：

<code>class</code> <code>SkipIncompleteMarkDemo</code><code>extends</code> <code>PHPUnit_Framework_TestCase</code>

<code> </code><code>public</code> <code>function</code> <code>testSkipped()</code>

<code> </code><code>$this</code><code>->markTestSkipped();</code>

<code> </code><code>public</code> <code>function</code> <code>testSkippedWithMessage()</code>

<code> </code><code>$this</code><code>->markTestSkipped(</code><code>"this is a skipped test."</code><code>);</code>

<code> </code><code>public</code> <code>function</code> <code>testIncomplete()</code>

<code> </code><code>$this</code><code>->markTestIncomplete();</code>

<code> </code><code>public</code> <code>function</code> <code>testIncompleteWithMessage()</code>

<code> </code><code>$this</code><code>->markTestIncomplete(</code><code>"this is a incomplete test."</code><code>);</code>

输出结果如下

在编写单元测试的时候，你会发现有些代码都是千篇一律的，比如testXXXX(){…..}，所以基于这种考虑，PHPUnit提供了生成测试框架的命令。该命令可以给为被测试的类中的每一个方法生成一个默认的测试方法，该方法使用markTestIncomplete标记。

如下图面的代码表示的类，

<code>class</code> <code>Calculator</code>

<code> </code><code>public</code> <code>function</code> <code>add(</code><code>$a</code><code>,</code><code>$b</code><code>)</code>

<code> </code><code>return</code> <code>$a</code> <code>+</code><code>$b</code><code>; </code>

<code> </code><code>public</code> <code>function</code> <code>minus(</code><code>$a</code><code>,</code><code>$b</code><code>)</code>

<code> </code><code>return</code> <code>$a</code> <code>-</code><code>$b</code><code>; </code>

使用如下命令：

将会生成一个类CalculatorTest.php，内容如下：

<code>require_once</code> <code>'PHPUnit/Framework.php'</code><code>;</code>

<code>require_once</code> <code>'/home/bourneli/test/UnitTestDemo/PHPUnitFeatures/Calculator.php'</code><code>;</code>

<code> </code><code>* Test class for Calculator.</code>

<code> </code><code>* Generated by PHPUnit on 2011-05-24 at 20:54:59.</code>

<code>class</code> <code>CalculatorTest</code><code>extends</code> <code>PHPUnit_Framework_TestCase</code>

<code> </code><code>* @var Calculator</code>

<code> </code><code>protected</code> <code>$object</code><code>;</code>

<code> </code><code>* Sets up the fixture, for example, opens a network connection.</code>

<code> </code><code>* This method is called before a test is executed.</code>

<code> </code><code>protected</code> <code>function</code> <code>setUp()</code>

<code> </code><code>$this</code><code>->object =</code><code>new</code> <code>Calculator;</code>

<code> </code><code>* Tears down the fixture, for example, closes a network connection.</code>

<code> </code><code>* This method is called after a test is executed.</code>

<code> </code><code>protected</code> <code>function</code> <code>tearDown()</code>

<code> </code><code>* @todo Implement testAdd().</code>

<code> </code><code>public</code> <code>function</code> <code>testAdd()</code>

<code> </code><code>// Remove the following lines when you implement this test.</code>

<code> </code><code>$this</code><code>->markTestIncomplete(</code>

<code> </code><code>'This test has not been implemented yet.'</code>

<code> </code><code>* @todo Implement testMinus().</code>

<code> </code><code>public</code> <code>function</code> <code>testMinus()</code>

可以看到，该框架还是比较完整的，生成了setUp，tearDown函数,还为每一个函数生成了一个测试方法。当然，phpunit还提供替他框架函数，如果想要了解更多，可以参见参考文档中的链接。

参考文档

本文转自bourneli博客园博客，原文链接：http://www.cnblogs.com/bourneli/archive/2012/09/08/2676978.html，如需转载请自行联系原作者

PHPUnit学习04---PHPUnit实用技巧收录

继续阅读

第三章 Joomla!扩展开发--后端开发（续2）

Centos 7 Apache配置虚拟主机

PHP进阶学习之session写入数据库

php写一个简洁的登录页面

Apache与PHP环境下配置本地虚拟主机

Testlink安装部署之XAMPP

TestLink 图表中文乱码问题

ecshop属性排序

Ubuntu16.04安装Apache+MySQL+PHP1. 安装Apache2. 安装MySQL3. 安装PHP4. 安装phpMyAdmin

版本号隐藏

Apache配置SSLApache配置SSL

配置apache支持PHP（win7）

Cloud Studio初体验

NOSQL安全攻击

php 去掉字符串的最后一个字符及截取原字符串1,2,3,4,5,6,

php——水印