Dom\HTMLDocument::createFromFile
ファイルから取得した HTML ファイルをパースする
説明
public static Dom\HTMLDocument Dom\HTMLDocument::createFromFile(string $path, int $options = 0, stringnull $overrideEncoding = null)
ファイルから取得した HTML ファイルを、Living Standard に従ってパースします。
パラメータ
-
path
-
パースするファイルのパス
-
options
-
追加の Libxml パラメータ を、ビット演算子の OR で指定します。
Dom\HTML_NO_DEFAULT_NS を渡すことで、
HTML 名前空間や template 要素の使用を無効化することもできます。
このオプションは、及ぼす影響を十分理解している場合に限り使用すべきです。
-
overrideEncoding
-
ドキュメントが作成されたエンコーディング。
指定されていない場合、最も使用されている可能性の高いエンコーディングを判定しようとします。
戻り値
パース済みのドキュメントを、Dom\HTMLDocument
のインスタンスとして返します。
エラー / 例外
-
path にヌルバイトや "%00"
が含まれていた場合、
ValueError がスローされます。
-
options が不正なオプションを含む場合、
ValueError をスローします。
-
overrideEncoding が未知のエンコーディングである場合、
ValueError をスローします。
-
ファイルが開けなかった場合は、
Exception がスローされます。
注意
注意:
html タグや head タグの中の空白は
必ずしも保持されません。インデント等が失われる可能性があります。
参考
- Dom\HTMLDocument::createEmpty
- Dom\HTMLDocument::createFromString