Отключение предупреждений PHP DomDocument при парсинге HTML

Быстрый ответ

Если требуется загрузить некорректный HTML в DomDocument, воспользуйтесь функцией libxml_use_internal_errors(true). Она подавляет все предупреждения в фоне. Для более чистой обработки примените $dom->loadHTML($html, LIBXML_NOWARNING | LIBXML_NOERROR).

libxml_use_internal_errors(true);
$dom = new DomDocument();
$dom->loadHTML($html, LIBXML_NOWARNING | LIBXML_NOERROR); // Так, как незаметно поскользнуться на банане!
libxml_clear_errors();  // А здесь – как убрать все следы после незамеченного падения!

Вызывайте эти функции до начала обработки, чтобы избежать проблем с некорректным HTML.

Организация обработки ошибок с помощью libxml

Если под рукой оказался нерабочий HTML, не беспокойтесь: используйте libxml для эффективной обработки ошибок. Перед обработкой включите libxml_use_internal_errors(true) для подавления предупреждений. Затем после парсинга вызывайте libxml_get_errors(), чтобы оценить возникшие в процессе загрузки HTML ошибки.

Корректировка ошибок

Когда придёт время ликвидировать последствия обработки кода, используйте libxml_get_errors():

$errors = libxml_get_errors();
foreach ($errors as $error) {
    // Здесь как будто бы распылили инсектицид на скопление ошибок!
}
libxml_clear_errors(); // И все следы ошибки удалены!

Подробнее об этом расскажет наш спикер на видео

Восстановление первоначального состояния

После выполнения всех операций с DOM важно возвращать систему в исходное состояние методом libxml_use_internal_errors(false). Это вернёт систему в прежнее состояние обработки ошибок:

$previous_state = libxml_use_internal_errors(true);
// Загружаем HTML, обрабатываем ошибки и т.д.
libxml_use_internal_errors($previous_state);  // И возвращаемся в исходное состояние, как будто ничего и не происходило!

Продвинутое управление ошибками

Можно выстроить систему обработки ошибок искуснее и организовать отдельный класс с методами для перехвата, получения и очистки ошибок.

Визуализация

Представьте, что загрузка HTML-кода в DomDocument не отключая предупреждения, это как наполнять дырявое ведро водой:

До: 🪣🌊 (Дырявое ведро + Вода = Везде предупреждения!)

А вот с libxml_use_internal_errors(true) получается совсем иначе:

После: 🪣🔇🌊 (Целое ведро + Тишина = Безупречная загрузка HTML!)

Таким образом, в вашем ведре оказывается только чистая вода, без всплесков и утечек.

Расширенные методы обработки ошибок

Для успешного решения проблем обработки HTML, помимо подавления предупреждений, существуют ещё некоторые полезные приёмы:

Пользовательский обработчик ошибок

Создайте собственный обработчик ошибок:

set_error_handler('myCoolErrorHandler');   // Это как нанять личного охранника для своих ошибок!
// Здесь идёт загрузка HTML
restore_error_handler();   // Не забудьте всё вернуть на прежние рельсы!

Не забывайте возвращать обработчик ошибок в исходное состояние, чтобы остальная часть программы продолжала работать без сбоев.

Использование блоков try-catch

Защитите процесс загрузки с помощью блоков try-catch, чтобы подавить исключения DOMExceptions:

try {
    $dom->loadHTML($html, LIBXML_NOWARNING | LIBXML_NOERROR);
} catch (DOMException $e) {
    // Любое обработанное исключение – это шаг к победе над ошибками!
}

Соблюдение чистоты кода

Всегда следите за сохранением и восстановлением первоначального состояния контроля ошибок, чтобы не нарушать работу других частей приложения.

Полезные материалы

1. PHP: DOMDocument::loadHTML – Руководство — Официальное руководство PHP для работы с DOMDocument.
2. PHP: libxml_use_internal_errors – Руководство — Подробное описание использования libxml в PHP для подавления предупреждений.
3. html – PHP DOMDocument errors/warnings on html5-tags – Stack Overflow — Ответы сообщества разработчиков по вопросу об использовании DomDocument::loadHTML().
4. Сервис проверки разметки W3C — Инструмент для проверки корректности HTML.
5. PHP: Путь к совершенству — Полезное руководство по работе с ошибками и предупреждениями в PHP.
6. Лучшие практики PHP: краткое руководство по распространенным задачам PHP — Наглядное руководство по работе с XML и HTML в PHP.
7. Введение в DOM – Web APIs | MDN — Простое и понятное объяснение принципов работы DOM от MDN Web Docs.