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

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

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

基本的な使い方

nextSiblingプロパティは、DOMDocumentクラスのノードにおける、次の兄弟ノードを保持するプロパティです。DOM（Document Object Model）は、HTMLやXMLドキュメントをプログラムから操作するためのAPIであり、ドキュメントをノードと呼ばれる要素のツリー構造として扱います。兄弟ノードとは、同じ親ノードを持つノードのことです。

このnextSiblingプロパティを使用することで、DOMDocument内で特定のノードから見て、すぐ後ろに位置する兄弟ノードにアクセスできます。もし対象のノードが兄弟ノードを持たない場合、nextSiblingプロパティはnullを返します。

システムエンジニアを目指す初心者の方にとって、このプロパティはDOMを操作する上で非常に重要です。例えば、HTMLドキュメント内の特定の要素の次に配置された要素を取得したり、XMLドキュメントの構造を順番に解析したりする際に役立ちます。

具体的な使用例としては、ある要素の属性を調べて、その次の要素のテキストコンテンツを取得する、といった処理が考えられます。また、DOMDocumentを操作する他のメソッドと組み合わせることで、複雑なドキュメント構造の操作や変更を効率的に行うことができます。

nextSiblingプロパティを理解し、適切に利用することで、PHPを用いたWebアプリケーション開発において、より柔軟で高度なドキュメント処理が可能になります。ドキュメントの解析、変換、生成など、様々な場面で活用できるため、しっかりと学習しておくことをお勧めします。

構文(syntax)


1DOMNode|null DOMDocument::$nextSibling;

引数(parameters)

引数なし

引数はありません

戻り値(return)

DOMNode|null

現在のノードの直後にある兄弟ノード、または兄弟ノードが存在しない場合は null を返します。

サンプルコード

PHP DOMDocument nextSibling で次の要素を取得する


1<?php
2
3// DOMDocument を作成
4$dom = new DOMDocument();
5
6// XML 文字列をロード
7$dom->loadXML('<root><item id="1">One</item><item id="2">Two</item><item id="3">Three</item></root>');
8
9// 最初の item 要素を取得
10$firstItem = $dom->documentElement->firstChild;
11
12// 最初の item の次の兄弟要素を取得
13$nextItem = $firstItem->nextSibling;
14
15// 次の兄弟要素が存在するか確認し、テキストコンテンツを表示
16if ($nextItem) {
17  echo "次の兄弟要素: " . $nextItem->textContent . PHP_EOL;
18} else {
19  echo "次の兄弟要素は存在しません。" . PHP_EOL;
20}
21
22?>

このサンプルコードは、PHPのDOMDocumentクラスにおけるnextSiblingプロパティの使用例を示しています。nextSiblingは、あるノードの直後の兄弟ノードを取得するために使用されます。兄弟ノードとは、同じ親を持つノードのことです。

まず、DOMDocumentオブジェクトを作成し、loadXML()メソッドを使ってXML文字列をロードします。次に、documentElementプロパティとfirstChildプロパティを使用して、最初のitem要素を取得します。

$firstItem->nextSiblingによって、最初のitem要素の次の兄弟ノードを取得し、$nextItem変数に格納します。nextSiblingは、兄弟ノードが存在する場合はDOMNodeオブジェクトを返し、存在しない場合はnullを返します。

コードでは、if文を使って$nextItemが存在するかどうかを確認しています。存在する場合、textContentプロパティを使用して、次の兄弟要素のテキストコンテンツを表示します。存在しない場合は、「次の兄弟要素は存在しません。」というメッセージを表示します。この例では、"次の兄弟要素: Two" が出力されます。

このようにnextSiblingプロパティを使用することで、DOMツリー内を移動し、特定のノードの兄弟要素にアクセスできます。XMLデータの構造を解析し、必要な情報を抽出する際に役立ちます。nextSiblingは引数を取らず、直後の兄弟ノードを返します。

nextSiblingは、あるノードの直後の兄弟ノードを取得するメソッドです。兄弟ノードが存在しない場合はnullを返します。サンプルコードでは、if ($nextItem)でnullチェックを行っていますが、これを省略すると、存在しないノードのプロパティにアクセスしようとしてエラーが発生する可能性があります。nextSiblingを使用する際は、必ず返り値がnullでないことを確認してから、そのプロパティやメソッドにアクセスするようにしてください。また、XML構造によっては、テキストノードやコメントノードなどが兄弟ノードとして存在する場合があるため、想定外のノードが取得される可能性があることに注意が必要です。目的の要素の種類をチェックするなど、より厳密な処理が必要となる場合もあります。

