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

『cloneNodeメソッドは、呼び出し元であるDom\ProcessingInstructionオブジェクトの正確な複製を作成するメソッドです。このメソッドを実行すると、元の処理命令ノードと全く同じターゲットとデータを持つ、新しいDom\ProcessingInstructionオブジェクトがメモリ上に生成されます。作成された複製ノードは、元のドキュメントツリーからは完全に独立しており、親ノードを持たない状態です。このため、後からappendChildメソッドなどを用いて、ドキュメント内の別の場所や、あるいは全く異なるドキュメントに追加することができます。このメソッドはオプションで真偽値の引数$deepを受け取りますが、処理命令ノードは子ノードを持つことができないという特性上、この引数にtrueとfalseのどちらを指定しても動作に違いはありません。メソッドの実行が成功すると、新しく作成されたノードオブジェクトが返され、何らかの理由で失敗した場合にはfalseが返されます。

Copy
1<?php
2
3$document = new DOMDocument();
4$pi = $document->createProcessingInstruction('php', 'echo "Hello World";');
5
6// Dom\ProcessingInstruction ノードの複製を生成します
7$cloned_pi = $pi->cloneNode();

bool $deep = false

• bool $deep = false: ノードとそのすべての子孫を深くクローンするかどうかを指定するブール値。デフォルトは false（浅いクローン）。

Dom\Node|false

このメソッドは、呼び出し元の Dom\ProcessingInstruction ノードのコピーを返します。コピーは新しい Dom\Node オブジェクトとして作成されます。処理が成功しなかった場合は false が返されます。