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

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

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

基本的な使い方

itemメソッドは、DOMNodeListオブジェクトが保持するノードリストから、指定されたインデックスのノードを取得するメソッドです。DOMNodeListは、XMLドキュメント内の要素を操作する際に頻繁に利用されるオブジェクトであり、特定の条件に合致するノードの集合を保持します。itemメソッドを利用することで、ノードリスト内の特定のノードに順番にアクセスし、そのノードの情報を取得したり、操作したりすることが可能になります。

このメソッドは、引数として整数型のインデックスを受け取ります。インデックスはノードリスト内の位置を示し、0から始まる連番です。例えば、リストの最初のノードを取得したい場合は、インデックス0を指定します。指定されたインデックスがノードリストの範囲外である場合（つまり、インデックスが0未満であるか、ノードリストのサイズ以上である場合）、itemメソッドはnullを返します。

返り値は、DOMNodeオブジェクトです。これは、ノードリスト内の指定された位置にあるノードを表します。返されたDOMNodeオブジェクトに対して、様々なメソッドを呼び出すことで、ノードの属性の取得や変更、子ノードへのアクセスなど、様々な操作を行うことができます。

itemメソッドは、DOMドキュメントの構造を解析し、特定のノードを効率的に操作するための重要な手段を提供します。XMLデータの処理を行うシステムを開発する際には、このメソッドを理解し、適切に利用することが不可欠です。例えば、特定のタグ名を持つ要素を検索し、それらの要素の属性を更新する処理などを実装する際に、itemメソッドが活用できます。

構文(syntax)


1DOMNodeList::item(int $index): ?DOMNode

引数(parameters)

int $index

int $index: 取得したい要素のインデックス番号を指定する整数

戻り値(return)

DOMNode|null

指定されたインデックスにあるDOMNodeオブジェクト、またはインデックスが無効な場合はnullを返します。

サンプルコード

DOMNodeList::item で要素のIDを取得する


1<?php
2
3/**
4 * DOMNodeList::item メソッドの使用例を示します。
5 * HTMLドキュメントから要素のリストを取得し、特定のインデックスの要素とそのIDを表示します。
6 * システムエンジニアを目指す初心者の方にも分かりやすいよう、各ステップにコメントを付与しています。
7 */
8function demonstrateDomNodeListItem(): void
9{
10    // 1. サンプルとなるHTMLコンテンツを作成します。
11    // ID属性を持つdiv要素とp要素を含めることで、「item_id」キーワードに関連付けます。
12    $html = <<<HTML
13<!DOCTYPE html>
14<html>
15<head><title>DOMNodeList::item Example</title></head>
16<body>
17    <div id="first-item-id">最初のアイテム</div>
18    <p id="second-item-id">二番目のアイテム (pタグ)</p>
19    <div id="third-item-id">三番目のアイテム</div>
20    <span>リストには含まれないテキスト</span>
21</body>
22</html>
23HTML;
24
25    // DOMDocumentオブジェクトを初期化し、HTMLをロードします。
26    $dom = new DOMDocument();
27    // HTMLのパース時に発生する可能性のあるエラーや警告を抑制し、
28    // サンプルコードの出力をシンプルに保ちます。
29    libxml_use_internal_errors(true);
30    $dom->loadHTML($html);
31    libxml_clear_errors(); // 抑制されたエラー情報をクリアします。
32    libxml_use_internal_errors(false);
33
34    // 2. ドキュメント内のすべての 'div' 要素のリストを取得します。
35    // getElementsByTagName() メソッドは DOMNodeList オブジェクトを返します。
36    $divElements = $dom->getElementsByTagName('div');
37
38    echo "--- DOMNodeList::item() の使用例 ---\n\n";
39
40    // 3. DOMNodeList から最初の 'div' 要素をインデックス 0 で取得します。
41    // item($index) メソッドは、指定されたインデックス位置の DOMNode を返します。
42    // インデックスは 0 から始まります。
43    $firstDiv = $divElements->item(0);
44
45    // 取得した要素が存在するか確認します。
46    // item() メソッドは、指定されたインデックスに要素が存在しない場合、null を返します。
47    if ($firstDiv instanceof DOMElement) { // DOMElement は DOMNode を継承しています。
48        echo "インデックス 0 の 'div' 要素:\n";
49        echo "  ID (first-item-id): " . $firstDiv->getAttribute('id') . "\n"; // キーワード「item_id」に関連
50        echo "  テキストコンテンツ: " . $firstDiv->textContent . "\n\n";
51    } else {
52        echo "インデックス 0 の 'div' 要素が見つかりませんでした。\n\n";
53    }
54
55    // 4. DOMNodeList から2番目の 'div' 要素をインデックス 1 で取得します。
56    // HTMLソースでは `<div id="third-item-id">` が該当します。
57    $secondDiv = $divElements->item(1);
58
59    if ($secondDiv instanceof DOMElement) {
60        echo "インデックス 1 の 'div' 要素:\n";
61        echo "  ID (third-item-id): " . $secondDiv->getAttribute('id') . "\n"; // キーワード「item_id」に関連
62        echo "  テキストコンテンツ: " . $secondDiv->textContent . "\n\n";
63    } else {
64        echo "インデックス 1 の 'div' 要素が見つかりませんでした。\n\n";
65    }
66
67    // 5. 存在しないインデックスを試します。
68    // この場合、DOMNodeList::item() は null を返します。
69    $nonExistentDiv = $divElements->item(99);
70
71    if ($nonExistentDiv === null) {
72        echo "インデックス 99 の 'div' 要素は存在しないため、null が返されました。\n\n";
73    } else {
74        // このブロックは実行されません。
75        echo "インデックス 99 の 'div' 要素のID: " . $nonExistentDiv->getAttribute('id') . "\n\n";
76    }
77
78    echo "--- 別のタグでの例 (pタグ) ---\n\n";
79
80    // 同様に 'p' 要素のリストを取得し、最初の要素を操作します。
81    $pElements = $dom->getElementsByTagName('p');
82    $firstP = $pElements->item(0);
83
84    if ($firstP instanceof DOMElement) {
85        echo "最初の 'p' 要素:\n";
86        echo "  ID (second-item-id): " . $firstP->getAttribute('id') . "\n";
87        echo "  テキストコンテンツ: " . $firstP->textContent . "\n\n";
88    } else {
89        echo "最初の 'p' 要素が見つかりませんでした。\n\n";
90    }
91}
92
93// 関数を実行し、DOMNodeList::item メソッドの動作を確認します。
94demonstrateDomNodeListItem();

