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

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

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

基本的な使い方

appendメソッドは、DOMツリー内で、親ノードの末尾に新しい子ノードを追加するメソッドです。このメソッドは、HTMLやXML文書の構造をプログラムから操作する際に非常に便利に利用できます。DOMParentNodeインターフェースを実装するノード、例えばDOMElement（HTMLのタグなど）やDOMDocumentの一部などで使用することが可能です。

引数として、追加したいDOMNodeオブジェクト、あるいは単に追加したいテキストを表す文字列を一つ、または複数指定できます。もし文字列が渡された場合、その文字列は自動的にテキストノードとして作成され、指定された親ノードの既存の子ノードの最後に追記されます。既存のDOMNodeオブジェクトを追加する際には、もしそのノードが既にDOMツリー内の別の場所に存在していれば、元の位置から削除されて、このメソッドが呼び出された親ノードの末尾に移動します。

このメソッドは、動的にウェブページの内容を生成したり、既存の文書構造に要素やテキストを容易に追加したりする場面で活用されます。これにより、DOM構造を簡潔に、かつ効率的に変更することが可能となります。このメソッドは操作結果を直接返すことはありません。

構文(syntax)


1<?php
2$dom = new DOMDocument();
3$parentNode = $dom->createElement('div');
4$parentNode->append('これはテキストノードです', $dom->createElement('span', 'これは要素ノードです'));
5?>

引数(parameters)

DOMNode|string ...$nodes

DOMNode|string $nodes: 追加するノードまたはHTML文字列。可変長引数で複数指定可能です。

戻り値(return)

void

DOMParentNode::append メソッドは、指定されたノードをこのノードの末尾に追加します。このメソッドは値を返しません。

サンプルコード

PHP DOMParentNode::append で要素を追加する


1<?php
2
3/**
4 * DOMParentNode::append メソッドの使用例を示します。
5 * このメソッドは、指定されたノードまたは文字列を、呼び出し元のノードの子として末尾に追加します。
6 * DOMParentNode を実装するクラス（例: DOMElement, DOMDocumentFragment）で利用できます。
7 */
8function demonstrateDomAppend(): void
9{
10    // 1. DOMDocument オブジェクトを新規作成
11    // HTML5 のドキュメントとして初期化し、UTF-8 エンコーディングを指定します。
12    $dom = new DOMDocument('1.0', 'UTF-8');
13    // 出力時に整形されるように設定します。
14    $dom->formatOutput = true;
15
16    // 2. ルート要素（ここでは <body>）を作成し、ドキュメントに追加
17    $body = $dom->createElement('body');
18    $dom->appendChild($body);
19
20    // 3. DOMParentNode::append メソッドを使用して子ノードや文字列を追加します。
21    // body 要素が DOMParentNode インターフェースを実装しているため、append メソッドを呼び出せます。
22
23    // 文字列を直接追加する例:
24    // この文字列は自動的にテキストノードに変換されて追加されます。
25    $body->append('<h1>DOMParentNode::append のデモンストレーション</h1>');
26
27    // 新しい DOMElement オブジェクトを作成して追加する例:
28    $paragraph1 = $dom->createElement('p', 'これは append メソッドで追加された最初の段落です。');
29    $body->append($paragraph1);
30
31    // 複数のノードや文字列を一度に追加する例:
32    // 引数は可変長引数として DOMNode オブジェクトまたは文字列を受け取ります。
33    $divElement = $dom->createElement('div', 'この div は append メソッドで追加されました。');
34    $spanElement = $dom->createElement('span', 'そして、この span も同様です。');
35    $body->append(
36        $divElement,
37        $spanElement,
38        '直接追加された最後のテキスト文字列です。'
39    );
40
41    // 4. 生成されたDOM構造をHTML形式で出力
42    // この出力はWebブラウザで表示したり、ファイルに保存したりできます。
43    echo $dom->saveHTML();
44}
45
46// 関数を実行して、DOM操作の結果を確認します。
47demonstrateDomAppend();
48

PHP 8のDOMParentNode::appendメソッドは、HTMLやXML文書の構造をプログラムで操作する際に利用する機能です。このメソッドは、DOMElementやDOMDocumentFragmentなど、DOMParentNodeインターフェースを実装するオブジェクトに適用されます。

その主な役割は、呼び出し元のノード（親ノード）の末尾に、新しい子ノードまたは文字列を追加することです。引数には、追加したいDOMNodeオブジェクトまたは文字列を、可変長引数として一つ以上指定できます。文字列が渡された場合、それは自動的にテキストノードに変換されて追加されます。このメソッドは処理を終えると何も返しません（戻り値はvoid型です）。

サンプルコードでは、まずDOMDocumentオブジェクトを作成し、HTML5のドキュメントの土台を準備しています。次に、<body>要素を作成してドキュメントに追加し、この<body>要素に対してappendメソッドを呼び出しています。具体的には、「DOMParentNode::append のデモンストレーション」という<h1>タグのテキストのように文字列を直接追加したり、「これは append メソッドで追加された最初の段落です。」のようなテキストを持つ<p>タグのDOMElementオブジェクトを追加したりしています。また、複数の引数として<div>要素、<span>要素、および文字列を一度に渡すことで、複数の子要素をまとめて追加できる様子も示されています。最終的に、構築されたDOM構造がHTML形式で出力され、Webコンテンツを動的に生成する際の基盤となる操作が理解できます。

