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

fullEndElementメソッドは、XMLWriterオブジェクトを使用してXML文書を構築する際に、現在開いているXML要素を完全に閉じることを実行するメソッドです。このメソッドの主な役割は、startElement()メソッドなどで開始されたXML要素に対応する終了タグ（例: </tag>)をXML出力ストリームに書き込むことです。

XML文書では、全ての要素が開始タグと終了タグで正しく囲まれている必要があります。このメソッドは、開かれた要素に対して適切な終了タグを付加することで、XML文書の階層構造の整合性を保ちます。例えば、<section>という要素を開始し、その中に<title>という要素を作成した場合、まずtitle要素に対してfullEndElement()を呼び出して</title>を出力し、次にsection要素に対してこのメソッドを呼び出して</section>を出力します。これにより、要素の入れ子構造が正しく閉じられ、整形式なXML文書が生成されます。

このメソッドは、最後に開かれた要素を最初に閉じるという「後入れ先出し（LIFO）」の原則に従って利用する必要があります。誤った順序で要素を閉じようとすると、XML文書の構造が壊れ、不正なXMLが生成される原因となりますので注意が必要です。メソッドの実行に成功した場合はブール値trueを、何らかの理由で失敗した場合はfalseを返します。正確なXML文書を生成するためには、要素の開始と終了の対応を適切に管理することが非常に重要になります。

Copy
1<?php
2$writer = new XMLWriter();
3$writer->openMemory();
4$writer->startElement('root');
5$writer->fullEndElement();
6?>

引数なし

引数はありません

bool

XMLWriter::fullEndElement は、現在の要素を終了し、その親要素に戻るために使用されます。成功した場合は true を、失敗した場合は false を返します。