【PHP8.x】Dom\HTMLElement::innerHTMLプロパティの使い方

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

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

基本的な使い方

Dom\HTMLElementクラスのinnerHTMLプロパティは、その要素の内部にあるHTMLマークアップを取得または設定するために使用されるプロパティです。具体的には、要素の開始タグと終了タグの間に含まれるすべてのHTMLコンテンツを文字列として取得したり、新しいHTMLコンテンツで置き換えたりすることができます。

このプロパティは、ウェブページ上の特定の要素の内容を動的に変更する際に非常に役立ちます。例えば、JavaScriptなど他のプログラミング言語と組み合わせて、ユーザーの操作に応じてウェブページの表示内容を更新する場合などに利用されます。

innerHTMLプロパティを使用する際には、セキュリティ上の注意が必要です。外部からの入力に基づいてinnerHTMLプロパティに値を設定する場合、クロスサイトスクリプティング（XSS）攻撃のリスクが生じる可能性があります。そのため、信頼できないソースからのデータを使用する際には、適切なエスケープ処理やサニタイズ処理を行い、悪意のあるスクリプトが実行されないようにする必要があります。

innerHTMLプロパティは、要素が持つ子ノードをHTML文字列として表現したものを操作します。したがって、子ノードの構造を直接操作するのではなく、HTML文字列全体を置き換える形になります。より細かい制御が必要な場合は、DOM APIを使用して個々のノードを操作することを検討してください。

PHPのDom\HTMLElementクラスにおけるinnerHTMLプロパティは、DOMDocumentオブジェクトを通じてHTML文書を操作する際に、要素の内容を簡潔に扱える便利な機能を提供します。ただし、セキュリティとパフォーマンスに配慮した上で利用することが重要です。

構文(syntax)


1Dom\HTMLElement::$innerHTML;

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

指定されたDOM要素の内部HTMLコンテンツを文字列として返します。

サンプルコード

PHP DOM innerHTML で要素の内部HTMLを取得する


1<?php
2
3// HTML 文字列を読み込む
4$htmlString = <<<HTML
5<!DOCTYPE html>
6<html>
7<body>
8
9<div id="container">
10  <p>This is a paragraph.</p>
11  <p>This is another paragraph.</p>
12</div>
13
14</body>
15</html>
16HTML;
17
18// DOMDocument を作成し、HTML を読み込む
19$dom = new DOMDocument();
20$dom->loadHTML($htmlString);
21
22// container 要素を取得
23$container = $dom->getElementById('container');
24
25// HTMLElement を取得できているか確認
26if ($container instanceof DOMElement) {
27    // innerHTML プロパティを使用して、要素の内部 HTML を取得
28    $innerHTML = $container->innerHTML;
29
30    // 結果を出力
31    echo $innerHTML;
32} else {
33    echo "Container element not found.";
34}
35
36?>

PHPのDom\HTMLElementクラスのinnerHTMLプロパティは、指定されたHTML要素の内部にあるHTMLコンテンツを文字列として取得するために使用します。このプロパティは引数を取らず、文字列型の値を返します。

上記のサンプルコードでは、まずDOMDocumentオブジェクトを作成し、HTML文字列を読み込んでDOMツリーを構築します。次に、getElementByIdメソッドを使って、IDがcontainerである要素を取得します。

$containerがDOMElementのインスタンスであることを確認した後、innerHTMLプロパティにアクセスしています。$container->innerHTMLとすることで、container要素の開始タグと終了タグの間に存在するすべてのHTMLコード（子要素やテキストなど）が、文字列として $innerHTML 変数に格納されます。

最後に、取得した内部HTMLの内容を echo $innerHTML; で出力しています。もし、container要素が見つからなかった場合は、エラーメッセージを表示します。innerHTMLプロパティを使用することで、DOM操作を行うことなく、特定の要素の内部構造を簡単に取得できます。

DOMElementのinnerHTMLプロパティは、PHP8.0.0以降で使用可能です。これより前のバージョンでは動作しません。loadHTML関数を使用する際、文字エンコーディングに注意してください。特に日本語環境では、文字化けを防ぐために適切なエンコーディングを指定する必要があります。例えば、$dom->loadHTML('<?xml encoding="UTF-8">' . $htmlString);のようにXML宣言を追加することで、UTF-8エンコーディングを指定できます。getElementByIdメソッドは、指定したIDを持つ最初の要素のみを返します。IDが重複している場合は意図しない結果になる可能性があります。innerHTMLで取得できるのは要素の内部HTMLのみで、開始タグと終了タグは含まれません。

PHP DomDocumentでinnerHTMLを取得する


1<?php
2
3// HTML 文字列から DOMDocument を作成する
4$htmlString = '<!DOCTYPE html><html><body><div id="myDiv">Hello, <b>World!</b></div></body></html>';
5$dom = new DOMDocument();
6$dom->loadHTML($htmlString);
7
8// ID を指定して要素を取得する
9$element = $dom->getElementById('myDiv');
10
11// innerHTML の値を取得する関数
12function getInnerHTML(DOMElement $element): string
13{
14    $innerHTML = '';
15    $children = $element->childNodes;
16
17    foreach ($children as $child) {
18        $innerHTML .= $element->ownerDocument->saveHTML($child);
19    }
20
21    return $innerHTML;
22}
23
24// innerHTML を取得して表示する
25$innerHTML = getInnerHTML($element);
26echo $innerHTML . PHP_EOL; // 出力: Hello, <b>World!</b>
27
28?>

このPHPのサンプルコードは、DOMDocumentを使用してHTML要素のinnerHTML相当の機能を実現する方法を示しています。PHPにはJavaScriptのような直接的なinnerHTMLプロパティは存在しないため、同様の処理を行うには少し工夫が必要です。

まず、HTML文字列をDOMDocumentオブジェクトに読み込みます。次に、getElementById()メソッドを使って、目的のIDを持つ要素（ここではmyDiv）を取得します。

getInnerHTML()関数は、指定されたDOMElementの子ノードを順番に処理し、それぞれのノードをHTML文字列として取得して連結することで、innerHTML相当の文字列を生成します。$element->ownerDocument->saveHTML($child)の部分が、子ノードをHTML文字列に変換する重要な処理です。saveHTML()メソッドは、DOMDocumentに関連付けられたノードを、適切なHTMLとしてシリアライズします。

この関数に取得した要素を渡すと、要素の子ノードの内容がHTML文字列として返されます。サンプルコードでは、取得したinnerHTMLの内容をechoで出力しています。

この方法を利用することで、PHPでHTMLを扱う際に、特定の要素内部のHTMLコンテンツを効率的に取得することができます。特に、動的に生成されたHTMLを処理する場合や、既存のHTML構造を解析・変更する場合に役立ちます。引数にはDOMElementオブジェクトを指定し、戻り値としてinnerHTML相当の文字列がstring型で返されます。

PHPのDom\HTMLElementクラスのinnerHTMLプロパティは直接提供されていません。そのため、サンプルコードのように、既存のDOM関数を組み合わせて同等の機能を実現する必要があります。

saveHTML()関数は、ノード全体をHTMLとして出力するため、子要素のみを取得したい場合は、ノードを反復処理して連結する必要があります。loadHTML()関数を使用する際は、文字エンコーディングに注意してください。UTF-8以外のエンコーディングのHTMLを扱う場合は、適切なエンコーディングを指定する必要があります。セキュリティの観点から、外部からのHTML入力をloadHTML()に直接渡すことは避けてください。サニタイズ処理を必ず行ってください。