【PHP8.x】Dom\ProcessingInstruction::appendData()メソッドの使い方

『appendDataメソッドは、処理命令ノード（Processing Instruction）が持つデータ文字列の最後に、指定した文字列を追加する処理を実行するメソッドです。処理命令ノードとは、XMLやHTML文書内で <?target data?> のような形式で記述され、特定のアプリケーションへの指示を伝える役割を持ちます。このメソッドは、ノードの data 部分、つまりターゲット名の後に続く文字列に対して操作を行います。引数に渡された文字列は、既存のデータ文字列の後ろに連結され、ノードの内容が更新されます。この操作は既存のデータを上書きするのではなく、あくまで末尾に追加する処理であるため、元のデータは保持されます。例えば、<?php echo "Hello"?> という処理命令ノードのデータ部分である echo "Hello" の末尾に , " World!"; という文字列を追加したい場合などに使用します。処理が正常に完了した場合は true を、失敗した場合は false を返すため、プログラム中で処理の成否を確認することが可能です。

Copy
1<?php
2
3$doc = new DOMDocument();
4
5// 処理命令ノードを作成します (ターゲット: 'php', 初期データ: 'echo "Hello"')
6$pi = $doc->createProcessingInstruction('php', 'echo "Hello"');
7
8// 処理命令のデータの末尾に文字列を追加します
9$pi->appendData(' . " World!";');
10
11// 変更後のデータプロパティを出力します
12// 出力結果: echo "Hello" . " World!";
13echo $pi->data;
14
15?>

string $data

• string $data: 追加したいデータ文字列

void

このメソッドは値を返しません。