首页 后端开发 php教程 PHP单元测试利器 PHPUNIT深入用法(三)_php技巧

PHP单元测试利器 PHPUNIT深入用法(三)_php技巧

May 17, 2016 am 09:21 AM

在本系列文章的前两篇中PHP单元测试利器:PHPUNIT初探和PHP单元测试利器:PHPUNIT深入用法(二)中,分别介绍了phpunit的基本用法和phpunit中的一些重要用法。

在本文中,笔者将为大家介绍phpunit中的两个高级概念和用法,尽管它不一定在你的日常单元测试中都用到,但理解和学会它们的用法对学习phpunit还是十分重要的。

  Phpunit中的Annotations

  如果有其他编程语言经验的开发者,应该对Annotations(注解)不陌生,其实在phpunit中,一个简单的如下面的一段注释也可以认为是Annotations:

<?
php
class
 MyTestClass 
extends
 PHPUnit_Framework_TestCase
{
/*
*
* Testing the answer to “do you love unit tests?”
*/
public
 
function
 testDoYouLoveUnitTests()
{
$love
 
=
 
true
;
$this
->
assertTrue(
$love
);
}
}
?>
登录后复制


  可以看到,其实一段以/** **/为标记的文字,就可以认为是一种Annotations,但Annotations其实不单单是简单的注释,它是与一个程序元素相关联信息或者元数据的标注,它不影响程序的运行,但相关的软件工具或框架能够将其转换成特殊的元数据标记,以方便开发者以更少的代码去提高效率(比如通过。如果你熟悉Java,则会发现在Java SE 5中及象Spring等框架中,都大量使用了Annotations。

  然而,由于php并不象Java那样是编译性语言,因此本身缺乏去解析Annotations的机制,但幸好phpunit去提供了这样的功能,我们以下面的代码为例:

<?
php
class
 MyMathClass
{
/*
*
* Add two given values together and return sum
*/
public
 
function
 addValues(
$a
,
$b
)
{
return
 
$a
+
$b
;
}
}
?>
登录后复制


  上面的只是一个简单的加法的例子,为此,我们使用Annotations去编写一个单元测试,在上两篇文章中,我们采用的是手工编写单元测试的方法,而本文中,将介绍使用phpunit命令行的方法,自动生成单元测试的框架,方法如下:

  首先把上面的类保存为MyMathClass.php,然后在命令行下运行如下命令:

phpunit –skeleton-test MyMathClass
登录后复制

  这时phpunit会自动生成如下的框架单元测试代码:

<?
php
require_once
 
&#39;
/path/to/MyMathClass.php
&#39;
;
/*
*
* Test class for MyMathClass.
* Generated by PHPUnit on 2011-02-07 at 12:22:07.
*/
class
 MyMathClassTest 
extends
 PHPUnit_Framework_TestCase
{
/*
*
* @var MyMathClass
*/
protected
 
$object
;
/*
*
* Sets up the fixture, for example, opens a network connection.
* This method is called before a test is executed.
*/
protected
 
function
 setUp()
{
$this
->
object
 
=
 
new
 MyMathClass;
}
/*
*
* Tears down the fixture, for example, closes a network connection.
* This method is called after a test is executed.
*/
protected
 
function
 tearDown()
{
}
/*
*
* @todo Implement testAddValues().
*/
public
 
function
 testAddValues()
{
//
 Remove the following lines when you implement this test.
$this
->
markTestIncomplete(
&#39;
This test has not been implemented yet.
&#39;
);
}
}
?>
登录后复制

  可以看到,phpunit为我们生成的单元测试代码自动引入了原来的MyMathClass.php,同时也生成了setUp和tearDown方法,但唯一的核心单元测试代码是留给了我们编写。如果想在这个基础上更快速的生成我们想要的单元测试代码,要如何实现呢?没错,就是使用annotations!我们可以在原来的MyMathClass.php中加入如下的annotations。

<?
php
class
 MyMathClass
{
/*
*
* Add two given values together and return sum
* @assert (1,2) == 3
*/
public
 
function
 addValues(
$a
,
$b
)
{
return
 
$a
+
$b
;
}
}
?>
登录后复制

  然后再象上述一样在命令行运行:

  phpunit –skeleton-test MyMathClass
登录后复制

  这个时候会为我们生成如下的单元测试代码:

<?
php
/*
*
* Generated from @assert (1,2) == 3.
*/
public
 
function
 testAddValues()
{
$this
->
assertEquals(
3
,
$this
->
object
->
addValues(
1
,
2
)
);
}
?>
登录后复制

看到了么?我们在原有的类中加入了注解@assert(1,2)==3,则phpunit自动为我们生成了正确的单元测试代码。当然,可以参考phpunit手册,学习到更多的关于@assert注解使用的规则。

  下面再举一个例子来讲解annotations。假设我们的程序中的一个方法,只是仅需要数据的输入,并且不依赖XML或者数据库提供数据源,则为了测试这个方法,我们可能想到的一个方法是在程序中设置一个测试数据集去测试,但这里介绍一个比较简单的方法,就是使用注解@dataProvider,修改MyMathClass.php如下:

<?
php
/*
*
* Data provider for test methods below
*/
public
 
static
 
function
 provider()
{
return
 
array
(
array
(
1
,
2
,
3
)
,
array
(
4
,
2
,
6
)
,
array
(
1
,
5
,
7
)
);
}
/*
*
* Testing addValues returns sum of two values
* @dataProvider provider
*/
public
 
function
 testAddValues(
$a
,
$b
,
$sum
)
{
$this
->
assertEquals(
$sum
,
$this
->
object
->
addValues(
$a
,
$b
)
);
}
?>
登录后复制

  可以看到,这里使用了注解@dataProvider,指明了测试用例的数据提供者是由provider方法返回的一个数组。所以在单元测试时,数组中的第0个元素则会赋值给$a,第1个元素则会赋值给b,第3个元素则会赋值给sum,可以看到,上面的第3个数组提供的数据是不能通过单元测试的,因为1+5不等于7。

  此外,这里还简单介绍两个常用的annotations,比如@expectedException注解可以测试代码中是否正确抛出了异常,比如:

<?
phprequire_once 
&#39;
PHPUnit/Framework.php
&#39;
; 
class
 ExceptionTest 
extends
 PHPUnit_Framework_TestCase{    
/*
*  
   * @expectedException InvalidArgumentException     
*/
    
public
 
function
 testException()    {  
  }
}
?>
登录后复制

 这里就用注解的方法表示testException中必须抛出的异常类型为InvalidArgumentException。

  另外一个是@cover注解。它的作用是标识phpunit只为类中的哪些方法或作用域生成测试代码,比如:

/*
*
     * @covers SampleClass::publicMethod
     * @covers SampleClass::<!public>
     * @covers HelperClass<extended>
     
*/
    
public
 
function
 testMethod()
    {
        
$result
 
=
 SampleClass
::
method();
}
登录后复制

  则phpunit只为SampleClass类中的publicMethod方法、SampleClass类中的所有非public声明的方法和HelperClass类或者它的其中一个父类产生单元测试代码。

Phpunit中的Mocking

  在介绍Mocking前,先来看下为什么要使用Mocking。举一个数据库查询的例子,比如在某个应用中,如果要测试一个数据库的应用,但假如这个数据库的测试要耗费很多资源以及编写很复杂的单元测试的代码的话,可以尝试使用Mocking技术。举例说明如下:


<?
php
class
 Database
{
public
 
function
 reallyLongTime()
{
$results
 
=
 
array
(
array
(
1
,
&#39;
test
&#39;
,
&#39;
foo value
&#39;
)
);
sleep
(
100
);
return
 
$results
;
}
}
?>
登录后复制

在上面这个例子中,我们模拟了一个数据库的操作,认为它需要运行很长时间。接下来我们编写其单元测试代码如下:

<?
php
require_once
 
&#39;
/path/to/Database.php
&#39;
;
class
 DatabaseTest 
extends
 PHPUnit_Framework_TestCase
{
private
 
$db
 
=
 
null
;
public
 
function
 setUp()
{
$this
->
db 
=
 
new
 Database();
}
public
 
function
 tearDown()
{
unset
(
$this
->
db);
}
/*
*
* Test that the "really long query" always returns values
*/
public
 
function
 testReallyLongReturn()
{
$mock
 
=
 
$this
->
getMock(
&#39;
Database
&#39;
);
$result
 
=
 
array
(
array
(
1
,
&#39;
foo
&#39;
,
&#39;
bar test
&#39;
)
);
$mock
->
expects(
$this
->
any())
->
method(
&#39;
reallyLongTime
&#39;
)
->
will(
$this
->
returnValue(
$result
));
$return
 
=
 
$mock
->
reallyLongTime();
$this
->
assertGreaterThan(
0
,
count
(
$return
));
}
}
?>
登录后复制

  注意看这段代码中有趣的地方,这里,使用了phpunit中的getMock对象方法,这里实际上是模拟生成一个Database类的“伪实例”了,这里生成了$mock这个mock对象实例,以方便接着的单元测试中用到。接下来的这三行代码

$mock
->
expects(
$this
->
any())
->
method(
&#39;
reallyLongTime
&#39;
)
->
will(
$this
->
returnValue(
$result
));
登录后复制


  它们的含义为:无论方法reallyLongtime执行了多长时间,始终最后会直接返回$result这个数组的结果。这样,你就可以通过mocking技术很轻易地去实现在单元测试中,绕过某些复杂的逻辑部分,而节省大量的宝贵时间提高测试效率。

  下面的这个例子,讲解的是Mocking技术中的更高级用法Mockbuilder。依然以上面的例子说明:

<?
php
public
 
function
 testReallyLongRunBuilder()
{
$stub
 
=
 
$this
->
getMockBuilder(
&#39;
Database
&#39;
)
->
setMethods(
array
(
&#39;
reallyLongTime
&#39;
))
->
disableAutoload()
->
disableOriginalConstructor()
->
getMock();
$result
 
=
 
array
(
array
(
1
,
&#39;
foo
&#39;
,
&#39;
bar test
&#39;
));
$stub
->
expects(
$this
->
any())
->
method(
&#39;
reallyLongTime
&#39;
)
->
will(
$this
->
returnValue(
$result
));
$this
->
assertGreaterThan(
0
,
count
(
$return
));
}
?>
登录后复制

  通过使用Mockbuilder,我们可以不用通过构造函数的方法去初始化一个mock对象。这段代码跟上一段代码的功能其实是一样的,只不过留意一下新的两个方法: disableAutoload和disableOriginalConstructor,其功能分别是禁止使用php的内置的autoload初始构造方法和禁止调用该类原有的构造函数。最后再看一个例子:

<?
php
/*
*
* Testing enforcing the type to "array" like the "enforceTypes"
* method does via type hinting
*/
public
 
function
 ttestReallyLongRunBuilderConstraint()
{
$stub
 
=
 
$this
->
getMock(
&#39;
Database
&#39;
,
array
(
&#39;
reallyLongTime
&#39;
));
$stub
->
expects(
$this
->
any())
->
method(
&#39;
reallyLongTime
&#39;
)
->
with(
$this
->
isType(
&#39;
array
&#39;
));
$arr
 
=
 
array
(
&#39;
test
&#39;
);
$this
->
assertTrue(
$stub
->
 reallyLongTime (
$arr
));
}
?>
登录后复制

  在这里,我们使用了with方法,其中这个方法中指定了要传入的参数类型为array数组类型,最后这个断言是通过了,因为返回的的确是数组类型。

 以上就是PHP单元测试利器 PHPUNIT深入用法(三)_php技巧的内容,更多相关内容请关注PHP中文网(www.php.cn)!


本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover

AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool

Undress AI Tool

免费脱衣服图片

Clothoff.io

Clothoff.io

AI脱衣机

Video Face Swap

Video Face Swap

使用我们完全免费的人工智能换脸工具轻松在任何视频中换脸!

热工具

记事本++7.3.1

记事本++7.3.1

好用且免费的代码编辑器

SublimeText3汉化版

SublimeText3汉化版

中文版,非常好用

禅工作室 13.0.1

禅工作室 13.0.1

功能强大的PHP集成开发环境

Dreamweaver CS6

Dreamweaver CS6

视觉化网页开发工具

SublimeText3 Mac版

SublimeText3 Mac版

神级代码编辑软件(SublimeText3)

适用于 Ubuntu 和 Debian 的 PHP 8.4 安装和升级指南 适用于 Ubuntu 和 Debian 的 PHP 8.4 安装和升级指南 Dec 24, 2024 pm 04:42 PM

PHP 8.4 带来了多项新功能、安全性改进和性能改进,同时弃用和删除了大量功能。 本指南介绍了如何在 Ubuntu、Debian 或其衍生版本上安装 PHP 8.4 或升级到 PHP 8.4

我后悔之前不知道的 7 个 PHP 函数 我后悔之前不知道的 7 个 PHP 函数 Nov 13, 2024 am 09:42 AM

如果您是一位经验丰富的 PHP 开发人员,您可能会感觉您已经在那里并且已经完成了。您已经开发了大量的应用程序,调试了数百万行代码,并调整了一堆脚本来实现操作

如何设置 Visual Studio Code (VS Code) 进行 PHP 开发 如何设置 Visual Studio Code (VS Code) 进行 PHP 开发 Dec 20, 2024 am 11:31 AM

Visual Studio Code,也称为 VS Code,是一个免费的源代码编辑器 - 或集成开发环境 (IDE) - 可用于所有主要操作系统。 VS Code 拥有针对多种编程语言的大量扩展,可以轻松编写

在PHP API中说明JSON Web令牌(JWT)及其用例。 在PHP API中说明JSON Web令牌(JWT)及其用例。 Apr 05, 2025 am 12:04 AM

JWT是一种基于JSON的开放标准,用于在各方之间安全地传输信息,主要用于身份验证和信息交换。1.JWT由Header、Payload和Signature三部分组成。2.JWT的工作原理包括生成JWT、验证JWT和解析Payload三个步骤。3.在PHP中使用JWT进行身份验证时,可以生成和验证JWT,并在高级用法中包含用户角色和权限信息。4.常见错误包括签名验证失败、令牌过期和Payload过大,调试技巧包括使用调试工具和日志记录。5.性能优化和最佳实践包括使用合适的签名算法、合理设置有效期、

您如何在PHP中解析和处理HTML/XML? 您如何在PHP中解析和处理HTML/XML? Feb 07, 2025 am 11:57 AM

本教程演示了如何使用PHP有效地处理XML文档。 XML(可扩展的标记语言)是一种用于人类可读性和机器解析的多功能文本标记语言。它通常用于数据存储

php程序在字符串中计数元音 php程序在字符串中计数元音 Feb 07, 2025 pm 12:12 PM

字符串是由字符组成的序列,包括字母、数字和符号。本教程将学习如何使用不同的方法在PHP中计算给定字符串中元音的数量。英语中的元音是a、e、i、o、u,它们可以是大写或小写。 什么是元音? 元音是代表特定语音的字母字符。英语中共有五个元音,包括大写和小写: a, e, i, o, u 示例 1 输入:字符串 = "Tutorialspoint" 输出:6 解释 字符串 "Tutorialspoint" 中的元音是 u、o、i、a、o、i。总共有 6 个元

解释PHP中的晚期静态绑定(静态::)。 解释PHP中的晚期静态绑定(静态::)。 Apr 03, 2025 am 12:04 AM

静态绑定(static::)在PHP中实现晚期静态绑定(LSB),允许在静态上下文中引用调用类而非定义类。1)解析过程在运行时进行,2)在继承关系中向上查找调用类,3)可能带来性能开销。

什么是PHP魔术方法(__ -construct,__destruct,__call,__get,__ set等)并提供用例? 什么是PHP魔术方法(__ -construct,__destruct,__call,__get,__ set等)并提供用例? Apr 03, 2025 am 12:03 AM

PHP的魔法方法有哪些?PHP的魔法方法包括:1.\_\_construct,用于初始化对象;2.\_\_destruct,用于清理资源;3.\_\_call,处理不存在的方法调用;4.\_\_get,实现动态属性访问;5.\_\_set,实现动态属性设置。这些方法在特定情况下自动调用,提升代码的灵活性和效率。

See all articles