PHP 7.4.8 Released!


(PHP 5, PHP 7)

DOMDocument::loadHTMLFile Загрузка HTML из файла


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

Функция разбирает HTML-документ из файла filename. В отличие от загрузки XML, HTML не должен быть правильно построенным (well-formed).

Список параметров


Путь к HTML-файлу.


Начиная с версии PHP 5.4.0 и Libxml 2.6.0, можно также использовать параметр options для указания дополнительных параметров Libxml.

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки. Если вызвана статически, возвращает объект класса DOMDocument или FALSE в случае возникновения ошибки.


Если через аргумент filename передана пустая строка или файл ничего не содержит, будет сгенерировано предупреждение. Это предупреждение генерируется не libxml, поэтому оно не может быть обработано функциями обработки ошибок libxml.

Этот метод может быть вызван статически, но при этом будет сгенерирована ошибка уровня E_STRICT.

Несмотря на то, что некорректный HTML обычно успешно загружается, данная функция может генерировать ошибки уровня E_WARNING при обнаружении плохой разметки. Для обработки данных ошибок можно воспользоваться функциями обработки ошибок libxml.


Пример #1 Создание документа

= new DOMDocument();

Список изменений

Версия Описание
5.4.0 Добавлен параметр options.

Смотрите также

  • DOMDocument::loadHTML() - Загрузка HTML из строки
  • DOMDocument::saveHTML() - Сохраняет документ из внутреннего представления в строку, используя форматирование HTML
  • DOMDocument::saveHTMLFile() - Сохраняет документ из внутреннего представления в файл, используя форматирование HTML

add a note add a note

User Contributed Notes 6 notes

onemanbanddan at gmail dot com
6 years ago
The options for surpressing errors and warnings will not work with this as they do for loadXML()
will not work.
you must use:
and handle the exceptions as neccesarry.
andy at carobert dot com
15 years ago
This puts the HTML into a DOM object which can be parsed by individual tags, attributes, etc..  Here is an example of getting all the 'href' attributes and corresponding node values out of the 'a' tag. Very cool....

= <<<EOF
<title>My Page</title>
<p><a href="/mypage1">Hello World!</a></p>
<p><a href="/mypage2">Another Hello World!</a></p>

$doc = new DOMDocument();

$tags = $doc->getElementsByTagName('a');

foreach (
$tags as $tag) {
$tag->getAttribute('href').' | '.$tag->nodeValue."\n";

This should output:

/mypage1 | Hello World!
/mypage2 | Another Hello World!
Mark Omohundro, ajamyajax dot com
11 years ago
// try this html listing example for all nodes / includes a few getElementsByTagName options:

$file = $DOCUMENT_ROOT. "test.html";
$doc = new DOMDocument();

// example 1:
$elements = $doc->getElementsByTagName('*');
// example 2:
$elements = $doc->getElementsByTagName('html');
// example 3:
//$elements = $doc->getElementsByTagName('body');
// example 4:
//$elements = $doc->getElementsByTagName('table');
// example 5:
//$elements = $doc->getElementsByTagName('div');

if (!is_null($elements)) {
  foreach (
$elements as $element) {
"<br/>". $element->nodeName. ": ";

$nodes = $element->childNodes;
    foreach (
$nodes as $node) {
$node->nodeValue. "\n";
5 years ago
In this post I found a simple way to get the content of a URL with DOMDocument, loadHTMLFile and saveHTML().

function getURLContent($url){
    $doc = new DOMDocument;
    $doc->preserveWhiteSpace = FALSE;
    return $doc->saveHTML();
gzech at SPAMFILTER dot eso dot org
13 years ago
If you want to suppress output warnings from loadHTMLFile($url), put an @ sign in front. This even works in:
= @$dom->loadHTMLFile($url);
bens at effortlessis dot com
15 years ago
Note that this function doesn't parse the individual tags WITHIN the html file - it's all loaded as a "black box", and you end up with an XML widget that comprises nothing but the complete chunk of HTML.

I was hoping it would function as a sort of HTML-validator/parser, but that doesn't seem to be the case.
To Top