PHP 单元 | assertContainsOnlyInstancesOf()函数

assertContainsOnlyInstancesOf()函数是PHPUnit框架中的一个单元测试函数，用于断言一个数组中的元素都是同一个类的实例。

语法

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

• $classname：必需，指定类名。
• $haystack：必需，要断言的数组。
• $message：可选，断言失败时输出的信息。

返回值

如果断言成功，该函数将不会返回任何值，否则将会抛出一个异常。

例子

class MyClass {}

class ExampleTest extends \PHPUnit\Framework\TestCase
{
    public function testAssertContainsOnlyInstancesOf()
    {
        $array = [
            new MyClass(),
            new MyClass(),
            new MyClass()
        ];

        $this->assertContainsOnlyInstancesOf(MyClass::class, $array);
    }
}

在上面的例子中，我们用assertContainsOnlyInstancesOf()函数断言了 $array 数组中的元素是否都是 MyClass 类的实例。如果数组中有任何一个元素不是该类的实例，则该测试用例将会失败。

总结

在编写单元测试时，我们通常会涉及到判断数组中的元素是否都满足某一条件，assertContainsOnlyInstancesOf()函数可以方便的进行这样的断言。使用该函数，可以有效地提升我们的单元测试覆盖率和程序的健壮性。