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

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

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

基本的な使い方

getElementsByTagNameメソッドは、DOMDocumentクラスに所属するメソッドで、指定されたタグ名を持つすべての要素をDOMNodeListオブジェクトとして取得するために使用されます。DOMDocumentオブジェクトは、XMLドキュメント全体を表すため、このメソッドを利用することで、ドキュメント内の特定の種類の要素を効率的に検索し、操作することが可能になります。

具体的には、getElementsByTagNameメソッドは、引数として取得したい要素のタグ名を文字列で受け取ります。例えば、"p"というタグ名を指定した場合、ドキュメント内のすべての<p>要素が返されます。このメソッドは、ドキュメントのルート要素から始まり、深さ優先探索で要素を検索します。

戻り値は、DOMNodeListオブジェクトです。DOMNodeListは、Nodeオブジェクトの順序付きリストであり、インデックスを使用して個々の要素にアクセスできます。ただし、DOMNodeListはライブリストであるため、元のドキュメントが変更されると、自動的にリストの内容が更新されます。

getElementsByTagNameメソッドは、XMLドキュメントの構造を解析し、特定の要素を抽出する際に非常に便利なツールです。ウェブアプリケーションやXML処理を行うシステムにおいて、データの抽出や加工、表示などの様々な処理で活用されます。システムエンジニアは、このメソッドを理解し、適切に利用することで、XMLドキュメントを効率的に処理するプログラムを開発できます。

構文(syntax)


1DOMDocument::getElementsByTagName(string $qualifiedName): DOMNodeList

引数(parameters)

string $qualifiedName

string $qualifiedName: 検索する要素のタグ名を指定する文字列。ワイルドカードとして '*' を指定すると、すべての要素を取得します。

戻り値(return)

DOMNodeList

指定されたタグ名を持つすべての要素のコレクションを返します。このコレクションはDOMNodeListオブジェクトとして提供されます。

サンプルコード

PHP DOMDocumentで複数タグを取得する


1<?php
2
3// HTML文字列を定義
4$html = <<<HTML
5<!DOCTYPE html>
6<html>
7<head>
8  <title>DOMDocument Example</title>
9</head>
10<body>
11  <h1>見出し1</h1>
12  <p>段落1</p>
13  <p>段落2</p>
14  <div>
15    <p>div内の段落</p>
16  </div>
17  <span>
18    <p>span内の段落</p>
19  </span>
20</body>
21</html>
22HTML;
23
24// DOMDocumentオブジェクトを作成
25$dom = new DOMDocument();
26
27// HTMLをロード
28$dom->loadHTML($html);
29
30// タグ名が'p'の要素をすべて取得
31$paragraphs = $dom->getElementsByTagName('p');
32
33// 取得した要素の数を出力
34echo "pタグの数: " . $paragraphs->length . PHP_EOL;
35
36// 各要素の内容を出力
37foreach ($paragraphs as $paragraph) {
38  echo "pタグの内容: " . $paragraph->textContent . PHP_EOL;
39}
40
41// タグ名が'div'の要素をすべて取得
42$divs = $dom->getElementsByTagName('div');
43
44// 取得した要素の数を出力
45echo "divタグの数: " . $divs->length . PHP_EOL;
46
47// 各要素の内容を出力
48foreach ($divs as $div) {
49    echo "divタグの内容: " . $div->textContent . PHP_EOL;
50}
51?>

このPHPのサンプルコードは、DOMDocumentクラスのgetElementsByTagNameメソッドの使い方を示しています。getElementsByTagNameメソッドは、指定されたタグ名を持つすべての要素をDOMNodeListオブジェクトとして返します。

まず、HTML文字列をDOMDocumentオブジェクトに読み込みます。loadHTMLメソッドを使うことで、HTML文字列を解析し、DOMツリーを構築します。

次に、getElementsByTagName('p')を呼び出すことで、HTMLドキュメント内のすべての<p>タグ要素を取得します。このメソッドは、タグ名を引数として受け取り、該当するすべての要素をDOMNodeListオブジェクトとして返します。DOMNodeListは、取得した要素のリストであり、lengthプロパティで要素の数を取得できます。

