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

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

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

基本的な使い方

removeメソッドは、DOMElementノードをその親ノードから削除するメソッドです。このメソッドは、DOM（Document Object Model）を操作する際に、特定の要素をドキュメント構造から取り除くために使用されます。removeメソッドを呼び出すと、対象となるDOMElementオブジェクトが親ノードの子リストから削除され、ドキュメント構造が更新されます。削除されたノードはメモリ上に残りますが、ドキュメントツリーには存在しなくなります。

このメソッドは引数を必要としません。呼び出されたDOMElementオブジェクト自体が削除対象となります。removeメソッドの実行後、DOMElementオブジェクトはドキュメントツリーから切り離されますが、オブジェクト自体は変数に保持されている限り、引き続きアクセス可能です。

removeメソッドは、動的にHTMLやXMLドキュメントを操作し、不要になった要素を削除する際に非常に有効です。例えば、ユーザーの操作に応じて特定の要素を非表示にするのではなく、完全にドキュメントから削除する場合などに使用されます。removeメソッドを使用することで、ドキュメント構造を最適化し、パフォーマンスを向上させることができます。また、セキュリティ上の理由から、不要な情報を削除する際にも役立ちます。

removeメソッドは、DOMElementクラスのメソッドであるため、DOMElementオブジェクトに対してのみ呼び出すことができます。他のDOMノードタイプ（例えば、DOMDocumentやDOMAttrなど）に対しては直接呼び出すことはできません。もし、他のノードタイプを削除したい場合は、そのノードの親ノードからremoveChildメソッドを使用する必要があります。

構文(syntax)


1DOMElement::remove(): void

引数(parameters)

引数なし

引数はありません

戻り値(return)

void

このメソッドは、DOMツリーからこの要素を削除します。戻り値はありません。

サンプルコード

DOMElement::remove() で要素を削除する