このappendメソッドは、HTMLやXMLなどの文書構造（DOM）に要素を追加する際に使用します。PHPの配列に値を追加する操作とは目的が異なりますのでご注意ください。引数には、既存のDOMノードや追加したい文字列を複数指定できます。文字列は自動的にテキストノードとして追加されます。このメソッドは何も返しません（void）ので、続けて別のメソッドを呼び出すことはできません。DOM操作はウェブアプリケーション開発で重要ですが、まずDOMの基本的な構造と概念を理解してから取り組むと、より安全で正確なコードが書けるようになります。

PHP DOM要素へ文字列をappendする


1<?php
2
3/**
4 * DOMParentNode::append メソッドのサンプルコード
5 * DOM要素に文字列やDOMノードを追加する方法を示します。
6 * 「php append to string」のキーワードに基づき、特にDOM要素に文字列を追加する例に焦点を当てます。
7 */
8function demonstrateDomAppend(): void
9{
10    // 新しいDOMDocumentオブジェクトを作成します。
11    // '1.0'はXMLバージョン、'UTF-8'はエンコーディングです。
12    $dom = new DOMDocument('1.0', 'UTF-8');
13
14    // 生成されるHTMLを見やすくするために、フォーマットを有効にします。
15    $dom->formatOutput = true;
16
17    // 新しい<body>要素を作成し、DOMドキュメントに追加します。
18    $bodyElement = $dom->createElement('body');
19    $dom->appendChild($bodyElement);
20
21    // 新しい<p>要素を作成し、<body>要素の子として追加します。
22    // DOMParentNode::append メソッドはDOMElementクラスで利用できます。
23    $paragraphElement = $dom->createElement('p');
24    $bodyElement->appendChild($paragraphElement);
25
26    // DOMParentNode::append メソッドを使用して、<p>要素の末尾に文字列を追加します。
27    // これが「php append to string」というキーワードが意図する主要な操作です。
28    $paragraphElement->append('これは最初のテキストコンテンツです。');
29
30    // append メソッドは複数の引数を受け取ることができます。
31    // 複数の文字列を一度に追加することも可能です。
32    $paragraphElement->append(' 次に、', '追加のテキストが続きます。');
33
34    // 文字列だけでなく、DOMNodeオブジェクトも追加できます。
35    // 例えば、<strong>要素を作成して追加してみます。
36    $strongElement = $dom->createElement('strong', '強調された部分');
37    $paragraphElement->append($strongElement);
38
39    // さらに別の文字列を追加して、DOM要素のコンテンツを完成させます。
40    $paragraphElement->append(' そして、このテキストで最後です。');
41
42    // 構築されたDOMツリーをHTML文字列として出力します。
43    // これにより、appendメソッドによって要素がどのように変更されたかを確認できます。
44    echo $dom->saveHTML();
45}
46
47// 関数を実行し、サンプルコードの動作を確認します。
48demonstrateDomAppend();

DOMParentNode::appendメソッドは、HTMLやXMLドキュメントの構造を操作する際に、特定のDOM要素の末尾に新しいコンテンツを追加するための機能です。主に、既存のDOM要素にテキスト文字列や別のDOM要素（ノード）を追記する際に利用されます。特に「php append to string」というキーワードが示すように、動的に文字列をDOM要素内に追加する用途で非常に便利です。

このメソッドはDOMNodeまたはstring型の引数を複数受け取ることができます。これにより、文字列とDOMノードを組み合わせて、一度にまとめて追記することが可能です。例えば、サンプルコードでは、<p>要素に対して複数の文字列を続けて追加したり、<strong>要素のような別のDOMノードを追加したりしています。

戻り値はvoid型であり、このメソッド自体は何も値を返しません。操作の結果は、対象のDOM要素が変更されることで反映されます。

サンプルコードでは、DOMDocumentを作成し、<body>要素と<p>要素を構築しています。そして、<p>要素に対してappendメソッドを複数回使用し、異なる文字列や作成した<strong>要素をその都度追加しています。最終的にsaveHTML()で出力されるHTMLを見ることで、appendメソッドによって要素のコンテンツがどのように構築・変更されたかを確認できます。この機能を使うことで、PHPで動的にHTMLコンテンツを柔軟に生成・編集できます。

DOMParentNode::appendメソッドは、一般的なPHPの文字列結合とは異なり、HTML要素などのDOMノードの末尾に文字列や他のDOMノードを追加するためのものです。このメソッドの主な用途は、DOMツリーを構築・操作することにあります。引数には文字列とDOMNodeオブジェクトの両方を複数個指定して一度に追加できますが、追加される文字列のHTML特殊文字は自動的にエスケープされません。そのため、ユーザーからの入力を直接追加する際は、セキュリティ上のリスクを避けるため、必ず適切なエスケープ処理を行うようにしてください。また、このメソッドの戻り値はvoidであり、メソッドチェーンはできない点にもご留意ください。