Carrega HTML a partir de uma string

# DOMDocument::loadHTML

(PHP 5, PHP 7, PHP 8)

DOMDocument::loadHTML — Carrega HTML a partir de uma string

### Descrição

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

A função analisa o HTML contido na string `source`. Ao contrário do carregamento de XML, o HTML não precisa ser bem formado para carregar.

Aviso

Use Dom\HTMLDocument para analisar e processar HTML moderno ao invés de DOMDocument.

Esta função interpreta a entrada usando um analisador de HTML 4. As regras de análise de HTML 5, que são as que os navegadores 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 para sanitizar HTML de forma segura.

O comportamento ao interpretar HTML pode depender da versão da `libxml` que está sendo usada, particularmente em relação a condições de contorno e manipulação de erros. Para interpretação que se conforma à especificação HTML5, use Dom\HTMLDocument::createFromString() ou Dom\HTMLDocument::createFromFile(), adicionado no PHP 8.4.

Como um exemplo, alguns elementos HTML irão fechar implicitamente um elemento pai quando encontrados. As regras para fechamento automático de elementos pai diferem entre HTML 4 e HTML 5 e por isso a estrutura DOM resultante que DOMDocument enxerga pode ser diferente da estrutura DOM que um navegador enxerga, possivelmente permitindo a um intruso quebrar o HTML resultante.

### Parâmetros

`source`

  A string 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 `source`, 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->loadHTML("<html><body>Test<br></body></html>");
    echo $doc->saveHTML();
    ?>

### Veja Também

- DOMDocument::loadHTMLFile() - Carrega HTML de um arquivo
- DOMDocument::saveHTML() - Despeja o documento interno em uma string usando formatação HTML
- DOMDocument::saveHTMLFile() - Despeja o documento interno em um arquivo usando formatação HTML

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open