PHP 8のDOMNodeList::itemメソッドは、HTMLやXMLドキュメントの構造を扱う際に使用されるDOMNodeListオブジェクトから、特定の要素（ノード）を取得するために用いられます。DOMNodeListは、例えばHTMLドキュメント内のすべてのdivタグやpタグといった、同じ種類の要素を複数集めたリストです。

このitemメソッドは、int $indexという整数値を引数に取ります。この$indexは、リスト内で取得したい要素の位置を示す番号で、プログラミングでは一般的に最初の要素が「0」から数え始められます。したがって、item(0)はリストの最初の要素を、item(1)は2番目の要素を指します。

メソッドの戻り値は、指定されたインデックス位置に要素が存在すればDOMNodeオブジェクト、存在しない場合はnullとなります。DOMNodeはHTMLの要素や属性、テキストなどの基本型です。サンプルコードでは、HTMLから特定のタグ名を持つ要素のリストを取得し、itemメソッドでそれぞれの要素にアクセスしています。特に、取得した要素のID（item_idとしてキーワードに関連付けられています）やテキストコンテンツを表示することで、リストから目的の要素を選び出す方法を具体的に示しています。存在しないインデックスを指定した場合にnullが返される挙動も確認できます。

DOMNodeList::item()メソッドは、指定したインデックスに要素が存在しない場合、nullを返します。そのため、メソッドの戻り値を必ず確認し、nullでないことを保証してから要素の操作を行うようにしてください。戻り値の型はDOMNodeですが、getAttribute('id')のように特定の属性にアクセスする際は、それがDOMElementのインスタンスであるかinstanceofで型チェックを行うと、より安全にコードを記述できます。getElementsByTagName()などで取得したリストは、指定した条件に合致する要素のみを含むリストであることを理解しましょう。また、HTMLをパースする際にlibxml_use_internal_errorsでエラーを抑制していますが、実運用ではエラー発生の可能性を考慮し、適切なエラーハンドリングを実装することが重要です。

PHP: DOMNodeListからitem()で要素を取得する


