PHPUnit断言详情

最新推荐文章于 2022-01-20 15:55:34 发布
最新推荐文章于 2022-01-20 15:55:34 发布
阅读量147 收藏
点赞数
文章标签： php
原文链接：http://www.cnblogs.com/duzhonglin/p/6000843.html
版权

在PHPUnit中，断言(Assertions)是其提供的一系列对程序执行结果测试的方法：

assertArrayHasKey(mixed $key, array $array[, string $message = '']) 
断言数组$array含有索引$key, $message用于自定义输出的错误信息,后同

assertClassHasAttribute(string $attributeName, string $className[, string $message = '']) 
断言类$className含有属性$attributeName

assertClassHasStaticAttribute(string $attributeName, string $className[, string $message = '']) 
断言类$className含有静态属性$attributeName

assertContains(mixed $needle, Iterator|array $haystack[, string $message = '']) 
断言迭代器对象$haystack/数组$haystack含有$needle

assertNotContains() 
与上条相反

assertAttributeContains(mixed $needle, Class|Object $haystack[, string $message = '']) 
断言$needle为一个类/对象$haystack可访问到的属性(public, protected 和 private)

assertAttributeNotContains() 
与上条相反

assertContains(string $needle, string $haystack[, string $message = '']) 
断言字符串$needle在字符串$haystack中

assertContainsOnly(string $type, Iterator|array $haystack[, boolean $isNativeType = NULL, string $message = '']) 
断言迭代器对象/数组$haystack中只有$type类型的值, $isNativeType 设定为PHP原生类型，$message同上

assertNotContainsOnly() 
与上条相反

assertAttributeContainsOnly() 和 assertAttributeNotContainsOnly() 
断言对象的属性只有$type类型和非含有$type类型

assertEmpty(mixed $actual[, string $message = '']) 
断言$actual为空

assertNotEmpty() 
遇上条相反

assertAttributeEmpty() 和 assertAttributeNotEmpty() 
断言对象的所有属性为空或不为空

assertEqualXMLStructure(DOMNode $expectedNode, DOMNode $actualNode[, boolean $checkAttributes = FALSE, string $message = '']) 
断言Dom节点$actualNode和DOM节点$expectedNode相同，$checkAttributes FALSE 不断言节点属性，TRUE则断言属性$message同上

assertEquals(mixed $expected, mixed $actual[, string $message = '']) 
断言复合类型$actual与$expected相同

assertNotEquals() 
与上条相反

assertAttributeEquals() and assertAttributeNotEquals() 
断言类属性$actual与$expected相同

assertEquals(array $expected, array $actual[, string $message = '']) 
断言数组$actual和数组$expected相同

assertFalse(bool $condition[, string $message = '']) 
断言$condition的结果为false

assertFileEquals(string $expected, string $actual[, string $message = '']) 
断言文件$actual和$expected相同

assertFileExists(string $filename[, string $message = '']) 
断言文件$filename存在

assertFileNotExists() 
与上条相反

assertGreaterThan(mixed $expected, mixed $actual[, string $message = '']) 
断言$actual比$expected大

assertAttributeGreaterThan() 
断言类的属性用

assertGreaterThanOrEqual(mixed $expected, mixed $actual[, string $message = '']) 
断言$actual大于等于$expected

assertAttributeGreaterThanOrEqual() 
断言类的属性

assertInstanceOf($expected, $actual[, $message = '']) 
断言$actual为$expected的实例

assertNotInstanceOf() 
与上相反

assertAttributeInstanceOf() and assertAttributeNotInstanceOf() 
断言类属性用

assertInternalType($expected, $actual[, $message = '']) 
断言$actual的类型为$expected

assertNotInternalType() 
与上相反

assertAttributeInternalType() and assertAttributeNotInternalType() 
断言类属性用

assertLessThan(mixed $expected, mixed $actual[, string $message = '']) 
断言$actual小于$expected

assertAttributeLessThan() 
断言类属性小于$expected

assertLessThanOrEqual(mixed $expected, mixed $actual[, string $message = '']) 
断言$actual小于等于$expected

assertAttributeLessThanOrEqual() 
断言类属性小于等于$expected