サンプルコードでは、取得した<p>タグの数と、それぞれの内容（textContentプロパティ）をループで出力しています。同様に、getElementsByTagName('div')を使用して、すべての<div>タグ要素を取得し、数と内容を出力しています。

このメソッドを使うことで、HTMLドキュメントから特定のタグを持つ要素を効率的に抽出できます。例えば、WebスクレイピングやHTMLの構造解析など、さまざまな場面で役立ちます。DOMDocumentとgetElementsByTagNameメソッドを組み合わせることで、PHPでHTMLを操作するための強力なツールとなります。初心者の方は、このサンプルコードを参考に、HTMLの要素抽出処理を試してみてください。

getElementsByTagNameメソッドは、指定したタグ名の要素をすべて取得しますが、大文字・小文字は区別されません。取得できるのはDOMNodeListという特別なオブジェクトで、配列のように扱えますが、配列関数は使えません。lengthプロパティで要素の数を取得し、foreachで各要素にアクセスします。

loadHTML関数は、HTMLの構造が正しくない場合でもエラーを返さずに処理を試みますが、意図しない結果になることがあります。HTML文字列はUTF-8エンコーディングである必要があります。textContentプロパティは、要素に含まれるテキストコンテンツをすべて返します。子要素のテキストも含まれる点に注意してください。取得したノードは、DOMDocumentオブジェクトに紐づいているため、不用意に変更すると元のHTML構造に影響を与えます。

PHP DOMDocumentでタグ名を取得する


1<?php
2
3// DOMDocumentを生成
4$dom = new DOMDocument();
5
6// XMLをロード
7$dom->loadXML('<root><item>Value 1</item><item>Value 2</item></root>');
8
9// タグ名が"item"の要素を取得
10$items = $dom->getElementsByTagName('item');
11
12// 取得した要素をループで処理
13foreach ($items as $item) {
14    echo $item->nodeValue . PHP_EOL;
15}
16
17?>

PHPのDOMDocumentクラスにおけるgetElementsByTagNameメソッドは、指定されたタグ名を持つ要素をすべて取得するために使用されます。このメソッドは、XMLドキュメント内から特定の種類の要素を効率的に抽出する際に役立ちます。

getElementsByTagNameメソッドは、引数として文字列型の$qualifiedNameを受け取ります。$qualifiedNameには、取得したい要素のタグ名を指定します。例えば、'item'という文字列を渡すと、ドキュメント内のすべての<item>タグを持つ要素が検索されます。

メソッドの戻り値はDOMNodeListオブジェクトです。DOMNodeListは、見つかったすべての要素を格納したリストのようなもので、イテレーション（繰り返し処理）を通じて各要素にアクセスできます。

サンプルコードでは、まずDOMDocumentオブジェクトを作成し、loadXMLメソッドを使ってXML文字列をロードしています。次に、getElementsByTagName('item')を呼び出して、タグ名が"item"であるすべての要素を取得しています。

取得された要素は、foreachループを使用して順番に処理されます。各要素（$item）に対して、nodeValueプロパティにアクセスすることで、要素のテキストコンテンツ（例：<item>Value 1</item>であればValue 1）を取得し、echoで出力しています。PHP_EOLは改行文字を意味し、各要素の値を改行して表示するために使用されています。

このメソッドを使うことで、XMLドキュメントから特定の種類の情報を簡単に抽出できます。

getElementsByTagNameメソッドは、指定したタグ名を持つすべての要素をDOMNodeListとして返します。このDOMNodeListはノードのライブコレクションであるため、ドキュメントが変更されると自動的に更新されます。ループ処理中にドキュメント構造を変更すると、予期しない結果になる可能性があるため注意が必要です。名前空間を考慮する場合はgetElementsByTagNameNSメソッドを使用します。要素が見つからない場合でも、空のDOMNodeListが返され、nullが返されることはありません。 nodeValueプロパティを使用して要素のテキストコンテンツを取得できます。