PHP DOM nextSiblingで兄弟ノードを辿る


1<?php
2
3/**
4 * DOMDocumentのnextSiblingプロパティの使用例を示します。
5 *
6 * この関数は、HTMLリスト内の最初の要素から開始し、
7 * nextSiblingプロパティを使って後続のすべての兄弟要素を順に取得して表示します。
8 */
9function displayHtmlListSiblings(): void
10{
11    // 操作対象となるHTML文字列を定義
12    $html = <<<HTML
13    <!DOCTYPE html>
14    <html>
15    <body>
16    
17    <h1>フルーツリスト</h1>
18    <ul>
19      <li>リンゴ</li>
20      <li>オレンジ</li>
21      <li>バナナ</li>
22    </ul>
23    
24    </body>
25    </html>
26    HTML;
27
28    // DOMDocumentオブジェクトをインスタンス化
29    $dom = new DOMDocument();
30
31    // HTML文字列を読み込む
32    // @ はHTML5タグなどでのパースエラー警告を抑制するために使用
33    @$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
34
35    // 最初の<li>要素を取得
36    $firstItem = $dom->getElementsByTagName('li')->item(0);
37
38    // 要素が見つからない場合は処理を終了
39    if ($firstItem === null) {
40        echo "リストアイテムが見つかりません。\n";
41        return;
42    }
43
44    echo "最初の要素から順に兄弟要素を表示します:\n";
45
46    // 現在のノードを追跡するための変数に最初の要素をセット
47    $currentNode = $firstItem;
48
49    // 現在のノードが存在する間、ループ処理を行う
50    while ($currentNode !== null) {
51        // ノードの種類が要素ノード（タグ）であるかを確認
52        // これにより、要素間の改行や空白などのテキストノードを無視できる
53        if ($currentNode instanceof DOMElement) {
54            // 要素のテキスト内容を出力
55            echo "- " . $currentNode->textContent . "\n";
56        }
57
58        // nextSiblingプロパティを使用して、次の兄弟ノードへ移動
59        // 次の兄弟ノードがない場合、nullが代入されループが終了する
60        $currentNode = $currentNode->nextSibling;
61    }
62}
63
64// 関数を実行して結果を表示
65displayHtmlListSiblings();

PHPのDOMDocumentクラスでHTMLやXMLドキュメントを扱う際、nextSiblingプロパティは非常に重要な役割を果たします。このプロパティは、あるDOMNodeオブジェクトが持つ「次の兄弟ノード」を取得するために使用されます。引数はなく、戻り値としてはDOMNode型のオブジェクトが返されますが、次の兄弟ノードが存在しない場合はnullが返されます。

提供されたサンプルコードは、nextSiblingプロパティの具体的な使い方を示しています。まず、DOMDocumentオブジェクトにHTML文字列を読み込み、getElementsByTagName('li')->item(0)でリストの最初の<li>要素を取得します。その後、whileループ内で$currentNode = $currentNode->nextSibling;とすることで、現在のノードから次の兄弟ノードへと順に移動しています。

ループの中では、$currentNode instanceof DOMElementという条件で、現在のノードがHTML要素（タグ）であるかを確認しています。これは、nextSiblingプロパティが要素間の改行や空白などもテキストノードとして返す場合があるため、不要なテキストノードをスキップして目的の要素ノードのみを処理するための工夫です。次の兄弟ノードがなくなるまでこの処理を繰り返すことで、リスト内のすべての<li>要素の内容を順番に取得し表示しています。このnextSiblingプロパティを活用することで、HTMLやXMLのツリー構造を効率的にたどり、要素の順次処理や情報抽出が可能になります。

nextSiblingは、指定したノードの直後の兄弟ノードを返します。兄弟ノードが存在しない場合はnullを返します。要素間の改行や空白もノードとして扱われるため、instanceof DOMElementで要素ノードかどうかを確認すると、意図しないノードへのアクセスを防げます。loadHTMLの@はエラー抑制演算子であり、エラーを無視するため、本番環境ではエラーログなどを活用し、適切にエラーハンドリングを行うようにしてください。HTML構造が複雑な場合、nextSiblingだけでは目的の要素にたどり着けない場合があります。DOMXPathなどを利用して、より柔軟な要素の検索を検討してください。