DOMDocument::loadHTMLFile

(PHP 5, PHP 7, PHP 8)

DOMDocument::loadHTMLFile ファイルから HTML を読み込む

説明

public DOMDocument::loadHTMLFile(string $filename, int $options = 0): DOMDocument|bool

この関数は、filename という名前のファイルから 読み込んだ HTML ドキュメントをパースします。 XML を読み込む場合とは異なり、妥当な HTML でなくても 読み込むことができます。

パラメータ

filename

HTML ファイルへのパス。

options

Libxml 2.6.0 以降では、 options パラメータで Libxml の追加パラメータ を指定できます。

戻り値

成功した場合に true を、失敗した場合に false を返します。 staticメソッドとしてコールされた場合には DOMDocument を返します。 失敗した場合に false を返します

エラー / 例外

空の文字列を filename に渡したり中身が空のファイルを指定したりすると、警告が発生します。 この警告は libxml が発するものではないので、libxml のエラー処理関数 では処理できません。

PHP 8.0.0 より前のバージョンでは、このメソッドは、staticメソッドとしてコールすることも できましたがE_DEPRECATED エラーが発生していました。 PHP 8.0.0 以降では、このメソッドをstaticメソッドとしてコールすると Error がスローされます。

壊れた HTML も読み込めますが、マークアップが正しくない場合には E_WARNING が発生します。 このエラーの処理には libxml のエラー処理関数 が使えます。

例1 ドキュメントを作成する

<?php
$doc 
= new DOMDocument();
$doc->loadHTMLFile("filename.html");
echo 
$doc->saveHTML();
?>

参考

関連キーワード:  DOMDocument, ファイル, エラー, メソッド, ドキュメント, 処理, filename, libxml, 発生, パラメータ