【PHP8.x】isEqualNodeメソッドの使い方

isEqualNodeメソッドは、指定された他のノードと現在のノードが論理的に等しいかどうかを比較し、その結果を真偽値で返すメソッドです。このメソッドはDom\XMLDocumentクラスに属しており、XMLドキュメント内のノードの内容と構造の同一性を判断するために用いられます。

ここでいう「等しい」とは、単にメモリ上の同じオブジェクトであるかどうか（厳密な同一性）を指すのではなく、ノードの種類（例：要素、テキスト）、ノードの名前、値、そして要素ノードであればその属性や子ノードの順序と内容までを含めて、その論理的な構造と内容が同一であるかを意味します。

システムエンジニアを目指す方にとって、XMLドキュメントをプログラムで扱う場面は多くあります。isEqualNodeメソッドは、プログラムが生成したXMLデータが期待通りの構造や内容を持っているか検証したい場合や、異なるXMLドキュメント間で特定のノードの内容が一致しているかを確認したい場合などに非常に有用です。例えば、XMLの設定ファイルを読み込んだ後、特定の要素が正しいデフォルト値を持っているか比較したり、ウェブサービスから受信したXMLレスポンスの構造が定義通りであるかを確認したりする際に活用できます。XMLの厳密な内容比較を効率的に行うための基本的なツールとして理解しておくと良いでしょう。

Copy
1<?php
2
3// Dom\XMLDocumentのインスタンスを作成
4$documentA = new Dom\XMLDocument();
5$documentA->loadXML('<data><item id="1"/></data>');
6
7$documentB = new Dom\XMLDocument();
8$documentB->loadXML('<data><item id="1"/></data>');
9
10// 構文: $thisNode->isEqualNode($otherNode)
11// $thisNode および $otherNode は Dom\XMLDocument (または DOMNode を継承する任意のオブジェクト)
12$areEqual = $documentA->isEqualNode($documentB);
13
14?>

?Dom\Node $otherNode

• ?Dom\Node $otherNode: 比較対象となるノードを指定するDom\Nodeオブジェクト。nullを指定した場合、falseを返します。

bool

このメソッドは、呼び出し元のDOM\XMLDocumentノードと引数で渡されたノードが、構造的および内容的に同一であるかどうかを示す真偽値（bool）を返します。同一であればtrue、そうでなければfalseを返します。