DOMDocument::loadHTMLFile

(PHP 5, PHP 7, PHP 8)

DOMDocument::loadHTMLFile Carrega HTML de um arquivo

Descrição

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

A função analisa o documento HTML no arquivo com o nome filename. Ao contrário do carregamento de XML, o HTML não precisa ser bem formado para ser carregado.

Aviso

Esta função analisa a entrada usando um analisador HTML 4. As regras de análise do HTML 5, que é o que os navegadores web modernos usam, são diferentes. Dependendo da entrada, isso pode resultar em uma estrutura DOM diferente. Portanto, esta função não pode ser usada com segurança para sanitizar HTML.

Como exemplo, alguns elementos HTML fecharão implicitamente um elemento pai quando encontrados. As regras para fechar automaticamente os elementos pais diferem entre HTML 4 e HTML 5 e, portanto, a estrutura DOM resultante que DOMDocument vê pode ser diferente da estrutura DOM que um navegador web vê, possibilitando que um invasor quebre o HTML resultante.

Parâmetros

filename

O caminho para o arquivo HTML.

options

Bit a bit OR das constantes de opções da libxml.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Se uma string vazia for passada como o filename ou um arquivo vazio for nomeado, um aviso será gerado. Este aviso não é gerado pelo libxml e não pode ser tratado usando as funções de manipulação de erros do libxml.

Embora o HTML malformado deva ser carregado com sucesso, esta função pode gerar erros E_WARNING quando encontrar marcação incorreta. As funções de tratamento de erros da biblioteca libxml podem ser usadas para lidar com esses erros.

Registro de Alterações

Versão Descrição
8.3.0 Esta função agora tem um tipo de retorno bool tentativo.
8.0.0 Chamando esta função estaticamente agora irá gerar um Error. Anteriormente, era gerado um E_DEPRECATED.

Exemplos

Exemplo #1 Criando um Documento

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

Veja Também