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

cloneNodeメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年11月24日

基本的な使い方

cloneNodeメソッドは、呼び出し元となったDOMTextオブジェクトの正確な複製を作成するメソッドです。このメソッドを実行すると、元のテキストノードと全く同じテキスト内容を持つ、新しいDOMTextオブジェクトが生成されて返されます。作成された新しいノードは、元のノードとは完全に独立した別のインスタンスです。そのため、複製元のノードや複製されたノードのどちらかを後から変更しても、もう一方に影響が及ぶことはありません。このメソッドはオプションで真偽値の引数を受け取りますが、DOMTextノードは仕様上子ノードを持たないため、この引数の値に関わらずメソッドの動作は変わりません。cloneNodeによって返されたノードは、どのドキュメントツリーにも属していない孤立した状態であることに注意が必要です。ドキュメント内でこの複製したノードを使用するには、appendChildメソッドなどを用いて、ツリー内の適切な位置に明示的に追加する必要があります。

構文(syntax)


1<?php
2
3// DOMDocumentオブジェクトを作成します
4$dom = new DOMDocument();
5
6// 元となるテキストノードを作成します
7$originalNode = $dom->createTextNode('オリジナルのテキスト');
8
9// DOMText::cloneNode() を使ってテキストノードを複製します
10// テキストノードには子ノードがないため、引数 $deep の影響はありません
11$clonedNode = $originalNode->cloneNode();
12
13// 複製されたノードのテキストを変更します
14$clonedNode->data = '複製されたテキスト';
15
16// 元のノードと複製されたノードが、それぞれ独立していることを確認します
17echo $originalNode->data . PHP_EOL; // オリジナルのテキスト
18echo $clonedNode->data . PHP_EOL;   // 複製されたテキスト
19
20?>

引数(parameters)

bool $deep = false

bool $deep = false: ノードとそのすべての子孫をディープコピーするかどうかを指定するブール値。true の場合、すべての子孫もコピーされます。デフォルトは false で、ノード自体のみがコピーされます。

戻り値(return)

DOMNode

DOMText オブジェクトの複製を返します。この複製されたノードは、元のノードとは独立した新しい DOMNode オブジェクトとなります。

サンプルコード

PHP DOMText::cloneNodeでノードを複製する


1<?php
2
3/**
4 * DOMText::cloneNode() メソッドの使用例。
5 *
6 * この関数は、DOMツリー内の既存のテキストノードを複製する方法を示します。
7 * PHPの「clone」キーワードはオブジェクト全体の複製に使われますが、
8 * DOMNode::cloneNode() はDOMツリーのノードを複製する特定のメソッドです。
9 * システムエンジニアを目指す初心者の方へ、DOMノードの複製について理解を深めてもらうことを目的とします。
10 */
11function demonstrateDomTextCloneNode(): void
12{
13    // 1. 新しいDOMDocumentを作成
14    $dom = new DOMDocument('1.0', 'UTF-8');
15    $dom->formatOutput = true; // 出力XMLを見やすく整形
16
17    // 2. ルート要素を作成し、DOMDocumentに追加
18    $root = $dom->createElement('container');
19    $dom->appendChild($root);
20
21    // 3. 元となるDOMTextノードを作成し、ルート要素に追加
22    $originalText = $dom->createTextNode('これは元のテキストノードです。');
23    $root->appendChild($originalText);
24
25    echo "--- 元のDOM構造 ---\n";
26    echo $dom->saveXML();
27    echo "\n";
28
29    // 4. DOMText::cloneNode() を使用して、テキストノードのクローンを作成
30    //    引数 $deep は、子ノードも複製するかどうかを決めます。
31    //    DOMTextノードは子ノードを持たないため、falseを指定してもtrueを指定しても結果は同じです。
32    //    ここでは、シンプルにノード自身のみを複製するため false を指定します。
33    $clonedText = $originalText->cloneNode(false);
34
35    // クローンされたノードの値を変更
36    $clonedText->nodeValue = 'これはクローンされたテキストノードです。';
37
38    // 5. クローンされたノードをDOMツリーの別の場所に追加
39    //    ここでは、元のノードと同じ親要素の末尾に追加します。
40    $root->appendChild($dom->createElement('separator', '---')); // 区切り要素を追加
41    $root->appendChild($clonedText);
42
43    echo "--- クローン後のDOM構造 ---\n";
44    echo $dom->saveXML();
45    echo "\n";
46
47    echo "元のテキストノードの値: " . $originalText->nodeValue . "\n";
48    echo "クローンされたテキストノードの値: " . $clonedText->nodeValue . "\n";
49
50    // 補足: 元のノードとクローンされたノードは異なるオブジェクトインスタンスです。
51    // 一方を変更してももう一方には影響しません。
52    if ($originalText !== $clonedText) {
53        echo "補足: 元のノードとクローンされたノードは異なるオブジェクトインスタンスです。\n";
54    }
55}
56
57// 関数を実行して、DOMText::cloneNode() の動作を確認
58demonstrateDomTextCloneNode();

PHPのDOMText::cloneNode()メソッドは、DOMツリー内に存在するテキストノードを複製するために使われます。これは、通常のPHPオブジェクトの複製に使うcloneキーワードとは異なり、DOMツリー内のノードを複製するための専用メソッドです。

このメソッドは、呼び出し元のDOMTextノードの内容をそのままコピーした新しいDOMTextノードを作成し、DOMNodeオブジェクトとして返します。引数$deepは、そのノードが子ノードを持つ場合に、子ノードも再帰的に複製するかどうかをtrue（複製する）またはfalse（複製しない）で指定しますが、DOMTextノード自体は子ノードを持たないため、この引数の値に関わらず常にノード自身のみが複製されます。デフォルト値はfalseです。