assertNull(mixed $variable[, string $message = '']) 
断言$variable的值为null

assertNotNull() 
与上条相反

assertObjectHasAttribute(string $attributeName, object $object[, string $message = '']) 
断言$object含有属性$attributeName

assertObjectNotHasAttribute() 
与上条相反

assertRegExp(string $pattern, string $string[, string $message = '']) 
断言字符串$string符合正则表达式$pattern

assertNotRegExp() 
与上条相反

assertStringMatchesFormat(string $format, string $string[, string $message = '']) 
断言$string符合$format定义的格式，例如 %i %s等等

assertStringNotMatchesFormat() 
与上条相反

assertStringMatchesFormatFile(string $formatFile, string $string[, string $message = '']) 
断言$string路径的文件的格式和$formatFile文件的格式相同

assertStringNotMatchesFormatFile() 
与上条相反

assertSame(mixed $expected, mixed $actual[, string $message = '']) 
断言$actual和$expected的类型和值相同

assertNotSame() 
与上条相反

assertAttributeSame() and assertAttributeNotSame() 
断言类属性用

assertSame(object $expected, object $actual[, string $message = '']) 
断言对象$actual和对象$expected相同

assertSelectCount(array $selector, integer $count, mixed $actual[, string $message = '', boolean $isHtml = TRUE]) 
断言在$actual文档中（格式为html或xml）css选择器$selector有$count个，或有符合$selector的元素（设定$count为true），或没有符合$selector的元素（设定$count为false）
assertSelectCount("#binder", true, $xml);  // 有一个就行
assertSelectCount(".binder", 3, $xml);     // 必须有3个?

assertSelectEquals(array $selector, string $content, integer $count, mixed $actual[, string $message = '', boolean $isHtml = TRUE]) 
断言在文档$actual中有符合根据$selector的找到符合$content的$count个元素，当$count等于true和false的时候作用如下：
assertSelectEquals("#binder .name", "Chuck", true,  $xml);  // 所有的name等于Chuck
assertSelectEquals("#binder .name", "Chuck", false, $xml);  // 所有的name不等于Chuck

assertSelectRegExp(array $selector, string $pattern, integer $count, mixed $actual[, string $message = '', boolean $isHtml = TRUE])

assertStringEndsWith(string $suffix, string $string[, string $message = '']) 
断言$string的末尾为$suffix结束

assertStringEndsNotWith() 
与上条相反

assertStringEqualsFile(string $expectedFile, string $actualString[, string $message = ''])
断言$actualString在文件$expectedFile的内容中

assertStringNotEqualsFile() 
与上条相反

assertStringStartsWith(string $prefix, string $string[, string $message = '']) 
断言$string的开头为$suffix

assertStringStartsNotWith() 
与上条相反
assertTag(array $matcher, string $actual[, string $message = '', boolean $isHtml = TRUE]) 

断言$actual的内容符合$matcher的定义，matcher的定义如下：
1、 id: 节点必须带有id属性且名称与id设定的相同
2、tags: 节点的名称必须与tags的值匹配
3、attributes: 节点的属性必须与$attributes数组中的值相匹配
4、content: 文本内容必须与$content的值相同.
5、parent: 节点的父节点必须符合$parent数组中定义的内容.
6、child: 节点的字节点中有至少一个直系子节点满足 $child 数组中定义的内容. 
7、ancestor: 节点的父节点中有至少一个节点满足 $ancestor 数组中定义的内容.
8、descendant: 节点的字节点中有至少一个子节点满足 $descendant 数组中定义的内容. 
9、children: 用于计算字节点的联合数组 
10、count: 符合匹配标准的字节点数目需要和count的值相同 
11、less_than: 符合匹配标准的字节点数目需要比count的值少 
12、greater_than: 符合匹配标准的字节点数目需要比count的值多 
13、 only: 另外一个联合数组用于定义配合标准的节点，只有这些节点才会被计算入内 
Another associative array consisting of the keys to use to match on the children, and only matching children will be counted

assertTag的代码例子（图片点击放大）：


