« DOMDocument::loadDOMDocument::loadHTMLFile »PHP ManualDOMDocument

DOMDocument::loadHTML

(PHP 5, PHP 7, PHP 8)

DOMDocument::loadHTML — Завантаження HTML з рядка

Опис

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

Функція розбирає HTML, що міститься у рядку source. На відміну від завантаження XML, HTML не повинен бути правильно побудований для завантаження.

Увага

Ця функція аналізує вхідні дані, використовуючи синтаксичний аналізатор HTML 4. У браузері вбудований синтаксичний аналізатор HTML 5, який має інші правила аналізу. Яку структуру DOM буде сформовано — залежить від вхідних даних. Тому цю функцію не можна використовувати для безпечного очищення HTML.

Наприклад, деякі HTML-елементи неявно закриватимуть батьківський елемент. Правила для автоматичного закриття батьківських елементів HTML 4 і HTML 5 різні, тому результуюча структура DOM, яку бачить об'єкт класу DOMDocument може відрізнятись від структури DOM, яку бачить веб-браузер, що дає можливість зловмиснику зламати результуючий HTML.

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

source

HTML-рядок.

options

Побітове АБО (OR) . констант опцій libxml

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

Помилки

Якщо через аргумент source передано порожній рядок, буде згенеровано попередження. Це попередження не генерується libxml, тому воно не може бути оброблено функціями обробки помилок libxml.

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

список змін

ВерсияОпис
8.3.0Тепер функція має попередній логічний (bool) тип значення, що повертається.
8.0.0При статичному виклику функції тепер викидається помилка Error. . Раніше видавалася помилка рівня E_DEPRECATED

Приклади

Приклад #1 Створення документа

Loading...

Дивіться також

  • DOMDocument::loadHTMLFile() - Завантаження HTML із файлу
  • DOMDocument::saveHTML() - Зберігає документ із внутрішнього подання до рядка, використовуючи форматування HTML
  • DOMDocument::saveHTMLFile() - Зберігає документ із внутрішнього подання до файлу, використовуючи форматування HTML