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

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

作成日: 2025年09月11日更新日: 2026年02月11日

基本的な使い方

appendメソッドは、呼び出し元のDom\ParentNodeオブジェクトに子ノードを追加するメソッドです。このメソッドは、指定されたノードや文字列を、親ノードの既存の子ノードリストの末尾に挿入します。

引数には、既存のDom\Nodeオブジェクト、または追加したいテキストコンテンツを表す文字列を指定できます。文字列が引数として渡された場合、appendメソッドは自動的に新しいテキストノードを作成し、それを親ノードの子として追加します。

このメソッドの大きな特徴は、複数の引数を一度に受け入れられる点です。カンマで区切って複数のDom\Nodeオブジェクトや文字列を渡すことで、それらすべてを親ノードの末尾に、指定された順序で効率的に追加できます。これにより、DOMツリーに複数の要素を連続して追加する際のコードを簡潔に記述でき、記述のしやすさが向上します。

appendメソッドは、HTMLやXMLといったドキュメントの構造をPHPスクリプトから動的に操作し、新しい要素を既存の要素の内部に追加する際に非常に有用です。例えば、ウェブページ上で特定のコンテナ要素に新しい段落や画像を生成して組み込むような場合に利用されます。メソッドは処理が成功しても特定の値を返しません（void）。

構文(syntax)


1<?php
2
3$dom = new DOMDocument();
4$html = $dom->createElement('html');
5$body = $dom->createElement('body');
6$dom->appendChild($html)->appendChild($body);
7
8$elementToAdd = $dom->createElement('p', 'これは追加される段落です。');
9$textToAdd = 'これは追加されるテキストノードです。';
10
11$body->append($elementToAdd, $textToAdd);

引数(parameters)

Dom\Node|string ...$nodes

Dom\Node|string $nodes: 追加するDOMNodeオブジェクトまたは文字列。複数指定可能

戻り値(return)

void

このメソッドは、指定されたノードを現在のノードの最後の子ノードとして追加します。戻り値はありません。

サンプルコード

Dom\ParentNode::append で子要素を追加する


1<?php
2
3/**
4 * DOMツリーに要素やテキストを追加する Dom\ParentNode::append メソッドの利用例。
5 * Dom\ParentNode は DOMDocument, DOMElement などの親ノードの基本インターフェースです。
6 * append メソッドは、指定されたノードまたは文字列を親ノードの末尾に追加します。
7 */
8
9// 1. 新しい DOMDocument インスタンスを作成します。
10//    '1.0' はXMLバージョン、'UTF-8' はエンコーディングを指定します。
11$dom = new DOMDocument('1.0', 'UTF-8');
12// 出力時にXMLを整形して読みやすくするための設定
13$dom->formatOutput = true;
14
15// 2. ドキュメントのルート要素として 'root' 要素を作成し、DOMに追加します。
16$rootElement = $dom->createElement('root');
17$dom->appendChild($rootElement);
18
19// 3. Dom\ParentNode::append メソッドを使用して子要素やテキストを追加します。
20//    $rootElement は Dom\ParentNode インターフェースを実装しているため、append メソッドが使用できます。
21
22// 3.1. テキストノードを append する例
23$textNode = $dom->createTextNode('これは最初のテキストです。');
24$rootElement->append($textNode);
25
26// 3.2. 新しい要素ノードを append する例
27$itemElement = $dom->createElement('item', 'アイテムA');
28$rootElement->append($itemElement);
29
30// 3.3. 複数のノード（要素とテキスト）を一度に append する例
31//      引数に Dom\Node オブジェクトまたは文字列を複数指定できます。
32$anotherItemElement = $dom->createElement('item', 'アイテムB');
33$rootElement->append('さらに別のテキストを追加します。', $anotherItemElement, 'そして最後のテキストです。');
34
35// 4. 完成した DOM 構造を XML 形式で出力して確認します。
36echo $dom->saveXML();
37
38?>

PHP 8のDom\ParentNode::appendメソッドは、XMLやHTMLなどのDOMツリーに新しいノードやテキストを追加する際に利用します。このメソッドは、DOMDocumentやDOMElementといった、子ノードを持つことができる親ノードの基本インターフェースであるDom\ParentNodeを実装するオブジェクトで利用でき、指定された内容を親ノードの末尾に追加します。

引数には、Dom\Nodeオブジェクト（作成済みの要素ノードやテキストノードなど）または通常の文字列を、複数指定することが可能です。これにより、一度の呼び出しで複数の要素やテキストを効率的に追加できます。サンプルコードでは、最初にDOMDocumentを作成し、ルート要素を追加しています。その後、このルート要素に対して、テキストノード、新しい要素ノード、さらに複数の文字列と要素をまとめてappendメソッドで追加しているのがわかります。

