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