More complex assertions can be formulated using the PHPUnit_Framework_Constraint classes
更加复杂的断言可以通过PHPUnit_Framework_Constraint类来制定


    
 
测试方法进阶
 
在上篇文章中，介绍了实现一个基本的PHPUnit测试类的方法，今天在基本测试类的基础上，再来介绍测试方法的进阶功能。
 测试方法间的依赖关系
PHPUnit可以实现测试方法的依赖关系，也就是说，一个测试方法的参数的内容和是否会运行依赖于另外一个测试方法结果，依赖关系通过注释@depends来定义.这个特性一般用于检查代码的逻辑过程,一个逻辑的执行前提是另外一个逻辑的执行结果。

例子: 
在上面的测试类StackTest中,定义了2个依赖测试方法,testPush依赖于testEmpty, testPop依赖于testPush。

那么在测试运行时,testEmpty中的断言执行完毕也没有出现问题时,方法中的return语句会将 $stack传给依赖于它的testPush,作为testPush的参数传入到testPush中,testPush执行完毕之后,也会将$stack传给依赖于它的testPop,只要断言检查没有出现异常,那么PHPUnit就会根据依赖关系依次执行依赖的测试方法,直到依赖关系结束为止。

另外,为了方便快速的确定问题的所在,如果某个测试方法依赖的方法测试没有功过,那么PHPUnit会自动跳过后面所有的依赖测试。

例子: 

 testOne中断言为True,但是传入的是false,testOne的测试不会通过,那么依赖于testOne的testTwo也会被自动跳过.

 数据提供者(Data Providers)

 在前面的例子我们可以看到:测试方法是可以有参数的,在依赖关系中参数的值是它依赖的测试方法传入.那么某个测试方法没有依赖的方法,我们怎么给它传入参数做测试呢?PHPUnit给我们提供了数据提供者方法来为测试方法传入数据.

 数据提供者方法需要定义在当前的测试类中,在测试方法的注释中使用@dataProvider标签标注给它提供数据的方法名,定义之后PHPUnit会自动的将数据提供者方法返回的数据依次传入到测试方法中测试.

 数据提供者相当于都取大量数据测试时的封装

 代码:

 

 在上面的代码中,方法add_provider就是测试方法testAdd的数据提供者方法,它会依次给testAdd传入4组测试数据,testAdd会测试4次.

 注意：数据提供者方法返回数据的格式: 需要返回的是2维数组,第二维数组值的位置,对应测试方法参数的位置,参数个数和数组长度要相等,否则PHPUnit会报错,下面是个用于理解的简单的例子:
 

代码示例:
return array(
     array(参数1,参数2,参数3,参数4,参数N),
     array(参数1,参数2,参数3,参数4,参数N),
);

除了数组外,PHPUnit还支持数据提供者方法返回迭代器对象,迭代器的介绍估计大部分PHPer比较陌生,详细的介绍可以去http://php.net/manual/en/class.iterator.php 查看。

来看代码(点击图片放大察看):

 

 和前一个例子实现的测试内容相同,但是数据提供者返回的是一个迭代器对象而不是是数组

 数据提供者方法和依赖关系的限制
当一个测试方法依赖于另外一个使用data providers测试方法时，这个测试方法将会在它依赖的方法至少测试成功一次后运行,同时使用data providers的测试方法的执行的结果不能传入一个依赖它的测试方法中.这个解释来自官方的文档,理解起来可能有点难,我们通过代码来描述下这个限制:

 

上面代码例子中:

 情况1: add_provider提供的数据至少有一对数据相等

 testC会执行一次, 因为testC是依赖于testB的, 但是testB使用了数据提供者方法,那么testC中是无法收到testB return的值的

 情况2: add_provider提供的数据没有一对数据相等

 testC永远不会执行

 测试异常

 有时需要测试某些情况下代码是否按照要求抛出了相关的异常。
在PHPUnit中，有3种方式来检查异常是否抛出。
方法一: 注释法, 用@expectedException 标定期待的异常
 

代码示例:
/**
 * @expectedException InvalidArgumentException
 */ 
public function testException()
{
}

方法二: 设定法，使用 $this->setExpectedException 设定期待的异常
 

