Debug Log Router

Описание

Большинство инструментов для отладочного лога показывают один debug.log, который пишет WordPress. Debug Log Router вместо этого раскладывает записи по типу запроса: ошибка, которую увидел посетитель на сайте, предупреждение из админки и сбой фоновой задачи cron попадают в разные файлы. Вы сразу видите, чего стоила ошибка, а ошибки cron, которые не показываются ни на одной странице, больше не тонут среди остальных.

Семь контекстов, семь файлов

• front.log — публичная часть сайта
• admin.log — админка
• ajax.log — запросы admin-ajax
• rest.log — REST API, включая пользовательский префикс REST
• cron.log — WP-Cron
• cli.log — WP-CLI
• xmlrpc.log — XML-RPC

Файлы создаются по мере необходимости: на сайте без WP-CLI файл cli.log никогда не появится. Записи пишутся в обычном формате лога PHP, поэтому файлы по-прежнему открываются в любом текстовом редакторе и по FTP.

Просмотр и скачивание

• «Инструменты → Логи отладки», вкладка «Логи»: свежие записи сверху, по 50 за раз, до 500 записей в браузере.
• Там же находится журнал собственных действий плагина: что он менял в wp-config.php и в каталоге логов и что сделать не смог.
• Любой лог и журнал можно скачать файлом на вкладке «Логи». Весь каталог логов скачивается zip-архивом на вкладке «Настройки», если на сервере есть расширение PHP zip; без него файлы скачиваются по одному.
• Старый wp-content/debug.log остаётся нетронутым и открывается в том же просмотрщике.
• Логирование включается и выключается одним переключателем на вкладке «Настройки».
• По умолчанию ошибки скрыты от посетителей. Вы можете показывать их или оставить это на усмотрение сервера.

Как плагин работает с wp-config.php

Отладочные константы WordPress читает до загрузки любых плагинов, поэтому без wp-config.php не обойтись. Плагин меняет его один раз:

• Активация ничего не меняет. Правка происходит только по кнопке на вкладке «Состояние», и до нажатия показано, что именно будет добавлено.
• Изменённый файл проверяется до того, как заменит оригинал: если в результате есть синтаксическая ошибка или что-то не так, как ожидалось, wp-config.php остаётся в точности прежним. Права, владелец и группа файла сохраняются.
• В конфиг вставляется короткий блок, который подключает загрузчик плагина и называет папку плагина в каталоге загрузок. Все настройки живут там и в базе данных. Переключение логирования и остальные настройки wp-config.php больше не трогают.
• Существующие строки define() для WP_DEBUG, WP_DEBUG_LOG и WP_DEBUG_DISPLAY не удаляются, а комментируются с пометкой DLOGR-DISABLED.
• Если файл недоступен для записи, плагин покажет готовый фрагмент, номер строки для вставки и кнопку копирования.
• Блок удаляется кнопкой «Убрать настройку из wp-config.php» или при удалении плагина, а закомментированные строки восстанавливаются.
• Если файлы плагина удалили по FTP, блок ничего не делает, и сайт работает как обычно.
• Вкладка «Состояние» предупреждает, когда те же константы определены выше блока, и если блок на месте, но плагин не загружается — например, после переезда сайта, — и предлагает кнопку, которая перезапишет блок с текущими путями.

Каталог логов

Логи хранятся в папке wp-content/uploads/debug-log-router/dlogr-logs-xxxxxxxx (или там, где на вашем сайте каталог загрузок), где последние восемь символов случайные. Главная защита — это имя: адрес каталога нельзя угадать. Второй слой: .htaccess, который закрывает прямой доступ на Apache и LiteSpeed. Имя каталога можно сменить одной кнопкой, если оно где-то засветилось. PHP-файлы в каталог загрузок плагин не пишет.

Конфиденциальность

Плагин не отправляет никаких данных за пределы вашего сервера и не обращается к внешним сервисам. Учтите, что сами логи PHP могут содержать пути на диске, фрагменты SQL-запросов и данные пользователей сайта. Поэтому доступ к ним есть только у администраторов, а каталог логов защищён, как описано выше. Журнал собственных действий плагина записывает, кто из пользователей выполнил каждое действие.

Мультисайт

Сети WordPress (мультисайт) не поддерживаются: плагин не тестировался на них и не заявляет о работоспособности в этой среде.

Языки

Тексты плагина выводятся на языке вашего профиля WordPress; переводы поступают в виде языковых пакетов с translate.wordpress.org. На вкладке «Настройки» страницу плагина можно отдельно переключить на английский, а остальной WordPress сохраняет ваш язык: удобно, когда вы ищете сообщение об ошибке или отправляете скриншот в поддержку.

Поддержка

Вкладка «Поддержка» поясняет, что делает плагин и куда сообщать об ошибках, а также показывает версию и лицензии.

Благодарности

Иконки — Lucide (https://lucide.dev), лицензия ISC. Часть иконок взята из проекта Feather, лицензия MIT. Текст лицензий — в assets/icons/LICENSE.