複製されたノードは元のノードとは完全に独立した新しいオブジェクトインスタンスです。そのため、クローンされたノードの内容を変更しても元のノードには影響せず、その逆も同様です。複製したノードは、DOMツリーの別の場所に追加して、既存の構造を損なうことなく新しいコンテンツとして利用できます。DOMツリー内の要素を効率的に再利用したり、複雑な構造を動的に操作したりする際に役立ちます。

このサンプルは、DOMツリー内のテキストノードを複製するDOMText::cloneNode()メソッドの利用法を示しています。PHPにはオブジェクトを複製する一般的なcloneキーワードがありますが、DOMノードの複製にはこのcloneNode()メソッドを使いますので混同しないよう注意してください。DOMTextノードは子ノードを持たないため、引数$deepにtrueを指定してもfalseを指定しても結果に違いはありません。複製されたノードは元のノードとは完全に独立した新しいオブジェクトインスタンスとなるため、一方の内容を変更してももう一方には影響しません。また、複製しただけではDOMツリーには追加されないため、必要に応じてappendChild()などで明示的にツリーへ組み込む必要があります。

PHP DOMText cloneNode でノードを複製する


1<?php
2
3// DOMDocument オブジェクトを作成し、HTML文書として扱う設定
4$dom = new DOMDocument('1.0', 'UTF-8');
5$dom->formatOutput = true; // 出力を見やすく整形する設定
6
7// HTMLのルート要素<html>を作成し、DOMに追加
8$html = $dom->createElement('html');
9$dom->appendChild($html);
10
11// <body>要素を作成し、<html>要素に追加
12$body = $dom->createElement('body');
13$html->appendChild($body);
14
15// 元となるDOMTextノードを作成し、<body>要素に追加
16// このノードを複製してみます。
17$originalTextNode = $dom->createTextNode('これは元のテキストです。');
18$body->appendChild($originalTextNode);
19
20echo "--- 元のDOMツリーの状態 ---\n";
21// HTMLとして解釈されないように、htmlspecialchars()でエスケープして表示
22echo htmlspecialchars($dom->saveHTML()) . "\n\n";
23
24// DOMText::cloneNode() メソッドを使用して、元のテキストノードを複製します。
25// DOMTextノードは子ノードを持たないため、$deep 引数（デフォルトはfalse）は結果に影響しません。
26// 戻り値はDOMNode型ですが、実際にはDOMTextのインスタンスになります。
27$clonedTextNode = $originalTextNode->cloneNode();
28
29// 複製されたノードが元のノードと異なるインスタンスであることを確認
30echo "--- 複製されたノードの情報 ---\n";
31echo "元のテキストノードのデータ: '{$originalTextNode->data}'\n";
32echo "複製されたテキストノードのデータ: '{$clonedTextNode->data}'\n";
33echo "元のノードと複製されたノードは同じオブジェクトですか？ " . ($originalTextNode === $clonedTextNode ? 'はい' : 'いいえ') . "\n\n";
34
35// 複製されたテキストノードをDOMツリーの別の場所に追加して利用する例
36// 新しい<p>要素を作成し、その中に複製されたテキストノードを追加します。
37$paragraph = $dom->createElement('p');
38$paragraph->appendChild($clonedTextNode); // 複製されたノードを<p>要素の子として追加
39$body->appendChild($paragraph); // <p>要素を<body>要素に追加
40
41echo "--- 複製されたノードを追加後のDOMツリーの状態 ---\n";
42echo htmlspecialchars($dom->saveHTML()) . "\n";
43
44?>

このPHPサンプルコードは、HTML文書のテキスト部分を表すDOMTextノードを複製するDOMText::cloneNode()メソッドの基本的な使い方を示しています。まず、DOMDocumentオブジェクトを用いて簡単なHTML構造を構築し、<body>要素内に「これは元のテキストです。」という内容のDOMTextノード（$originalTextNode）を作成します。

次に、$originalTextNode->cloneNode()を呼び出すことで、元のテキストノードの新しいコピー（$clonedTextNode）を作成します。このメソッドはノードを複製し、複製されたノード（この場合はDOMTextのインスタンス）をDOMNode型として返します。引数$deepは子ノードも再帰的に複製するかどうかを指定しますが、DOMTextノードは子ノードを持たないため、この引数の値は結果に影響しません。

複製された$clonedTextNodeは、元の$originalTextNodeとは独立した別のオブジェクトです。サンプルコードでは、この複製されたテキストノードを新しい<p>要素に追加し、それを<body>要素に配置しています。これにより、元のテキストコンテンツをDOMツリーの別の場所で再利用し、柔軟に文書構造を操作できることが確認できます。

DOMText::cloneNode()は、既存のDOMTextノードの内容を保ったまま、完全に独立した新しいDOMTextノードを作成します。これにより、元のノードに一切影響を与えることなく、複製したノードをDOMツリーの別の場所で再利用できます。複製されたノードは、元のノードとは異なるオブジェクトとして扱われます。DOMTextノードは子ノードを持たないため、引数$deep（デフォルトはfalse）は複製結果に影響しません。戻り値の型はDOMNodeですが、実際には元のノードと同じDOMTextのインスタンスが返されます。このメソッドは、同じテキスト内容をDOMツリーの複数の箇所に効率的に配置したい場合に有効です。