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

assertStringContainsString()函数是PHPUnit中的内置函数，用于断言包含子字符串的字符串。如果字符串包含子字符串作为子字符串，则此断言将返回true；否则返回false；如果为true，则通过断言的测试用例，否则测试用例失败。

用法：

assertStringContainsString(string $substring, string $string, string $message = ''])

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

1. $substring：此参数表示字符串是给定字符串的子字符串。
2. $string：此参数是一个字符串，assert函数将为其检查其是否包含子字符串。
3. $message：此参数采用字符串值。当测试用例失败时，此字符串消息将显示为错误消息。

以下示例程序旨在说明assertStringContainsString()函数：

程序1:：

<?php 
use PHPUnit\Framework\TestCase; 
  
class GeeksPhpunitTestCase extends TestCase 
{ 
    public function testNegativeTestcaseForAssertStringContainsString() 
    { 
        $testString = "geekforgeek"; 
        $substring = "geeks";  
        // assert function to test whether 'geeks' is a substring of testString 
        $this->assertStringContainsString($substring, $testString, "testString doesn't contains 'geeks' as substring") ; 
    } 
} 
  
?>

输出：

PHPUnit 8.2.5 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time:65 ms, Memory:10.00 MB

There was 1 failure:

1) GeeksPhpunitTestCase::testNegativeTestcaseForAssertStringContainsString
testString doesn't contains 'geeks' as substring
Failed asserting that 'geekforgeek' contains "geeks".

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

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

程序2:：

<?php 
use PHPUnit\Framework\TestCase; 
  
class GeeksPhpunitTestCase extends TestCase 
{ 
    public function testPositiveTestcaseForAssertStringContainsString() 
    { 
        $testString = "geekforgeek"; 
        $substring = "geek";  
        // assert function to test whether 'geeks' is a substring of testString 
        $this->assertStringContainsString($substring, $testString, "testString doesn't contains 'geeks' as substring") ; 
    } 
} 
  
?>

输出：

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及更高版本支持assertStringContainsString()。