Перейти к содержимому

Журнал ошибок WordPress: 8 вкладок без SSH

debug.log на живом сайте обычно начинается как хорошая идея и превращается в файл на десять мегабайт, который никто не открывает: чтобы его прочитать, нужен SSH, tail и мысленный фильтр на четыре тысячи уведомлений об устаревшей функции. Журнал ошибок WordPress полезен только тогда, когда он отфильтрован, ограничен и доступен из админки.

Код: GLOBUS Debug Control, лицензия GPLv2 или новее.

WordPress 5.2 и новее, PHP 7.4 и новее, восемь вкладок в настройках и никакого редактирования файлов.

Вкладка 1: что подавляется

Уведомления, deprecations, предупреждения и strict-ошибки отключаются независимо. У режима отображения три состояния: наследовать, включить, выключить.

Смысл именно в разделении. Один плагин на современном PHP выдаёт сотни deprecations, когда сайт работает правильно, и журнал, полный ими, скрывает то единственное предупреждение, которое важно. Отключённые deprecations оставляют предупреждение видимым.

Вкладка 2: константы из админки

WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY, SCRIPT_DEBUG и SAVEQUERIES переключаются со страницы. wp-config.php правится на месте с резервной копией по времени, а закомментированные define не трогаются никогда.

Последнее правило и делает это безопасным на сервере, где кто-то держит отключённую строку как документацию. Плагин, который перезаписывает комментарии, стирает запись о том, зачем строка была нужна.

Вкладки 3 и 4: журнал и расписание

Журнал открывается в редакторе с номерами строк, цветами по уровню, страницами, опросом в реальном времени, скачиванием и очисткой в один клик. Большие файлы читаются с конца, поэтому журнал на двести мегабайт не съедает memory_limit до отрисовки страницы.

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

Вкладки 5, 6 и 7: что раздувает запрос

Транзиенты показываются с размером и сроком, просроченные чистятся одним кликом. Автозагружаемые опции показывают двести самых тяжёлых, и именно там конструктор страниц прячет сериализованный блок, который грузится на каждом запросе.

HTTP-лог перехватывает исходящие запросы WordPress через http_api_debug: метод, код ответа, время, класс транспорта и замаскированные параметры. Оформление заказа, которое ждёт платёжного провайдера четыре секунды, видно здесь одной строкой.

Вкладка 8 и правило под всеми остальными

Константы группируют значения времени выполнения по категориям и автоматически маскируют пароли базы, ключи авторизации и соли.

Ошибки подавляются в AJAX, REST, WP-Cron, WP-CLI и XML-RPC независимо от режима отображения. Это то решение, которое сохраняет ответы API валидным JSON, и это разница между отладочным плагином и отладочным плагином, который раз в неделю ломает интеграцию.

Что делать с найденной ошибкой

Читайте трассировку снизу вверх: ближний к вашему коду кадр сверху, а имя плагина или темы в пути это первый подозреваемый. Потом воспроизведите ошибку один раз с выключенным подавлением, чтобы номера строк совпали.

Запишите время до того, как очистить журнал. Очищенный журнал без заметки это способ сделать баг неисправимым через неделю.

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

Чего плагин не делает

Он не правит код, не заменяет профайлер и не читает серверные логи вне WordPress. Он и не скрывает ошибки от разработчика, которому они нужны: подавление это настройка, а журнал остаётся доступным.

Один плагин вместо трёх: отдельный для констант, отдельный для журнала и отдельный для cron дают три страницы и ни одной общей картины.

Рядом: хранение логов о том, как плагин безопасности хранит свои записи, и ключевые переменные PHP о настройках, которые читает эта панель.