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()。