DOMDocument::loadHTMLFile
(PHP 5, PHP 7, PHP 8)
DOMDocument::loadHTMLFile — Завантаження HTML із файлу
Опис
public DOMDocument::loadHTMLFile(string $filename, int $options = 0): bool
Функция разбирает HTML-документ из файлаfilename. На відміну від завантаження XML, HTML не повинен бути правильно побудований для завантаження.
Увага
Ця функція аналізує вхідні дані, використовуючи синтаксичний аналізатор HTML 4. У браузері вбудований синтаксичний аналізатор HTML 5, який має інші правила аналізу. Яку структуру DOM буде сформовано — залежить від вхідних даних. Тому цю функцію не можна використовувати для безпечного очищення HTML.
Наприклад, деякі HTML-елементи неявно закриватимуть батьківський елемент. Правила для автоматичного закриття батьківських елементів HTML 4 і HTML 5 різні, тому результуюча структура DOM, яку бачить об'єкт класу DOMDocument може відрізнятись від структури DOM, яку бачить веб-браузер, що дає можливість зловмиснику зламати результуючий HTML.
Список параметрів
filename
Шлях до HTML-файлу.
options
Побітове АБО (OR) . констант опцій libxml
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Помилки
Якщо через аргумент filename передано порожній рядок або файл нічого не містить, буде згенеровано попередження. Це попередження не генерується libxml, тому воно не може бути оброблено функціями обробки помилок libxml
Незважаючи на те, що некоректний HTML зазвичай успішно завантажується, ця функція може генерувати помилки рівня E_WARNING при виявленні поганої розмітки. Для обробки цих помилок можна використовувати функції обробки помилок libxml
список змін
| Версия | Опис |
|---|---|
| 8.3.0 | Тепер функція має попередній логічний (bool) тип значення, що повертається. |
| 8.0.0 | При статичному виклику функції тепер викидається помилка Error. . Раніше видавалася помилка рівня E_DEPRECATED |
Приклади
Приклад #1 Створення документа
Дивіться також
- DOMDocument::loadHTML() - Завантаження HTML з рядка
- DOMDocument::saveHTML() - Зберігає документ із внутрішнього подання до рядка, використовуючи форматування HTML
- DOMDocument::saveHTMLFile() - Зберігає документ із внутрішнього подання до файлу, використовуючи форматування HTML