Как настроить отладку и логирование в wp-config.php для WordPress

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

Почему важно настраивать отладку в wp-config.php

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

• Включить отображение ошибок PHP и предупреждений WordPress;
• Записывать логи ошибок в отдельный файл, не показывая их посетителям;
• Отслеживать проблемы с плагинами и темами;
• Улучшать качество кода и производительность сайта.

Основные константы для отладки в wp-config.php

Для настройки отладки используют несколько ключевых констант. Рассмотрим их подробно.

WP_DEBUG — включение режима отладки

Эта константа активирует режим отладки WordPress. Когда WP_DEBUG установлен в true, WordPress начинает показывать все ошибки, предупреждения и уведомления.

define('WP_DEBUG', true);

Если значение false, отладка отключена:

define('WP_DEBUG', false);

Рекомендуется включать WP_DEBUG в средах разработки и тестирования, но отключать на боевом сайте.

WP_DEBUG_LOG — запись ошибок в файл

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

define('WP_DEBUG_LOG', true);

Это удобно для последующего анализа ошибок без необходимости держать вывод ошибок на экране.

WP_DEBUG_DISPLAY — управление выводом ошибок на экран

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

define('WP_DEBUG_DISPLAY', false);

При false ошибки не показываются в браузере, но сохраняются в лог, если WP_DEBUG_LOG включен.

SCRIPT_DEBUG — использование не сжатых файлов

Эта константа заставляет WordPress использовать несжатые версии CSS и JS, что упрощает отладку фронтенда.

define('SCRIPT_DEBUG', true);

Полезно при разработке тем и плагинов.

Пример полной конфигурации отладки в wp-config.php

Ниже пример, как можно настроить отладку на локальном сервере или тестовом сайте:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
define('SCRIPT_DEBUG', true);

Эти настройки позволят записывать все ошибки в wp-content/debug.log и не показывать их на фронтенде.

Как безопасно использовать отладку на боевом сайте

Включать WP_DEBUG на живом сайте не рекомендуется, так как ошибки могут раскрывать внутреннюю информацию. Но иногда нужно временно включить отладку для диагностики. В этом случае:

• Установите WP_DEBUG_DISPLAY в false, чтобы ошибки не показывались посетителям.
• Включите WP_DEBUG_LOG, чтобы ошибки сохранялись в лог.
• После решения проблемы сразу отключите отладку.

Для удобства можно реализовать условие по IP, чтобы отладка включалась только для вашего адреса:

if ($_SERVER['REMOTE_ADDR'] === 'ваш_IP_адрес') {
    define('WP_DEBUG', true);
    define('WP_DEBUG_LOG', true);
    define('WP_DEBUG_DISPLAY', true);
    define('SCRIPT_DEBUG', true);
} else {
    define('WP_DEBUG', false);
    define('WP_DEBUG_LOG', false);
    define('WP_DEBUG_DISPLAY', false);
    define('SCRIPT_DEBUG', false);
}

Использование плагинов для расширенного логирования и отладки

Помимо стандартных возможностей WordPress, существуют плагины, которые упрощают отладку и добавляют новые функции:

• Clearfy Pro — оптимизация и улучшение безопасности, включая расширенное логирование и контроль ошибок.
• WPConfig Logger — специализированный плагин для удобного логирования ошибок и событий с интерфейсом в админке.

Эти плагины помогут централизовать процесс отладки и быстрее находить проблемы.

Практические советы по работе с логами и отладкой

Для эффективной работы с отладкой и логами рекомендуем:

• Регулярно проверять файл wp-content/debug.log на наличие новых ошибок.
• Использовать редакторы с подсветкой синтаксиса для анализа кода.
• Очищать логи после исправления ошибок, чтобы не перегружать файл.
• Писать собственные функции логирования для важных событий с использованием error_log() PHP.

Пример функции логирования для wpconfig.ru

function wpconfig_log_message($message) {
    if (defined('WP_DEBUG') && WP_DEBUG) {
        error_log('[wpconfig.ru] ' . $message);
    }
}

Используйте эту функцию, чтобы добавлять свои записи в системный лог PHP или в debug.log, если он настроен.