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

writeElementNsメソッドは、PHPのXMLWriterクラスに属し、XML文書内に名前空間を持つ要素を簡潔に書き込むことを実行するメソッドです。XML文書を作成する際、異なるXML語彙（ルールセット）を組み合わせて使用する場合に、要素名の衝突を避ける目的で名前空間が利用されます。このメソッドは、指定された名前空間URI、プレフィックス、要素名、そしてオプションで要素の内容（テキストデータ）を一度の呼び出しでXMLドキュメントに書き出します。

具体的には、要素の開始タグから内容、そして終了タグまでを一連の処理として出力します。たとえば、$writer->writeElementNs('soap', 'Envelope', 'http://schemas.xmlsoap.org/soap/envelope/', 'Hello World'); のように使用することで、「Hello World」という内容を持つ「soap:Envelope」要素を、指定されたURIの名前空間とともに生成できます。このメソッドを利用することで、startElementNs()で要素の開始を宣言し、text()で内容を書き込み、endElement()で要素を閉じるという一連の操作を、一つのメソッド呼び出しで完了できます。これにより、XML文書生成のコードをより簡潔かつ効率的に記述することが可能になり、特に繰り返し同じ形式の名前空間付き要素を生成する場合に、コードの可読性を高めることができます。

Copy
1<?php
2$writer = new XMLWriter();
3$writer->openMemory();
4$writer->setIndent(true);
5$writer->startDocument('1.0', 'UTF-8');
6
7$writer->writeElementNs('my', 'elementName', 'http://example.com/myns', 'Element Content');
8
9$writer->endDocument();
10echo $writer->outputMemory();
11?>

string $prefix, string $name, string $namespace, ?string $content = null

• string $prefix: 要素のプレフィックスを指定する文字列
• string $name: 要素の名前を指定する文字列
• string $namespace: 要素の名前空間を指定する文字列
• ?string $content = null: 要素のコンテンツを指定する文字列。省略可能で、指定しない場合は空の要素が生成されます。

bool

XMLWriter::writeElementNsメソッドは、指定された名前空間と要素名でXML要素を書き込みます。成功した場合はTRUEを、失敗した場合はFALSEを返します。