WP_DEBUG: как включать отладку и не устраивать пожар на живом сайте

WP_DEBUG: как включать отладку и не устраивать пожар на живом сайте

WP_DEBUG — это не «сломать сайт», а показать, где именно он уже ломается. Включают его в wp-config.php, но только вместе с дисциплиной: отладка должна писать ошибки в лог, а не светить их посетителю.

Базовый набор для рабочего сайта:
— define('WP_DEBUG', true);
— define('WP_DEBUG_LOG', true);
— define('WP_DEBUG_DISPLAY', false);

Так ошибки уйдут в wp-content/debug.log, а на фронте не появятся предупреждения, пути к файлам и служебный шум. Если поставить только WP_DEBUG без остальных флагов, можно случайно раскрыть внутренности темы, плагина или сервера.

Проверяйте не только сам факт ошибки, но и место, где она возникает: тема, плагин, mu-plugin, кастомный код. Частая ошибка — включили лог, увидели notice и решили, что виноват WordPress. На деле проблема часто в кривом хукe, неинициализированной переменной или вызове функции до загрузки нужного файла ⚙️

Если лог разрастается, чистите его перед новой проверкой и ловите только свежие записи. И не держите постоянный debug-режим на боевом сайте без причины: он полезен для поиска поломки, но вреден как привычка.

Когда ошибка найдена, отключайте логирование и проверяйте сайт в обычном режиме. Так WP_DEBUG работает как инструмент диагностики, а не как постоянный источник лишнего шума.