(PHP 5, PHP 7, PHP 8)
DOMDocument::loadHTMLFile — Charge du HTML à partir d'un fichier
Cette fonction analyse un document HTML contenu dans le fichier
filename
. Contrairement au XML, le HTML n'a pas
besoin d'être bien formé pour être chargé.
Utilisez Dom\HTMLDocument pour analyser et traiter le HTML moderne au lieu de DOMDocument.
Cette fonction analyse l'entrée en utilisant un parseur HTML 4. Les règles d'analyse du HTML 5, qui sont celles utilisées par les navigateurs web modernes, sont différentes. Selon l'entrée, cela peut entraîner une structure DOM différente. Par conséquent, cette fonction ne peut pas être utilisée en toute sécurité pour la sanitisation du HTML.
Le comportement lors de l'analyse du HTML peut dépendre de la version de
libxml
qui est utilisée, notamment en ce qui concerne
les conditions limites et la gestion des erreurs.
Pour une analyse conforme à la spécification HTML5,
utilisez Dom\HTMLDocument::createFromString() ou
Dom\HTMLDocument::createFromFile(), ajoutés dans PHP 8.4.
Par exemple, certains éléments HTML fermeront implicitement un élément parent lorsqu'ils sont rencontrés. Les règles de fermeture automatique des éléments parents diffèrent entre HTML 4 et HTML 5, et par conséquent, la structure DOM que DOMDocument voit peut être différente de celle qu'un navigateur web voit, ce qui peut éventuellement permettre à un attaquant de compromettre le HTML résultant.
filename
Le chemin vers le fichier HTML.
options
Si une chaîne vide est passée comme paramètre filename
ou que le fichier est vide, une alerte sera générée. Cette alerte n'est pas générée
par libxml, et ne peut être gérée en utilisant les
fonctions de gestion d'erreur de libxml.
Bien que le HTML mal-formé devrait se charger avec succès, cette fonction peut générer
une alerte de type E_WARNING
lorsqu'elle rencontre une mauvaise balise.
Les fonctions de gestion des erreurs libxml
peuvent être utilisées pour gérer ces erreurs.
Version | Description |
---|---|
8.3.0 | Cette fonction a maintenant un type de retour bool provisoire. |
8.0.0 |
Appeler cette fonction de manière statique lèvera désormais une Error.
Auparavant, une erreur E_DEPRECATED était générée.
|
Exemple #1 Création d'un document
<?php
$doc = new DOMDocument();
$doc->loadHTMLFile("filename.html");
echo $doc->saveHTML();
?>