【PHP8.x】Dom\HTMLElement::tagNameプロパティの使い方
tagNameプロパティの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
tagNameプロパティは、HTML要素のタグ名を保持するプロパティです。このプロパティは、Dom\HTMLElementクラスに属しており、ウェブページを構成するHTML要素をPHPで扱う際に利用されます。具体的には、取得したHTML要素がどのような種類のタグ（例: <div>や<p>など）であるかを識別するために使用されます。
tagNameプロパティが保持する値は、常に大文字の文字列です。例えば、<div>タグで表される要素の場合、このプロパティは文字列"DIV"を返します。同様に、<p>タグの要素であれば"P"を、<a>タグの要素であれば"A"を返します。これにより、タグ名の大文字・小文字を気にすることなく、統一された形式で要素の種類を判別できます。
このプロパティは読み取り専用であり、その値をプログラムから直接変更することはできません。HTML要素のタグ名は、要素が作成された時点で決定され、DOM（Document Object Model）ツリーの構造的な整合性を維持するために変更が許可されていません。
システムエンジニアを目指す方にとって、このtagNameプロパティは、ウェブスクレイピングやDOM操作を行う際に非常に基本的かつ重要な役割を果たします。特定のタグ名の要素だけを抽出したり、要素の種類に基づいて処理を分岐させたりするなど、動的なウェブコンテンツの解析や操作において頻繁に活用されるでしょう。要素の種類を正確に把握することで、より堅牢で効率的なプログラミングが可能になります。
構文(syntax)
1<?php 2 3$dom = new Dom\Document(); 4$element = $dom->createElement('p'); 5echo $element->tagName; 6 7?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
Dom\HTMLElement クラスの tagName プロパティは、その要素のタグ名を文字列で返します。例えば、<div> 要素であれば "div" が返されます。
サンプルコード
PHPでHTML要素のタグ名を取得する
1<?php 2 3/** 4 * HTML文字列から指定されたIDを持つ要素のタグ名を取得します。 5 * 6 * @param string $html HTMLコンテンツの文字列。 7 * @param string $id 取得したい要素のID。 8 * @return string|null 要素が見つかった場合はそのタグ名、見つからない場合はnullを返します。 9 */ 10function getElementTagName(string $html, string $id): ?string 11{ 12 // 新しいDOMDocumentインスタンスを作成します。 13 // HTMLやXMLドキュメントを扱うためのクラスです。 14 $dom = new DOMDocument(); 15 16 // HTMLの読み込み時に発生する可能性のある警告（例: 不完全なHTML）を一時的に抑制します。 17 // これにより、パースエラーがあってもスクリプトの実行が中断されにくくなります。 18 libxml_use_internal_errors(true); 19 // HTML文字列をDOMDocumentに読み込みます。 20 $dom->loadHTML($html); 21 // 抑制された警告をクリアします。 22 libxml_clear_errors(); 23 // 警告の抑制を解除し、デフォルトの挙動に戻します。 24 libxml_use_internal_errors(false); 25 26 // 指定されたIDを持つ要素をDOMDocumentから取得します。 27 // PHP 8では、getElementByIdが返すDOMElementオブジェクトは 28 // Dom\HTMLElementインターフェースを実装しています。 29 $element = $dom->getElementById($id); 30 31 // 要素が見つかり、それがDom\HTMLElementのインスタンス（またはそれを継承するクラス）であれば、 32 // そのtagNameプロパティ（例: "div", "p" など）を返します。 33 if ($element instanceof Dom\HTMLElement) { 34 return $element->tagName; 35 } 36 37 // 要素が見つからないか、有効なHTMLElementではない場合はnullを返します。 38 return null; 39} 40 41// サンプルとして使用するHTMLコンテンツです。 42$sampleHtml = ' 43<!DOCTYPE html> 44<html> 45<head> 46 <title>DOM HTMLElement tagName サンプル</title> 47</head> 48<body> 49 <div id="main-container"> 50 <h1>PHP Dom\HTMLElement::tagName の例</h1> 51 <p id="first-paragraph">この段落のタグ名を取得します。</p> 52 <a href="#" id="my-link">これはリンクです</a> 53 </div> 54 <span id="another-element">別の要素</span> 55</body> 56</html>'; 57 58// --- サンプルコードの実行 --- 59 60// IDが 'main-container' の要素のタグ名を取得します。 61$tagName1 = getElementTagName($sampleHtml, 'main-container'); 62if ($tagName1 !== null) { 63 echo "ID 'main-container' の要素のタグ名: " . $tagName1 . "\n"; // 出力例: div 64} else { 65 echo "ID 'main-container' の要素は見つかりませんでした。\n"; 66} 67 68// IDが 'first-paragraph' の要素のタグ名を取得します。 69$tagName2 = getElementTagName($sampleHtml, 'first-paragraph'); 70if ($tagName2 !== null) { 71 echo "ID 'first-paragraph' の要素のタグ名: " . $tagName2 . "\n"; // 出力例: p 72} else { 73 echo "ID 'first-paragraph' の要素は見つかりませんでした。\n"; 74} 75 76// 存在しないIDの要素のタグ名を取得しようとします。 77$tagName3 = getElementTagName($sampleHtml, 'non-existent-id'); 78if ($tagName3 !== null) { 79 echo "ID 'non-existent-id' の要素のタグ名: " . $tagName3 . "\n"; 80} else { 81 echo "ID 'non-existent-id' の要素は見つかりませんでした。\n"; // 出力例: ID 'non-existent-id' の要素は見つかりませんでした。 82}
このサンプルコードは、PHPのDom\HTMLElementクラスが持つtagNameプロパティを利用して、HTMLドキュメント内の特定要素のタグ名を取得する方法を示しています。tagNameプロパティは引数を取らず、常に文字列としてそのHTML要素のタグ名（例: "div"や"p"など）を返します。
コードではまず、DOMDocumentクラスのインスタンスを作成し、HTMLコンテンツを読み込んで解析可能な状態にします。次に、getElementById()メソッドを使って、指定されたIDを持つ要素をドキュメント内から検索します。
要素が見つかった場合、それがHTML要素を表すDom\HTMLElement型（PHP 8以降でより厳密になった表現です）であることを確認します。その後、その要素のtagNameプロパティにアクセスすることで、該当する要素のタグ名を取得し、結果として返します。もし指定されたIDの要素が見つからない場合はnullを返します。
この機能は、WebスクレイピングやHTMLコンテンツの動的な解析など、プログラムでHTMLの構造を理解し、要素の種類を判別したい場合に非常に有用です。
tagNameプロパティは、HTML要素のタグ名（例: divやp）を文字列として取得するために使用します。このプロパティを利用するには、まずDOMDocumentクラスを使ってHTMLコンテンツを読み込み、getElementByIdなどのメソッドで目的の要素を取得する必要があります。要素が見つからなかった場合や、取得した要素が有効なDom\HTMLElementではない可能性があるため、サンプルコードのようにnullチェックやinstanceof Dom\HTMLElementによる型チェックを必ず行い、予期せぬエラーを防ぐことが重要です。また、HTMLパース時の警告抑制は一時的な手段であり、本番環境ではHTMLの健全性を確認し、エラーに応じた堅牢な処理を実装することが安全な運用につながります。
PHP: HTML要素のタグ名を取得する
1<?php 2 3// システムエンジニアを目指す初心者向け: Dom\HTMLElement クラスの tagName プロパティの使用例です。 4// キーワード「php タグ 追加」に対応し、新しいHTML要素を作成し、そのタグ名を取得する方法を示します。 5 6function createAndInspectHTMLElement(): void 7{ 8 // 1. 新しい Dom\Document を作成します。これはHTMLドキュメントのルートです。 9 $document = new Dom\Document(); 10 11 // 2. createElement メソッドを使って新しいHTML要素（タグ）を作成します。 12 // これは新しい 'div' タグを作成し、Dom\Element のインスタンスを返します。 13 // Dom\Element は Dom\HTMLElement を継承しているため、tagName プロパティにアクセスできます。 14 $newElement = $document->createElement('div'); 15 16 // 3. 作成した要素の tagName プロパティにアクセスし、そのタグ名を取得します。 17 // tagName は常に要素のタグ名を小文字の文字列で返します（例: 'div', 'p', 'a'）。 18 $tagName = $newElement->tagName; 19 20 echo "作成したHTML要素のタグ名: " . $tagName . PHP_EOL; 21 22 // 4. (オプション) 作成した要素にテキストコンテンツを追加します。 23 $newElement->textContent = 'これは追加された新しいdiv要素です。'; 24 25 // 5. (オプション) 作成した要素をドキュメントツリーに追加します。 26 // この操作が「タグを追加」の具体的な例の一つです。 27 // ここではドキュメントのルートに直接追加していますが、通常はbodyや他の要素の子として追加します。 28 $document->appendChild($newElement); 29 30 // 6. (オプション) 生成されたHTMLの断片を出力して、要素が追加されたことを確認します。 31 // formatOutput を true に設定すると、人間が読みやすいように整形されます。 32 $document->formatOutput = true; 33 echo PHP_EOL . "生成されたHTMLの断片:" . PHP_EOL; 34 echo $document->saveHTML(); 35} 36 37// 関数を実行します。 38createAndInspectHTMLElement(); 39
このサンプルコードは、PHPのDOM拡張機能におけるDom\HTMLElementクラスのtagNameプロパティの使用方法を説明しています。tagNameプロパティは、HTML要素のタグ名を文字列として取得するために利用されます。このプロパティに引数はなく、要素のタグ名を常に小文字の文字列で返します。例えば、<div>タグであれば'div'、<p>タグであれば'p'が戻り値となります。
コードではまず、新しいHTMLドキュメントを操作するためのDom\Documentオブジェクトを作成します。次に、このドキュメントのcreateElementメソッドを使って、具体的なHTML要素、ここではdivタグのインスタンスを作成しています。createElementメソッドはDom\Elementオブジェクトを返しますが、これはDom\HTMLElementクラスを継承しているため、tagNameプロパティにアクセス可能です。
作成されたdiv要素から$newElement->tagNameとすることで、そのタグ名である'div'を取得し、画面に出力しています。キーワード「php タグ 追加」に対応する部分としては、createElementで新しいタグを作成し、その後appendChildメソッドを使って、作成した要素をドキュメントツリーに追加する一連の操作が示されています。これにより、新しいHTML要素がプログラム的に生成され、HTMLドキュメントの一部として組み込まれる様子が確認できます。最後に、saveHTML()メソッドで生成されたHTML全体を出力し、追加されたタグの最終的な状態を確認できます。
このコードは、Dom\HTMLElementのtagNameプロパティが、HTML要素のタグ名を常に小文字で返す読み取り専用の機能であることを示します。createElement()で要素を作成する操作と、それをappendChild()などでドキュメントツリーに組み込む「タグの追加」操作は異なるため、混同しないよう注意が必要です。Dom\ElementはDom\HTMLElementを継承しているため、tagNameプロパティにアクセスできます。これらのDOM操作を利用するには、PHP環境でDOM拡張が有効になっている必要があります。