【PHP8.x】nextSiblingプロパティの使い方

nextSiblingプロパティの使い方について、初心者にもわかりやすく解説します。

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

基本的な使い方

nextSiblingプロパティは、DOMCharacterDataオブジェクトの次の兄弟ノードを保持するプロパティです。DOMCharacterDataは、テキストデータ（例えばテキストノードやコメントノード）を扱うための抽象クラスであり、このクラスを継承したオブジェクトが保持するテキストデータの次の兄弟ノードを取得するために使用されます。

具体的には、DOMCharacterDataオブジェクトがDOMツリー構造の一部である場合、nextSiblingプロパティはそのオブジェクトの親ノードの子ノードリストにおける、すぐ次のノードへの参照を保持します。もし、そのオブジェクトが親ノードの子ノードリストの最後のノードである場合、nextSiblingプロパティはnullを返します。

このプロパティは読み取り専用であり、値を変更することはできません。DOMCharacterDataオブジェクトの次の兄弟ノードにアクセスする場合に利用します。例えば、特定のテキストノードの次のノードが要素ノードであるか、別のテキストノードであるかなどを確認する際に使用できます。

システムエンジニアを目指す初心者の方にとっては、DOMツリー構造におけるノード間の関係性を理解する上で重要なプロパティです。DOMを操作する際に、あるノードから別のノードへ移動したり、ノードの情報を取得したりする処理で役立ちます。XMLやHTMLドキュメントをプログラムで処理する際に、このプロパティを理解していると、より柔軟なデータ操作が可能になります。

構文(syntax)


1DOMCharacterData::nextSibling;

引数(parameters)

引数なし

引数はありません

戻り値(return)

DOMNode|null

DOMCharacterDataオブジェクトの次の兄弟ノードを返します。兄弟ノードがない場合はnullを返します。

サンプルコード

PHP DOM nextSibling を取得する


1<?php
2
3/**
4 * DOMCharacterData::nextSibling プロパティの使用例を示します。
5 *
6 * このプロパティは、現在のノードのすぐ次にある兄弟ノード (DOMNode) を返します。
7 * 次の兄弟ノードが存在しない場合や、ノードがDOMツリーに属していない場合は null を返します。
8 * DOMCharacterDataは、テキストノード (DOMText) やコメントノード (DOMComment) などの基底クラスです。
9 */
10function demonstrateDomCharacterDataNextSibling(): void
11{
12    // 様々な種類のノードが兄弟関係を持つシンプルなHTML構造を定義します。
13    $html = <<<HTML
14<p>
15    最初のテキストノードです。
16    <!-- これはコメントノードです -->
17    <span>これは要素ノードです。</span>
18    最後のテキストノードです。
19</p>
20HTML;
21
22    // DOMDocumentオブジェクトを作成し、HTML文字列を解析してDOMツリーを構築します。
23    // loadHTML() はHTMLが不完全な場合などに警告を出すことがあるため、@で抑制しています。
24    $dom = new DOMDocument();
25    @$dom->loadHTML($html);
26
27    // ドキュメントから最初の <p> 要素を取得します。
28    $paragraph = $dom->getElementsByTagName('p')->item(0);
29
30    if ($paragraph) {
31        echo "--- <p>要素内のノードとその nextSibling の関係 ---\n\n";
32
33        // <p>要素の全ての子ノードを反復処理します。
34        // 子ノードには、DOMText（空白や実際のテキスト）、DOMComment、DOMElementなどが含まれます。
35        foreach ($paragraph->childNodes as $node) {
36            // 現在のノードの種類と値を表示します。
37            // nodeValueは改行や余分な空白を含むことがあるため、trim()で整形して表示します。
38            echo "現在のノード: " . $node->nodeName;
39            echo " (値: '" . trim($node->nodeValue) . "')\n";
40
41            // nextSibling プロパティを使用して、現在のノードの次の兄弟ノードを取得します。
42            // 戻り値は DOMNode オブジェクトか、次の兄弟ノードがない場合は null です。
43            $nextSibling = $node->nextSibling;
44
45            if ($nextSibling instanceof DOMNode) {
46                // 次の兄弟ノードが存在する場合、その種類と値を表示します。
47                echo "  -> nextSibling: " . $nextSibling->nodeName;
48                echo " (値: '" . trim($nextSibling->nodeValue) . "')\n";
49            } else {
50                // 次の兄弟ノードが存在しない場合 (例: リストの最後のノード)、null と表示します。
51                echo "  -> nextSibling: なし (null)\n";
52            }
53            echo "\n"; // 各ノードの情報間に空行を挿入して見やすくします。
54        }
55    } else {
56        echo "エラー: HTMLの <p> 要素が見つかりませんでした。\n";
57    }
58}
59
60// 上で定義した関数を実行し、DOMCharacterData::nextSibling の動作を確認します。
61demonstrateDomCharacterDataNextSibling();
62

PHP 8のDOMCharacterData::nextSiblingプロパティは、現在のノードのDOMツリー上における、すぐ次に位置する兄弟ノードを取得するために使用されます。このプロパティは引数を持ちません。DOMCharacterDataは、HTMLやXMLドキュメント内のテキストノードやコメントノードといった文字データを扱うノードの基底クラスです。

nextSiblingプロパティは、次の兄弟ノードが存在する場合はそのDOMNodeオブジェクトを返します。もし次の兄弟ノードが存在しない場合や、現在のノードがDOMツリーに属していない場合はnullを返します。

提供されたサンプルコードでは、シンプルなHTML構造をDOMDocumentに読み込み、<p>要素の子ノードを一つずつ処理しています。各ノードについてnextSiblingプロパティを呼び出し、そのノードの次の兄弟がどのような種類で、どのような値を持っているかを表示しています。これにより、テキストノード、コメントノード、要素ノードがそれぞれどのように次の兄弟ノードを持つか、またリストの最後のノードではnullが返される挙動を確認することができます。このプロパティは、DOMツリーを順方向にたどる際に非常に役立ちます。

PHPのDOMCharacterData::nextSiblingは、現在のノードのすぐ次にある兄弟ノードを取得する際に使われるプロパティです。このプロパティはDOMNodeクラスに定義されており、テキストノード、コメントノード、要素ノードなど全てのノードタイプに適用されます。HTMLソース上の改行やインデントもDOMTextノードとして扱われるため、見た目上の次の要素だけでなく、空白のテキストノードが返される可能性がある点に注意してください。また、兄弟ノードがもう存在しない場合はnullを返しますので、利用前には必ずnullチェックを行い、安全に処理を進める必要があります。サンプルコードのDOMDocument::loadHTML()での警告抑制@は、本番環境では適切なエラーハンドリングに置き換えることを推奨します。