【PHP8.x】versionプロパティの使い方

versionプロパティは、XMLドキュメントのXML宣言におけるXMLバージョン番号を保持するプロパティです。DOMDocumentクラスはXML文書を操作するための基盤となるクラスであり、このversionプロパティは、特に新しいXML文書を作成し、そのXML宣言を出力する際に利用されます。通常、XML文書の冒頭には<?xml version="1.0" encoding="UTF-8"?>のようなXML宣言が記述されますが、このプロパティは宣言の中のversion="1.0"の部分に対応します。

このプロパティのデフォルト値は"1.0"であり、明示的に設定しない限り、DOMDocumentが生成するXML文書のXML宣言にはversion="1.0"が含まれます。このプロパティには、XMLバージョン番号を表す文字列を設定できます。例えば、$dom->version = "1.1";のように代入することで、XML宣言のバージョンを変更可能です。ただし、現在のXML標準では通常"1.0"が広く使用されており、特別な要件がない限り変更する必要はほとんどありません。

versionプロパティを設定することで、DOMDocument::save()やDOMDocument::saveXML()メソッドで出力されるXML文字列のXML宣言に、指定したバージョン番号が反映されます。これは、生成するXMLが特定のアプリケーションやシステム要件に適合する必要がある場合に役立ちます。このプロパティは読み書き可能であるため、XML文書の内容に応じて動的にバージョン情報を制御することが可能です。

Copy
1<?php
2$dom = new DOMDocument();
3$dom->loadXML('<?xml version="1.0" encoding="UTF-8"?><root/>');
4echo $dom->version;
5?>

string

DOMDocumentオブジェクトが使用しているlibxml2ライブラリのバージョンを文字列で返します。