1<?php
2
3/**
4 * DOMツリーから特定の要素を削除するサンプルコード。
5 * PHP 8 で追加された DOMElement::remove() メソッドを使用します。
6 * このメソッドは引数を取らず、ターゲットとなる要素自体をDOMツリーから削除します。
7 *
8 * @return void
9 */
10function removeDomElementExample(): void
11{
12    // 1. DOMDocument インスタンスを作成し、HTMLコンテンツをロードします。
13    // LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD は、<body>や<html>タグが自動で追加されるのを防ぎます。
14    $dom = new DOMDocument();
15    $htmlContent = '<div id="container">'
16                 . '<p>これは最初の段落です。</p>'
17                 . '<span id="target-element">この要素が削除されます。</span>'
18                 . '<p>これは最後の段落です。</p>'
19                 . '</div>';
20    $dom->loadHTML($htmlContent, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
21
22    // 2. 削除したい DOMElement を ID を指定して検索します。
23    // getElementById() は DOMDocument のメソッドです。
24    $targetElement = $dom->getElementById('target-element');
25
26    if ($targetElement instanceof DOMElement) {
27        echo "--- 削除前のDOMツリー ---\n";
28        echo $dom->saveHTML() . "\n\n";
29
30        // 3. DOMElement::remove() メソッドを呼び出し、要素をDOMツリーから削除します。
31        // このメソッドは引数を取らず、voidを返します。
32        $targetElement->remove();
33
34        echo "--- 削除後のDOMツリー ---\n";
35        echo $dom->saveHTML() . "\n";
36    } else {
37        echo "削除対象の要素 ('target-element') が見つかりませんでした。\n";
38    }
39}
40
41// サンプル関数を実行します。
42removeDomElementExample();

PHP 8で導入されたDOMElement::remove()メソッドは、HTMLやXMLといった文書構造をプログラムで操作する際に、特定の要素をDOMツリーから簡単に削除するための機能です。このメソッドは、Webページのコンテンツを動的に変更したい場面で非常に役立ちます。

具体的には、DOMツリー内の削除したいDOMElementオブジェクトに対してこのremove()メソッドを呼び出すだけで、その要素とそれに含まれるすべての子要素をDOMツリーから取り除きます。このメソッドは引数を一切必要とせず、呼び出し元となる要素自身が削除されるため、シンプルで直感的に利用できます。また、戻り値はvoid、つまり何も返しません。要素が削除されること自体がメソッドの目的であり、特に処理結果の情報を返す必要がないためです。

提供されたサンプルコードでは、まずHTMLコンテンツをロードしてDOMツリーを構築し、IDが「target-element」である<span>要素を検索しています。その後、この<span>要素に対してremove()メソッドを呼び出すことで、DOMツリーから完全に削除しています。削除前後のDOMツリーを比較することで、<span>要素が実際に消えていることが確認でき、remove()メソッドの効果が明確に理解できます。これにより、特定のコンテンツをWebページから動的に削除する処理を効率的に実装することが可能です。

このサンプルコードは、HTMLなどの構造を表す「DOMツリー」から特定の要素を削除するPHP 8の機能であるDOMElement::remove()メソッドの使い方を示しています。キーワードにある「配列からの要素削除」とは異なり、HTML要素構造に対する操作である点にご注意ください。DOMElement::remove()は、削除したいDOM要素オブジェクト自身から直接呼び出すメソッドで、引数を指定する必要はありません。このメソッドは削除に成功しても何も値を返さない（void）ため、戻り値を確認するコードは不要です。要素が見つからない場合もありますので、getElementById()などの結果が確実にDOMElementのインスタンスであるかを確認してからremove()を呼び出すようにすると、より安全にコードを実行できます。

PHPで文字列のスペースを削除する


1<?php
2
3/**
4 * 与えられた文字列からすべての半角スペースを削除する関数。
5 *
6 * この関数は、PHPの組み込み関数 `str_replace` を使用して、
7 * 文字列中の特定の文字（ここでは半角スペース）を別の文字（ここでは空文字）に
8 * 置換することで、スペースを削除します。
9 *
10 * @param string $text スペースを削除したい元の文字列。
11 * @return string 半角スペースがすべて削除された新しい文字列。
12 */
13function removeSpacesFromString(string $text): string
14{
15    // str_replace 関数は、第1引数で指定された検索文字列を
16    // 第2引数で指定された置換文字列に置き換えます。
17    // 第3引数には、処理対象の元の文字列を指定します。
18    // ここでは、半角スペース (' ') を空文字 ('') に置換しています。
19    return str_replace(' ', '', $text);
20}
21
22// サンプル使用例
23$originalString1 = "  Hello   World  PHP 8 ";
24echo "元の文字列: '" . $originalString1 . "'\n";
25
26// 関数を呼び出してスペースを削除
27$stringWithoutSpaces1 = removeSpacesFromString($originalString1);
28echo "スペース削除後: '" . $stringWithoutSpaces1 . "'\n\n";
29
30$originalString2 = " This is a test string without extra spaces. ";
31echo "元の文字列: '" . $originalString2 . "'\n";
32
33// 別の文字列で関数を呼び出し
34$stringWithoutSpaces2 = removeSpacesFromString($originalString2);
35echo "スペース削除後: '" . $stringWithoutSpaces2 . "'\n";
36
37?>

このPHPサンプルコードは、与えられた文字列からすべての半角スペースを削除する removeSpacesFromString という関数を定義しています。システムエンジニアを目指す方がPHPで文字列を扱う際の基本的な操作を理解するのに役立ちます。

この関数は、引数としてスペースを取り除きたい元の文字列 $text を受け取ります。内部では、PHPの標準関数である str_replace を使用しています。str_replace 関数は、指定した文字列内の特定の文字を別の文字に置き換える機能を持っており、ここでは第一引数で半角スペース (' ') を、第二引数で空文字 ('') に置き換えるように指示しています。そして、第三引数に元の文字列 $text を指定することで、その文字列中の全ての半角スペースが空文字に置換され、結果的にスペースが削除されます。

removeSpacesFromString 関数は、スペースが削除された新しい文字列を戻り値として返します。元の文字列自体が変更されるわけではなく、処理された結果の新しい文字列が生成される点が重要です。例えば、「Hello World PHP」という文字列を渡すと、この関数は「HelloWorldPHP」という文字列を返します。この機能は、データ整形やユーザー入力のクリーンアップなど、多くの場面で活用できる基本的な文字列処理技術です。

ご提示のリファレンス情報 DOMElement::remove はDOM要素の削除に用いられ、本サンプルコードの文字列操作とは機能が異なります。サンプルコードでは、文字列中の半角スペースを空文字に置換するPHPの組み込み関数 str_replace を利用しています。

この関数は元の文字列自体を変更せず、スペースが削除された新しい文字列を返します。そのため、変更後の文字列を利用するには、必ず戻り値を新しい変数に代入してください。str_replace(' ', '', $text) では半角スペースのみが対象となり、全角スペースやタブ文字などは削除されません。これらも削除したい場合は、trim() や正規表現関数 preg_replace() の使用を検討すると良いでしょう。PHP 8の型ヒントは、引数や戻り値の期待される型を明示し、コードの安全性と可読性を高めます。