DOMDocument::loadHTML

(PHP 5, PHP 7, PHP 8)

DOMDocument::loadHTML 文字列から HTML を読み込む

説明

public DOMDocument::loadHTML(string $source, int $options = 0): DOMDocument|bool

この関数は、文字列 source に含まれる HTML を パースします。XML を読み込む場合とは異なり、妥当な HTML でなくても 読み込むことができます。この関数をstaticメソッドとしてコールすると、 読み込んだ内容をもとに DOMDocument オブジェクトを作成します。 読み込み前に DOMDocument のプロパティを 設定する必要がない場合に、staticメソッドを実行することがあるでしょう。

パラメータ

source

HTML 文字列。

options

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

戻り値

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

エラー / 例外

空の文字列を source に渡すと、警告が発生します。 この警告は 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->loadHTML("<html><body>Test<br></body></html>");
echo 
$doc->saveHTML();
?>

参考

関連キーワード:  DOMDocument, メソッド, エラー, static, 処理, 関数, ドキュメント, libxml, 発生, コール