PHPUnit | assertContains()函数介绍

PHPUnit是一个流行的单元测试框架，用于在PHP应用程序中进行自动化单元测试。其中的assertContains()函数是PHPUnit提供的一个断言函数，用于验证给定的值是否包含在另一个值中。

语法

assertContains(mixed $needle, iterable|string $haystack, string $message = '')

assertContains()函数接受三个参数：

• $needle：用于查找的值。
• $haystack：要在其中查找的目标值，可以是一个可迭代对象，也可以是一个字符串。
• $message（可选）：自定义断言失败时的错误消息。

功能

assertContains()函数验证了给定的值是否存在于目标值中。如果目标值包含了给定的值，则断言成功，否则断言失败并抛出一个异常。

示例

以下是一个示例代码：

use PHPUnit\Framework\TestCase;

class AssertionTest extends TestCase
{
    public function testArrayContainsValue()
    {
        $array = ['apple', 'banana', 'orange'];
        $this->assertContains('banana', $array);
    }

    public function testStringContainsSubstring()
    {
        $string = 'This is a test string';
        $this->assertContains('test', $string);
    }
}

在上述示例中，我们使用assertContains()函数来验证一个数组中是否包含了特定的值，以及一个字符串中是否包含了指定的子串。如果这些断言成功，则测试通过，否则将抛出异常。

结论

通过使用PHPUnit的assertContains()函数，您可以轻松地验证一个值是否存在于另一个值中，并且在单元测试过程中确保您的代码的正确性。这有助于提高代码质量和可靠性。

请参考PHPUnit官方文档以了解更多关于assertContains()函数和其他可用的断言函数的信息。