代码示例:
public function testException()
{
    $this->setExpectedException('InvalidArgumentException');
}

方法三: try catch + fail法
 

代码示例:
public function testException() {
    try {
        // 这里写上会引发异常的代码 
    } catch (InvalidArgumentException $expected) {
        // 抓到异常测试通过 
        return ;
    }

    // 没抓到异常就算失败 
    $this->fail('An expected exception has not been raised.' );
}

测试PHP错误

有时，代码在运行时会出现php错误，如整除0，文件不存在等等.在PHPUnit中，它会自动把错误转换为异常PHPUnit_Framework_Error并抛出,我们只需要在测试方法中设定抓取这个异常即可:

代码示例:
/**
 * @expectedException PHPUnit_Framework_Error // 期待PHPUnit_Framework_Error的异常
 */ 
public function testFailingInclude()
{
    // include一个不存在的文件，就会抛出一个PHPUnit_Framework_Error的异常 
    include 'not_existing_file.php';
}

转载于:https://www.cnblogs.com/duzhonglin/p/6000843.html

weixin_30614109
关注
PhpStorm 使用 PHPUnit 进行 单元测试、断言测试 详解
qq_28316065的博客
07-30 1342
一、PHPUnit简介 PHPUnit是一个面向PHP程序员的测试框架，这是一个xUnit的体系结构的单元测试框架。 参考官方文档地址：PHPUnit文档 - PHP测试框架 phpunit.phar下载地址：https://phar.phpunit.de/，与PHP版本兼容性如下：（下载对应的兼容版本即可） 用 PHPUnit 编写测试的基本惯例与步骤： 针对类Class的测试写在类ClassTest中。 ClassTest（通常）继承自PHPUnit\Framewor...
PHPUnit学习笔记(四)断言详解
weixin_34304013的博客
05-11 245
断言(Assertions)是PHPUnit提供的一系列对程序执行结果测试的方法。通俗的讲，就是断言执行程序结果为我们期待的值，如果不是则测试失败，下面是断言方法的详细介绍，内容全部来翻译自PHPUnit的官方文档，部分方法官方介绍的很模糊，我根据官方的源码注释增加了说明和注释 assertArrayHasKey(mixed $key, array $array[, str...
phpUnit 断言
admax0001的博客
10-12 111
转自http://blog.163.com/qianxue126@126/blog/static/162723138201119113131125/ 布尔类型assertTrue 断言为真assertFalse 断言为假NULL类型assertNull 断言为NULLassertNotNull 断言非NULL数字类型assertEquals 断言...
【PHP】phpUnit 断言
凝结的技术博客
08-19 535
断言 布尔类型 assertTrue 断言为真 assertFalse 断言为假 NULL类型 assertNull 断言为NULL assertNotNull 断言非NULL 数字类型 assertEquals 断言等于 assertNotEquals 断言不等于 assertGreaterThan 断言大于 assertGreaterThanOrEqual 断言大于等于 assertLes
PHPUnit断言
TROUBLE I AM IN
04-21 290
PHPUnit的断言 各个断言方法均声明为 static，可以从任何上下文以类似于 PHPUnit\Framework\Assert::assertTrue() 的方式调用，或者也可以用类似于 $this->assertTrue() 或 self::assertTrue() 的方式在扩展自 PHPUnit\Framework\TestCase 的类内调用。 实际上，只要（手工）包含了 PH...
phpunit assert断言分类整理
weixin_34080951的博客
08-06 291
布尔类型 方法名 含义 参数 返回值 assertTrue 断言为真 assertFalse 断言为假 NULL类型 方法名 含义 参数 返回值 assertNull 断言为NULL assertNotNull 断言非NULL 数字类型 方法名 含义 参数 返回值 assertEquals 断言等于 assert...
phpunit-json-assert:JSON文档PHPUnit断言
05-17
PHPUnit的JSON断言 该库向添加了几个新的断言，使您可以使用JSONPath表达式和JSON模式轻松，简洁地验证复杂的数据结构（通常但不一定是JSON文档）。 作者和版权 马丁·赫尔米奇 该库是。 安装 $ composer require ...
phpunit-json-assertions:PHPUnit的JSON断言（包括JSON模式）
05-16
PHPUnit的JSON断言包含特征/方法，以帮助通过各种方法验证JSON数据。 特征 通过JSON模式验证JSON数据 描述您现有的数据格式 清晰的，人为和机器可读的文档 完整的结构验证，对 自动化测试 验证客户端提交的数据 ...
autocomplete-PHPUnit:自动完成 PHPUnit 的断言列表
06-22
Atom PHPUnit 的断言自动完成 是的，通过apm安装： $ apm install autocomplete-phpunit 你准备好了。 谢谢，这个 gif 更好，ty @julianocomg。 贡献 你可以，总是。 执照 :copyright: Andrey K.
laravel-mail-assertions:用于在Laravel中测试电子邮件PHPUnit邮件断言
05-09
PHPUnit邮件断言，用于在Laravel中测试电子邮件。 建置状态 分支 地位 覆盖范围 代码质量 开发 掌握 安装 在您的开发依赖项中安装该软件包： $ composer require spinen/laravel-mail-assertions --dev 配置 ...
phpunit断言方法
weixin_33933118的博客
10-22 174
转载于:https://blog.51cto.com/291856/1033858
php单元测试断言方法
cangqiong_xiamen的博客
05-10 339
1.assertArrayHasKey() 用法：$this->assertArrayHasKey(‘foo’, [‘bar’ => ‘baz’]); 等同于array_key_exists()，查数组有木有某个键 2.assertClassHasAttribute() 用法：$this->assertClassHasAttribute(‘platform’, User::class); 查看某个类是否有某个变量 3.assertArraySubset() 用法：$this->ass
php抛出异常 throws,关于php：如何检查PHPUnit正确抛出的异常？
weixin_31995467的博客
03-10 516
我在CalTest类的Cal类中有div()有以下方法来测试div()。public fucnction div($a,$b){if($b == 0){throw new Exception("Divided by zero");}return $a/$b}我只能传递testDiv()但是传递testDiv2()。我想要检查使用PHPUnit正确抛出的exeption。 我在这里失踪了什么？ 非常...
postman实践（一）
qq_36751833的博客
11-10 6908
1、从登录动态获取token，传给环境变量，再获取环境变量的token进行下一个操作 varjsonData=pm.response.json(); pm.environment.set("token",jsonData.data["token"]); 2、接口断言操作成功 pm.test("供应商结算发起审批",function(){ varjsonData=pm.response.json(); pm.expect(jsonData.message).to...
Laravel 测试： PHPUnit 入门教程
weixin_33730836的博客
03-01 368
介绍 PHPUnit 测试的基础知识，使用基本的 PHPUnit 断言和 Laravel 测试助手。 介绍 PHPUnit是最古老和最著名的 PHP 单元测试包之一。它主要用于单元测试，这意味着可以用尽可能小的组件测试代码，但是它也非常灵活，可以用于很多不仅仅是单元测试。 PHPUnit 包含许多简单和灵活的断言允许您轻松地测试代码，当您测试特定的组件时，这些断言非常有效。但是，它确实意味...
转载：PHPUnit使用详解
weixin_33841503的博客
11-10 124
在上篇文章中介绍了如何使用PHPUnit进行单元测试，现在我就来谈谈如何编写测试用例以及怎样保证测试的全面性。 通常的测试用例继承自 PHPUnit_Framework_TestCase类，其中的每个测试都以test开头，而且声明为公共类型public。每个测试用例都有一个构建 方法setUp()和拆除方法tearDown()，分别在每个测试执行之前和之后执行，这两个方法...
phpstorm配置phpunit单元测试及PHPunit断言函数
flysnownet的博客
01-20 1415
PHPunit安装及配置 项目中引入PHPunit composer require phpunit/phpunit 安装PHPunit脚本 下载跟当前PHP版本兼容的phpunit.phar phpstorm里配置好脚本路径 phpstorm中Languages & Frameworks > PHP > Test Frameworks 配置phpunit.xml <?xml version="1.0" encoding="UTF-8"?> <!--bootstr
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值