Перейти до вмісту

Журнал помилок 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, і це різниця між налагоджувальним плагіном і налагоджувальним плагіном, який раз на тиждень ламає інтеграцію.

Що робити зі знайденою помилкою

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

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

І обмежте розмір файла. Ротація в налаштуваннях плагіна тримає журнал у розумних межах, а журнал без межі одного разу займе диск і впустить сайт сильніше, ніж помилка, яку в ньому шукали.

Чого плагін не робить

Один плагін замість трьох: окремий для констант, окремий для журналу й окремий для cron дають три сторінки й жодної спільної картини.

Поруч: зберігання логів про те, як плагін безпеки зберігає свої записи, і ключові змінні PHP про налаштування, які читає ця панель.

Перевіряйте журнал після кожного оновлення: нові попередження видно лише в динаміці.

І порівнюйте кількість рядків до і після релізу: різниця показує, що саме почало падати.