戻り値はvoidであり、このメソッドは何も値を返しませんが、呼び出すことでDOMツリーが変更されます。Dom\ParentNode::appendは、柔軟な引数指定により、既存のノードに新たな子要素やテキストを簡単に追加できるため、DOMツリーを構築・操作する上で非常に便利な機能を提供します。

PHPのDom\ParentNode::appendメソッドは、XMLやHTMLのDOMツリーに、新しい要素ノードやテキストノードを追加するために使われます。引数にはDom\Nodeオブジェクトか文字列を指定し、これらを現在のノードの末尾に一つ、または複数まとめて追加できます。特に、文字列を直接渡すと自動的にテキストノードとして扱われますが、意図しない挙動を防ぐため、数値などを追加する際は事前に文字列に変換することを推奨します。このメソッドは何も値を返さない（void）ため、処理結果を変数に代入しようとしないでください。通常のPHPの配列操作とは異なる、DOM構造を操作する専用の機能であることを理解して活用してください。

PHPでHTML要素に文字列を追加する


1<?php
2
3/**
4 * Dom\ParentNode::append メソッドの使用例。
5 * このメソッドは、指定されたDOM要素に新しいノードまたはテキスト文字列を追加します。
6 * キーワード「php append to string」に関連し、
7 * HTML要素に文字列コンテンツを追加する方法を示します。
8 */
9
10// 1. 新しいDOMドキュメントを作成します。
11//    '1.0' はXMLバージョン、'UTF-8' はエンコーディングを指定します。
12$dom = new DOMDocument('1.0', 'UTF-8');
13
14// 2. 出力時にHTMLが整形されるように設定します。
15//    これにより、`saveHTML()` メソッドの出力が読みやすくなります。
16$dom->formatOutput = true;
17
18// 3. HTMLのルート要素となる`<body>`要素を作成し、ドキュメントに追加します。
19//    この`$body`オブジェクトは`Dom\ParentNode`インターフェースを実装しているため、
20//    `append` メソッドを使用できます。
21$body = $dom->createElement('body');
22$dom->appendChild($body);
23
24// 4. `Dom\ParentNode::append` メソッドを使用して、
25//    `$body`要素にテキスト文字列やDOMノードを追加します。
26//    このメソッドは可変長引数を受け入れるため、複数の要素を一度に追加できます。
27$body->append(
28    'これは最初のテキストです。', // 最初の文字列コンテンツ
29    'そして、これは後から追加されたテキストです。', // 2番目の文字列コンテンツ
30    $dom->createElement('br'), // HTMLの<br>タグ（DOMノードとして作成）
31    '3番目のテキストは改行後に表示されます。' // 3番目の文字列コンテンツ
32);
33
34// 5. 最終的なHTMLドキュメントの内容を出力します。
35//    `saveHTML()` は、現在のDOMツリーをHTML文字列として返します。
36echo $dom->saveHTML();
37

Dom\ParentNode::append メソッドは、PHP 8で導入された機能で、指定されたDOM要素の末尾に新しいDOMノードやテキスト文字列を追加するために使用されます。このメソッドは、引数としてDom\Node型のオブジェクト、または通常のstring型の文字列を複数受け取ることができます。引数名の...$nodesが示すように、可変長引数として機能するため、一度に複数のコンテンツをまとめて追加できる点が大きな特徴です。メソッドの戻り値はvoidであり、何も値を返しません。単に操作を実行するのみです。

サンプルコードでは、まず新しいDOMドキュメントを作成し、その中にHTMLの<body>要素を準備しています。この<body>要素はDom\ParentNodeインターフェースを実装しているため、appendメソッドを使用できます。コードの実行では、<body>要素に対してappendメソッドを呼び出し、「これは最初のテキストです。」のようなテキスト文字列や、createElementで作成した<br>タグのDOMノードを続けて追加しています。これにより、キーワード「php append to string」が示すように、既存のHTML要素に動的に文字列コンテンツや他のHTML要素を効率的に追加する方法が示されています。最終的にドキュメント全体をHTML形式で出力すると、追加されたテキストと改行タグが正しく配置されていることが確認できます。

このappendメソッドは、HTMLやXMLのような構造化された文書をプログラムで操作するDOM操作専用です。PHPの一般的な文字列連結とは目的が異なりますので、ご注意ください。Dom\ParentNodeインターフェースを実装するオブジェクト（例としてサンプルコードの$body要素）に対してのみ使用でき、指定された要素の末尾に、新しい要素やテキストを追加します。引数として文字列を渡す場合、HTML特殊文字は自動的にエスケープされません。ユーザーからの入力など信頼できない文字列を追加する際には、セキュリティ（XSSなど）のために必ず適切なサニタイズ処理を行うようにしてください。このメソッドは戻り値がないため、追加後の状態確認が必要な場合は、別途DOMツリーの内容を検証する必要があります。PHP 8環境で正しく動作します。