【PHP8.x】XMLWriter::writeRaw()メソッドの使い方

writeRawメソッドは、指定された生のXML文字列を、XMLドキュメントにそのまま書き込むメソッドです。このメソッドは、テキストや属性値のように、自動的に特殊文字（例: <、>、&）がエスケープされることなく、提供された文字列を完全にそのままXML出力に挿入します。

例えば、データベースから取得したXML断片をそのまま出力したい場合や、既に整形式であることが保証されているXML文字列を現在のXMLストリームに結合したい場合に非常に役立ちます。他のXML書き込みメソッドが自動的に行うエンティティ変換やエスケープ処理を避けたい場合に、このメソッドが選択されます。

しかし、このメソッドを使用する際は注意が必要です。書き込む文字列が有効なXMLではない場合、生成される最終的なXMLドキュメントも不正な形式になってしまいます。そのため、このメソッドに渡す文字列は、XMLとして完全に整形式であり、かつセキュリティ上の問題を引き起こす可能性のある悪意のある内容が含まれていないことを、開発者自身が確認する必要があります。信頼できないソースからの入力に対して使用すると、セキュリティ上の脆弱性やドキュメントの破損を引き起こす可能性があるため、厳密な検証を行うか、使用を避けるべきです。このメソッドは、XMLの柔軟な生成を可能にする一方で、開発者がXMLの有効性について責任を持つことを求めます。

Copy
1<?php
2
3$writer = new XMLWriter();
4$writer->openMemory();
5$writer->writeRaw('<custom-element attribute="value">This is raw content.</custom-element>');
6
7?>

string $content

• string $content: XMLとしてエスケープせずにそのまま出力したい文字列を指定します。

bool

XMLWriter::writeRaw メソッドは、引数として渡された文字列をエスケープせずにそのまま XML として出力します。処理が成功した場合は true を、失敗した場合は false を返します。