【PHP8.x】cloneNodeメソッドの使い方

cloneNodeメソッドは、DOM (Document Object Model) におけるテキストノードの複製を作成するメソッドです。このメソッドは、Dom\Textクラスに属しており、既存のテキストノードが保持するテキストデータを基に、全く新しい独立したテキストノードのインスタンスを生成するために使用されます。

このメソッドを実行すると、元のノードが持っていたテキストの内容が完全にコピーされ、その内容を持つ新しいDom\Textオブジェクトが返されます。複製されたノードは、元のノードがDOMツリー内でどこに配置されていたかに関わらず、親ノードとの関連を持たず、独立した状態です。テキストノードは子ノードを持つことができないため、一般的にcloneNodeメソッドで指定される、子ノードも再帰的に複製するかどうかを示す引数（$deep）は、Dom\Textクラスのこのメソッドの動作には影響を与えません。

複製されたテキストノードは、返された後にappendChildなどのDOM操作メソッドを使用して、文書の任意の場所に新たに追加することができます。既存のテキストデータを効率的に再利用したり、同じテキスト内容を複数の場所に表示したり、あるいは元のノードに影響を与えずにテキスト内容を加工したい場合などに、このcloneNodeメソッドは非常に有効な手段となります。

Copy
1<?php
2$dom = new DOMDocument();
3$originalTextNode = $dom->createTextNode('Example Text');
4
5$clonedTextNode = $originalTextNode->cloneNode();

bool $deep = false

• bool $deep = false: trueに設定すると、このノードの子ノードも再帰的に複製します。false（デフォルト）の場合は、このノードのみが複製され、子ノードは複製されません。

Dom\Node

このメソッドは、元のDom\Textノードのコピーを新しく作成し、それをDom\Nodeオブジェクトとして返します。