PHP PHPUnit assertContainsOnlyInstancesOf()用法及代码示例

assertContainsOnlyInstancesOf()函数是PHPUnit中的内置函数，用于声明数组以包含其所有值作为给定类的实例。如果数组仅包含给定类的实例，则此断言将返回true，否则返回false。如果为真，则通过断言的测试用例，否则测试用例失败。

用法:

assertContainsOnlyInstancesOf( string $classname, array $array, string $message = '' )

参数：该函数接受三个参数，如上面的语法所示。参数说明如下：

• $classname:此参数是一个字符串，它是类的名称。
• $array:此参数是一个数组，assert函数将为其检查是否仅包含给定类的实例。
• $message:此参数采用字符串值。当测试用例失败时，此字符串消息将显示为错误消息。

以下程序说明了PHPUnit中的assertContainsOnlyInstancesOf()函数：

程序1:

<?php 
  
use PHPUnit\Framework\TestCase; 
  
class Foo { 
    public function dummyFunction(){return true;} 
} 
  
class Bar { 
    public function dummyFunction(){return true;} 
} 
  
class GeeksPhpunitTestCase extends TestCase 
{ 
    public function testNegativeTestcaseForAssertContainsOnlyInstancesOf() 
    { 
      
        // Assert function to test whether testArray contains 
        // only instance of Foo or not 
        $this->assertContainsOnlyInstancesOf( 
            Foo::class, 
            [new Foo, new Bar, new Foo],  
            "testArray doesn't contains only instance of Foo"
        ); 
    } 
} 
  
?>

输出：

PHPUnit 8.2.5 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time:81 ms, Memory:10.00 MB

There was 1 failure:

1) GeeksPhpunitTestCase::testNegativeTestcaseForAssertContainsOnlyInstancesOf
testArray doesn't contains only instance of Foor
Failed asserting that Array &0 (
    0 => Foo Object &00000000051a5c33000000005d98efba ()
    1 => Bar Object &00000000051a5d77000000005d98efba ()
    2 => Foo Object &00000000051a5c32000000005d98efba ()
) contains only values of type "Foo".

/home/shivam/Documents/geeks/phpunit/abc.php:20

FAILURES!
Tests:1, Assertions:1, Failures:1.

程序2:

<?php 
use PHPUnit\Framework\TestCase; 
  
class Foo { 
    public function dummyFunction(){return true;} 
} 
  
class Bar { 
    public function dummyFunction(){return true;} 
} 
  
class GeeksPhpunitTestCase extends TestCase 
{ 
    public function testNegativeTestcaseForAssertContainsOnlyInstancesOf() 
    { 
        // Assert function to test whether testArray contains 
        // only instance of Foo or not 
        $this->assertContainsOnlyInstancesOf( 
            Foo::class, 
            [new Foo, new Foo], 
            "testArray contains only instance of Foo"
        ); 
    } 
} 
  
?>

输出：

PHPUnit 8.2.5 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time:67 ms, Memory:10.00 MB

OK (1 test, 1 assertion)

注意：要使用phpunit运行测试用例，请遵循此处的步骤。另外，phpunit 7及更高版本支持assertContainsOnlyInstancesOf()。