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

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

用法:

assertXmlFileEqualsXmlFile(string $expectedFile, 
string $actualFile[, string $message = ''])

參數：此函數接受上述和以下所述的三個參數：

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

以下示例說明了PHPUnit中的assertXmlFileEqualsXmlFile()函數：

範例1：

<?php  
use PHPUnit\Framework\TestCase;  
    
class GeeksPhpunitTestCase extends TestCase  
{  
    public function testNegativeTestcaseForassertXmlFileEqualsXmlFile() 
    {  
        $actualFile =  '/home/lovely/Documents/php/actual.xml'; 
        $expectedFile     = '/home/lovely/Documents/php/expected.xml';  
        
        // Assert function to test whether given  
        // expected xml file is equal to actual xml file or not 
        $this->assertXmlFileEqualsXmlFile( 
            $actualFile, 
            $expectedFile,  
            "actual xml file equal to expected xml file or not"
        );  
    }  
}  
    
?> 

輸出：

PHPUnit 8.5.8 by Sebastian Bergmann and contributors.

F                                                             1 / 1 (100%)

Time:88 ms, Memory:10.00 MB

There was 1 failure:

1) GeeksPhpunitTestCase::testNegativeTestcaseForassertXmlFileEqualsXmlFile
actual xml file equal to expected xml file or not
Failed asserting that two DOM documents are equal.
--- Expected
+++ Actual
@@ @@
    <author>Gambardella, Matthew</author>
    <title>XML Developer's Guide</title>
    <genre>Computer</genre>
-    <price>444.95</price>
+    <price>44.95</price>
    <publish_date>2000-10-01</publish_date>
    <description>An in-depth look at creating applications
      with XML.</description>

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

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

範例2：

<?php  
use PHPUnit\Framework\TestCase;  
    
class GeeksPhpunitTestCase extends TestCase  
{  
    public function testPositiveTestcaseForassertXmlFileEqualsXmlFile() 
    {  
        $actualFile =  '/home/lovely/Documents/php/actual.xml'; 
        $expectedFile    = '/home/lovely/Documents/php/expected.xml';  
        // Assert function to test whether given  
        // expected xml file is equal to actual xml file or not 
        $this->assertXmlFileEqualsXmlFile( 
            $actualFile, 
            $expectedFile,  
            "actual xml file equal to expected xml file or not"
        );  
    }  
}  
    
?> 

例：

PHPUnit 8.5.8 by Sebastian Bergmann and contributors.

.                                                 1 / 1 (100%)

Time:87 ms, Memory:10.00 MB

OK (1 test, 1 assertion)

參考：https://phpunit.readthedocs.io/en/9.2/assertions.html#assertxmlfileequalsxmlfile