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

relaxNGValidateメソッドは、PHPのDOMDocumentクラスに属し、現在のXMLドキュメントが指定されたRelax NGスキーマに準拠しているかを検証するメソッドです。このメソッドを利用することで、XMLドキュメントの構造や内容が、事前に定義されたルール（スキーマ）に従っているかどうかを確認できます。

この機能を使用するには、まずDOMDocumentオブジェクトを作成し、検証したいXMLドキュメントを読み込みます。次に、relaxNGValidateメソッドを呼び出し、引数として検証に用いるRelax NGスキーマファイルのパスを指定します。メソッドは、XMLドキュメントがスキーマのすべての要件を満たしていればtrue（真）を返し、一つでも準拠していない点があればfalse（偽）を返します。

Relax NGスキーマは、XMLドキュメントの要素、属性、テキスト内容などの許容される構造を詳細に定義するための言語です。relaxNGValidateメソッドを用いることで、外部から受け取ったXMLデータの整合性を確認したり、アプリケーション内で生成されたXMLが正しい形式であることを保証したりする際に非常に有効です。例えば、異なるシステム間でXML形式のデータをやり取りする際に、受信したデータが期待通りの構造を持っているかを検証することで、後続の処理で発生する可能性のあるエラーを未然に防ぎ、システムの信頼性を高めることができます。検証に失敗した場合、PHPのエラーログに詳細な情報が記録されるため、問題の原因特定に役立ちます。

Copy
1<?php
2
3$dom = new DOMDocument();
4$schemaFilePath = 'path/to/schema.rng';
5$isValid = $dom->relaxNGValidate($schemaFilePath);
6
7?>

string $filename

• string $filename: RELAX NGスキーマのファイルパスを指定する文字列

bool

relaxNGValidateメソッドは、DOMDocumentオブジェクトがRELAX NGスキーマに対して有効であるかどうかを示す真偽値（bool）を返します。検証が成功した場合はtrue、失敗した場合はfalseを返します。