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

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

作成日: 2025年09月11日更新日: 2025年10月29日

基本的な使い方

removeChildメソッドは、指定された子ノードを親ノードから削除するメソッドです。このメソッドは、DOMNodeクラスに属しており、HTMLやXMLといった構造化された文書をプログラムで操作するDOM（Document Object Model）の主要な機能の一つとして提供されています。

具体的には、あるDOMNodeインスタンス（親ノード）に対してこのメソッドを呼び出し、削除したい別のDOMNodeインスタンス（子ノード）を引数として渡すことで、その子ノードを親ノードから切り離します。これにより、文書ツリーの中から指定した要素が取り除かれ、ウェブページの表示内容を変更したり、XMLデータの一部を更新したりといった操作が可能になります。例えば、ウェブサイトから特定の画像や段落を動的に消したい場合にこのメソッドが利用できます。

引数には、削除したい子ノードのDOMNodeオブジェクトを指定します。メソッドが正常に実行されると、削除されたDOMNodeオブジェクトが戻り値として返されます。この戻り値を利用することで、削除したノードをメモリ上に保持し、後で別の場所に追加し直したり、そのノードの情報を参照したりすることが可能です。

注意点として、削除しようとするノードが、このメソッドを呼び出したDOMNodeインスタンスの直接の子ではない場合、DOMExceptionというエラーが発生します。そのため、削除する前に、対象のノードが本当に子ノードであることを確認することが重要です。PHP 8の環境では、DOM拡張機能の一部としてこのメソッドが安定して利用でき、文書構造の動的な操作において非常に重要な役割を果たします。

構文(syntax)


1$parentNode->removeChild($childNode);

引数(parameters)

DOMNode $child

DOMNode $child: 削除したい子ノードを指定するDOMNodeオブジェクト

戻り値(return)

DOMNode

削除された子ノードを返します。

サンプルコード

PHP DOM removeChildで要素を削除する


1<?php
2
3/**
4 * DOMNode::removeChild メソッドの使用例
5 * 親ノードから特定の子ノードを削除する方法を示します。
6 */
7
8// 1. 新しいDOMDocumentインスタンスを作成
9$dom = new DOMDocument();
10
11// 2. HTML文字列をロード
12// これにより、DOMツリーが構築されます。
13$htmlString = '
14<!DOCTYPE html>
15<html>
16<head>
17    <title>PHP DOM removeChild Example</title>
18</head>
19<body>
20    <div id="container">
21        <p>これは最初の段落です。</p>
22        <p id="targetParagraph">この段落は削除されます。</p>
23        <span>これは削除されないスパン要素です。</span>
24        <p>これは最後の段落です。</p>
25    </div>
26</body>
27</html>
28';
29$dom->loadHTML($htmlString);
30
31// 3. 削除したい要素をIDで取得
32// getElementByIdメソッドは、ID属性を持つ要素を検索します。
33$targetElement = $dom->getElementById('targetParagraph');
34
35// 4. ターゲット要素が見つかり、その親ノードが存在する場合のみ処理を実行
36// removeChildは親ノードから呼び出す必要があるため、親ノードの存在も確認します。
37if ($targetElement instanceof DOMNode && $targetElement->parentNode instanceof DOMNode) {
38    echo "--- 削除前のHTML ---\n";
39    // saveHTML()で現在のDOMツリーのHTML表現を取得します。
40    echo $dom->saveHTML() . "\n";
41
42    // 5. 親ノードから子ノードを削除
43    // removeChildメソッドは、削除されたノード自体を返します。
44    $removedNode = $targetElement->parentNode->removeChild($targetElement);
45
46    echo "--- 削除後のHTML ---\n";
47    echo $dom->saveHTML() . "\n";
48
49    echo "--- 削除されたノードの内容 ---\n";
50    // 削除されたノードが依然としてメモリ上にオブジェクトとして存在することを確認できます。
51    echo $dom->saveHTML($removedNode) . "\n";
52
53} else {
54    echo "エラー: 削除対象の要素またはその親が見つかりませんでした。\n";
55}
56
57?>

DOMNode::removeChildメソッドは、HTMLやXMLドキュメントの構造を操作するPHPの機能で、特定の要素（ノード）をその親ノードから削除するために使用されます。

このサンプルコードでは、DOMDocumentクラスを用いてHTML文字列をメモリ上に読み込み、操作可能なDOMツリーを構築します。そして、getElementByIdメソッドを使って、IDがtargetParagraphである削除したい<p>要素を取得しています。

removeChildメソッドを呼び出す際には、削除したい子ノードを保持している親ノードから呼び出す必要があります。引数には、親ノードから削除したいDOMNodeオブジェクト（ここでは$targetElement）を指定します。メソッドが実行されると、指定された子ノードは親ノードの子リストから削除されます。

このメソッドの戻り値は、削除された子ノード自身です。これにより、削除されたノードの内容を後から参照したり、別の場所に挿入したりといった再利用が可能になります。サンプルコードでは、削除前後のHTMLの状態を表示し、さらに削除されたノードがメモリ上には依然として存在し、その内容も確認できることを示しています。この機能は、Webページ上で要素を動的に削除する際に、非常に役立ちます。

DOMNode::removeChildメソッドは、特定の子ノードを親ノードから削除する際に使用します。このメソッドは、削除したい「子ノード自身」からではなく、「その子ノードの親」から呼び出す必要があります。サンプルコードのように、削除したい要素が見つかったら、まずその親ノードを取得し、親ノードに対してremoveChildを実行してください。また、削除対象のノードやその親ノードが存在しない状態で呼び出すとエラーになるため、必ず事前に存在を確認してから処理を実行するように注意しましょう。removeChildは削除されたノード自体を返しますが、これはDOMツリーから切り離されただけで、メモリ上にはまだ存在しています。不完全なHTMLをloadHTMLでパースすると、予期せぬDOMツリーが生成される場合があるため、入力HTMLの構造にも留意が必要です。