Dom\HTMLDocument::createFromFile

(PHP 8 >= 8.4.0)

Dom\HTMLDocument::createFromFile — Parses an HTML document from a file

Description

public static Dom\HTMLDocument::createFromFile(string $path, int $options = 0, ?string $overrideEncoding = null): Dom\HTMLDocument

Parses an HTML document from a file, according to the living standard.

Parameters

path
The path to the file to parse.
options
Bitwise OR of the libxml option constants. It is also possible to pass Dom\HTML_NO_DEFAULT_NS to disable the use of the HTML namespace and the template element. This should only be used if the implications are properly understood.
overrideEncoding
The encoding that the document was created in. If not provided, it will attempt to determine the encoding that is most likely used.

Return Values

The parsed document as an Dom\HTMLDocument instance.

Errors/Exceptions

  • Throws a ValueError if path contains null bytes or contains "%00".
  • Throws a ValueError if options contains an invalid option.
  • Throws a ValueError if overrideEncoding is an unknown encoding.
  • Throws an Exception if the file could not be opened.

Notes

Note: Whitespace in the html and head tags is not considered significant and may lose formatting.

See Also