導入
Web開発において、RSSフィードの生成や外部APIとのデータ連携、あるいは設定ファイルの読み込みなど、XMLを扱うシーンは依然として多く存在します。しかし、PHPでXMLを扱う際、正規表現で無理やりパースしたり、文字列連結で生成したりしていませんか？これらはセキュリティリスクやコードの保守性を低下させる原因となります。PHP標準のDOMDocumentクラスを活用することで、構造を意識した安全かつ効率的なXML操作が可能になります。
基礎知識
DOMDocumentは、XMLドキュメントをツリー構造としてメモリ上に展開し、ノード単位で操作するための標準的なAPIです。
主な特徴は以下の通りです。
・ノードベースの操作：要素（タグ）、属性、テキストをオブジェクトとして扱います。
・自動エスケープ：特殊文字（<, >, &など）が自動的にエンティティ化されるため、クロスサイトスクリプティング（XSS）等のリスクを低減できます。
・柔軟な構造化：親要素への子要素追加、属性の付与、ノードの削除が直感的に行えます。
実装/解決策
XMLを扱う際、特に重要なのが「出力の整形」と「文字コード」の設定です。デフォルトでは、DOMDocumentが出力するXMLは改行やインデントが含まれない一行構成になりがちです。開発時のデバッグや可読性を高めるためには、formatOutputプロパティを有効にする必要があります。また、日本語を含むデータを扱う場合は、インスタンス生成時にUTF-8を指定し、XML宣言を正しく出力することが重要です。
サンプルプログラム
以下のコードは、実務でよくある「動的なXML生成」を想定したサンプルです。
preserveWhiteSpace = false; // 空白を保持しない
$dom->formatOutput = true; // インデントを付与する
// 3. ルート要素の作成と追加
$root = $dom->createElement(“items”);
$dom->appendChild($root);
// 4. 子要素の追加（ループ処理などを想定）
$data = [‘商品A’, ‘商品B’, ‘商品C’];
foreach ($data as $name) {
$item = $dom->createElement(“item”);
$item->appendChild($dom->createElement(“name”, $name));
// 属性の追加例
$item->setAttribute(“status”, “active”);
$root->appendChild($item);
}
// 5. XMLとして文字列を取得
$xmlString = $dom->saveXML();
// 6. ブラウザやファイルへ出力
header(“Content-Type: application/xml; charset=utf-8”);
echo $xmlString;
// ファイルに保存する場合
// $dom->save(“output.xml”);
?>
応用・注意点
実務でDOMDocumentを使う際の注意点をまとめます。
・メモリ消費量：DOMDocumentはXML全体をメモリ上に読み込むため、極端に巨大なXML（数GB単位など）を扱う場合はメモリ不足に陥ることがあります。その際はXMLReader（ストリーム形式）の検討が必要です。
・CDATAの利用：もしXML内にスクリプトや特殊な記号を含む文字列をそのまま格納したい場合は、createCDATASectionを使用してください。これにより、エスケープされずに内容を保持できます。
・文字化け対策：XML生成時には必ずUTF-8を使用し、外部からの読み込み時には、読み込み元ファイルのエンコーディングがUTF-8であることを確認してください。Shift-JISなどの場合は、読み込み前にmb_convert_encodingなどで変換する必要があります。
正しいツール（DOMDocument）を正しく使うことで、XML操作はより堅牢で保守しやすいものになります。ぜひ次回の実装から取り入れてみてください。