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

loadHTMLFileメソッドは、指定されたHTMLファイルをパース（解析）し、その内容をDOMDocumentオブジェクトに読み込むためのメソッドです。このメソッドは、引数として読み込みたいHTMLファイルのパスを受け取り、ファイルの内容をDOMツリー構造としてメモリ上に構築します。DOMツリー構造とは、HTML文書の各要素（タグ、属性、テキストなど）をオブジェクトとして表現し、それらの関係性を木構造で管理する仕組みです。

これにより、PHPプログラム内でHTML文書の構造を簡単にたどり、特定の要素を検索したり、内容を抽出したり、あるいは要素を追加・変更・削除したりといった操作が可能になります。例えば、ウェブサイトから特定の情報を取得するスクレイピングや、既存のHTMLテンプレートを動的に編集する場面などで利用されます。

メソッドがファイルの読み込みと解析に成功した場合、真（true）を返します。一方、指定されたファイルが見つからない場合や、ファイルの読み込みに失敗した場合、あるいはHTMLが不正でパースエラーが発生した場合には、偽（false）を返します。通常、エラーが発生した際にはWarningが発行されることがありますので、適切なエラーハンドリングを行うことが重要です。

このメソッドは、DOMDocumentクラスのインスタンスに対して呼び出されるため、まずDOMDocumentオブジェクトを作成してから使用します。ウェブページの内容をPHPプログラムで扱いたい場合に非常に役立つ機能です。

Copy
1<?php
2$dom = new DOMDocument();
3$dom->loadHTMLFile('path/to/your/file.html');
4?>

string $filename, int $options = 0

• string $filename: HTMLファイルを読み込むためのファイルパスを指定する文字列
• int $options = 0: HTMLのパース方法を制御するオプションを指定する整数（デフォルトは0）

bool

DOMDocument::loadHTMLFileは、HTMLファイルを読み込み、DOMDocumentオブジェクトにパースした結果を真偽値で返します。読み込みが成功した場合はtrueを、失敗した場合はfalseを返します。