PHP 单元 | assertEmpty()函数

介绍

assertEmpty() 是 PHP 中的一个单元测试断言函数，用于判断一个值是否为空。当被测试的变量值为 null，空字符串 ""，空数组 []，空对象 new stdClass() 时，该函数会返回 true。

该函数在 PHPUnit 工具中得到了封装，是一个方便进行单元测试的工具函数。

语法

assertEmpty(mixed $actual, string $message = '');

• $actual：要测试的值，可以是任意类型的变量。
• $message：可选参数，用于在测试失败时显示断言信息。

示例

public function testAssertEmpty()
{
    $foo = 'not empty';
    $this->assertEmpty($foo);
 
    $bar = [];
    $this->assertEmpty($bar);
}

上面的示例演示了如何使用 assertEmpty() 函数测试 $foo 变量是否为空字符串，以及 $bar 变量是否为空数组。在这两个测试中，均会断言： assertEmpty() 期望这个变量是空的（"" 或 []），得到了相应的 true 或 false 的测试结果。

异常情况

在被测试的变量值不为空时，该函数将会抛出一个 PHPUnit\Framework\AssertionFailedError 的异常。

总结

assertEmpty() 函数是 PHPUnit 中的一个方便的单元测试工具函数，用于测试变量是否为空。用户可以在测试用例中中方便地调用该函数进行测试，并且在测试函数抛出断言失败异常时，可以使得测试用例在测试过程中自动失败。