Friday, November 14, 2025
HomeLanguagesPHPUnit assertSame() Function

PHPUnit assertSame() Function

The assertSame() function is a builtin function in PHPUnit and is used to assert whether the actually obtained value is the same as the expected value or not. This assertion will return true in the case if the expected value is the same as the actual value else returns false. In case of true the asserted test case got passed else test case got failed.

Syntax:

assertSame(mixed $expected, mixed $actual[, string $message = ''])

Parameters: This function accepts three parameters as mentioned above and described below:

  • $expected: This parameter is of any type which represents the expected data.
  • $actual: This parameter is of any type which represents the actual data.
  • $message: This parameter takes a string value. When the test case got failed this string message got displayed as an error message.

Below examples illustrate the assertSame() function in PHPUnit:

Examples 1:

PHP




<?php 
use PHPUnit\Framework\TestCase; 
    
class GeeksPhpunitTestCase extends TestCase 
{ 
    public function testNegativeForassertSame()
          
    {
     $expected = "(108) banana";    
     $actual = "(108) mango";
        // Assert function to test whether expected
        // value is same as actual value or not
        $this->assertSame(
            $expected,
            $actual,
            "actual value is not same as expected value"
        );
          
    }
   
 } 
?> 


Output:

PHPUnit 8.5.8 by Sebastian Bergmann and contributors.

F                                                  1 / 1 (100%)

Time: 90 ms, Memory: 10.00 MB

There was 1 failure:

1) GeeksPhpunitTestCase::testNegativeForassertSame
actual value is not same as expected value
Failed asserting that two strings are identical.
--- Expected
+++ Actual
@@ @@
-'(108) banana'
+'(108) mango'

/home/lovely/Documents/php/test.php:17

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

Example 2:

PHP




<?php 
use PHPUnit\Framework\TestCase; 
    
class GeeksPhpunitTestCase extends TestCase 
{ 
    public function testPositiveForassertSame()
          
    {
     $expected = "(108) mango";    
     $actual = "(108) mango";
        // Assert function to test whether expected
        // value is same as actual value or not
        $this->assertSame(
            $expected,
            $actual,
            "actual value is not same as expected value"
        );
          
    }
   
 } 
?> 


Output:

PHPUnit 8.5.8 by Sebastian Bergmann and contributors.

.                                                  1 / 1 (100%)

Time: 89 ms, Memory: 10.00 MB

OK (1 test, 1 assertion)

Reference: https://phpunit.readthedocs.io/en/9.2/assertions.html#assertsame

RELATED ARTICLES

Most Popular

Dominic
32399 POSTS0 COMMENTS
Milvus
95 POSTS0 COMMENTS
Nango Kala
6765 POSTS0 COMMENTS
Nicole Veronica
11917 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11984 POSTS0 COMMENTS
Shaida Kate Naidoo
6889 POSTS0 COMMENTS
Ted Musemwa
7142 POSTS0 COMMENTS
Thapelo Manthata
6837 POSTS0 COMMENTS
Umr Jansen
6840 POSTS0 COMMENTS