PHP PHPUnit assertEquals()用法及代碼示例

assertEquals()函數是PHPUnit中的內置函數，用於斷言實際獲得的值是否等於預期值。如果期望值與實際值相同，則此斷言將返回true，否則返回false。如果為真，則通過斷言的測試用例，否則測試用例失敗。

用法:

assertEquals( mixed $expected, mixed $actual, string $message = '' )

參數：該函數接受三個參數，如上麵的語法所示。參數說明如下：

• $expected:該參數可以是代表期望數據的任何類型。
• $actual:此參數可以是代表實際數據的任何類型。
• $message:此參數采用字符串值。當測試用例失敗時，此字符串消息將顯示為錯誤消息。

以下程序說明了PHPUnit中的assertEquals()函數：

程序1:

<?php 
use PHPUnit\Framework\TestCase; 
  
class GeeksPhpunitTestCase extends TestCase 
{ 
    public function testNegativeTestcaseForAssertEquals() 
    { 
        $expected = "geeks"; 
        $actual = "Geeks"; 
  
        // Assert function to test whether expected 
        // value is equal to actual or not 
        $this->assertEquals( 
            $expected, 
            $actual, 
            "actual value is not equals to expected"
        ); 
    } 
} 
  
?>

輸出：

PHPUnit 8.2.5 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time:64 ms, Memory:10.00 MB

There was 1 failure:

1) GeeksPhpunitTestCase::testNegativeTestcaseForAssertEquals
actual value is not equals to expected
Failed asserting that two strings are equal.
--- Expected
+++ Actual
@@ @@
-'geeks'
+'Geeks'

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

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

程序2:

<?php 
use PHPUnit\Framework\TestCase; 
  
class GeeksPhpunitTestCase extends TestCase 
{ 
    public function testPositiveTestcaseForAssertEquals() 
    { 
        $expected = "geeks"; 
        $actual = "geeks"; 
  
        // Assert function to test whether expected 
        // value is equal to actual or not 
        $this->assertEquals( 
            $expected, 
            $actual, 
            "actual value is not equals to expected"
        ); 
    } 
} 
  
?>

輸出：

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