1<?php
2
3/**
4 * DOMNodeList::item() メソッドのPHP 8における使用例
5 *
6 * この関数は、HTMLドキュメントから特定の要素のリスト（DOMNodeList）を取得し、
7 * そのリストの中から、インデックスを指定して個々のDOMNode（要素）を取り出す方法を示します。
8 * これは、PHPの配列から特定のインデックスで値を取得する操作に似ています。
9 *
10 * @return void
11 */
12function demonstrateDomNodeListItem(): void
13{
14    // 1. 解析対象となるシンプルなHTML文字列を準備します。
15    // DOMDocumentクラスでこのHTMLをロードし、要素のリストを抽出します。
16    $htmlContent = <<<HTML
17    <!DOCTYPE html>
18    <html>
19    <head>
20        <title>DOMNodeList::item() Example</title>
21    </head>
22    <body>
23        <h1>DOMNodeList::item() のデモンストレーション</h1>
24        <div id="container">
25            <p>これは最初の段落です。</p>
26            <p>これは二番目の段落です。</p>
27            <p>これは三番目の段落です。</p>
28        </div>
29    </body>
30    </html>
31    HTML;
32
33    // 2. DOMDocumentオブジェクトを初期化し、HTMLコンテンツをロードします。
34    // "@" 演算子を使って、HTMLの構文エラーに関する警告を抑制しています。
35    $dom = new DOMDocument();
36    @$dom->loadHTML($htmlContent);
37
38    // 3. 'p' タグを持つ全ての要素をDOMNodeListとして取得します。
39    // DOMNodeListは、DOMNodeオブジェクトの集合であり、インデックスでアクセス可能です。
40    $paragraphNodes = $dom->getElementsByTagName('p');
41
42    echo "--- DOMNodeList::item() メソッドの使用例 ---\n\n";
43    echo "DOMNodeList内の 'p' 要素の総数: " . $paragraphNodes->length . "個\n\n";
44
45    // 4. DOMNodeList::item() メソッドを使って、指定したインデックスのDOMNodeを取得します。
46    // インデックスは 0 から始まります。これはPHP配列の $array[0] と同様の概念です。
47
48    // インデックス 0 の要素（最初の段落）を取得します。
49    // 戻り値は DOMNode または null になるため、型を確認します。
50    $firstParagraph = $paragraphNodes->item(0);
51    if ($firstParagraph instanceof DOMNode) {
52        echo "インデックス 0 の要素 ('" . $firstParagraph->textContent . "') を取得しました。\n";
53    } else {
54        echo "エラー: インデックス 0 の要素が見つかりませんでした。\n";
55    }
56
57    // インデックス 2 の要素（三番目の段落）を取得します。
58    $thirdParagraph = $paragraphNodes->item(2);
59    if ($thirdParagraph instanceof DOMNode) {
60        echo "インデックス 2 の要素 ('" . $thirdParagraph->textContent . "') を取得しました。\n";
61    } else {
62        echo "エラー: インデックス 2 の要素が見つかりませんでした。\n";
63    }
64
65    // 5. 存在しないインデックスにアクセスした場合の挙動を確認します。
66    // DOMNodeList::item() は、インデックスが範囲外の場合、null を返します。
67    $outOfBoundsNode = $paragraphNodes->item(100); // 存在しないインデックスを試します。
68    if ($outOfBoundsNode === null) {
69        echo "\nインデックス 100 の要素は存在しないため、item() メソッドは null を返しました。\n";
70    } else {
71        // このブロックは実行されないはずです。
72        echo "エラー: インデックス 100 の要素が予期せず見つかりました。\n";
73    }
74
75    echo "\n--- 参考: DOMNodeList の全ての要素を反復処理する場合 ---\n";
76    echo "(item() を使って一つずつ取り出す代わりに、foreachループも利用できます)\n";
77    $index = 0;
78    foreach ($paragraphNodes as $node) {
79        echo "  要素[" . $index++ . "]: " . $node->textContent . "\n";
80    }
81}
82
83// 関数を実行してデモンストレーションを開始します。
84demonstrateDomNodeListItem();
85
86?>

PHP 8のDOMNodeList::item()メソッドは、HTMLドキュメントを解析して取得した要素のリスト（DOMNodeList）の中から、特定の要素を一つ取り出す際に使用します。DOMNodeListは、ウェブページ内の同じタグを持つ複数の要素など、複数のDOMNodeオブジェクトを順番にまとめたものです。このメソッドは、引数として指定された整数$indexを用いて、リスト内の0から始まる位置にある要素を取得します。これはPHPの通常の配列で$array[0]のようにインデックスを指定して値を取り出す操作と非常によく似ています。

例えば、ウェブページ内の全ての<p>タグの要素をDOMNodeListとして取得した場合、item(0)と呼び出すことで最初の<p>要素を、item(1)で二番目の要素を取り出せます。戻り値は、指定したインデックスに要素が存在すればそのDOMNodeオブジェクトを返します。しかし、もし指定したインデックスがリストの範囲外である場合、このメソッドはnullを返します。これにより、存在しない要素にアクセスしようとした際にエラーではなくnullで適切にハンドリングすることが可能です。本サンプルコードでは、HTML内の段落要素を取得し、それぞれのインデックスを指定して個別の要素を取り出す様子と、範囲外のインデックスを指定した場合にnullが返される挙動を確認しています。

DOMNodeList::item()メソッドは、要素のリストから特定のインデックスにあるDOMノードを取得します。引数のインデックスは0から始まる整数であることに注意してください。最も重要な点は、指定したインデックスに要素が存在しない場合、DOMNodeオブジェクトではなくnullを返す点です。そのため、item()の戻り値を受け取った後は、必ずnullでないかを確認する（例: $node !== nullやif ($node instanceof DOMNode)）処理を行うことで、その後の操作で予期せぬエラーが発生するのを防げます。リストの全ての要素を順に処理する場合は、item()を繰り返し呼び出す代わりに、foreachループを直接使用する方が簡潔で効率的です。また、サンプルコードで使用されている@エラー抑制演算子は、デバッグを困難にする可能性があるため、本番環境での安易な使用は避けることをお勧めします。