Friday, October 24, 2025
HomeLanguagesPHPUnit | assertStringContainsStringIgnoringCase() function

PHPUnit | assertStringContainsStringIgnoringCase() function

The assertStringContainsStringIgnoringCase() function is a builtin function in PHPUnit and is used to assert a string containing a substring but ignoring the case of substring. This assertion will return true in the case if the string contains the substring as a substring ignoring case-sensitivity, else return false and in case of true the asserted test case got passed else test case got failed.

Syntax:

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

Parameters: This function accepts three parameters as shown in the above syntax. The parameters are described below:

  1. $substring: This parameter represents the string to be substring of given string.
  2. $string: This parameter is string for which the assert function will check whether it contains substring(ignoring case-sensitivity) or not.
  3. $message: This parameter takes string value. When the testcase got failed this string message got displayed as error message.

Below programs illustrate the assertStringContainsStringIgnoringCase() function:

Program 1:




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


Output:

PHPUnit 8.2.5 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time: 67 ms, Memory: 10.00 MB

There was 1 failure:

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

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

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

Program 2:




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


Output:

PHPUnit 8.2.5 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 67 ms, Memory: 10.00 MB

OK (1 test, 1 assertion)

Note : To run testcases with phpunit follow steps from here. Also, assertStringContainsStringIgnoringCase() is supported by phpunit 7 and above.

RELATED ARTICLES

Most Popular

Dominic
32361 POSTS0 COMMENTS
Milvus
88 POSTS0 COMMENTS
Nango Kala
6728 POSTS0 COMMENTS
Nicole Veronica
11892 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11954 POSTS0 COMMENTS
Shaida Kate Naidoo
6852 POSTS0 COMMENTS
Ted Musemwa
7113 POSTS0 COMMENTS
Thapelo Manthata
6805 POSTS0 COMMENTS
Umr Jansen
6801 POSTS0 COMMENTS