WordPress: отладка и решение ошибок через логи

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

Почему важно использовать логи для отладки WordPress

В стандартной установке WordPress большинство ошибок скрыто от пользователя и администратора. Это сделано для безопасности и удобства, но усложняет поиск причины неполадок. Логи позволяют:

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

Без логов вы будете искать проблему «вслепую», тратя часы на догадки.

Как включить логирование ошибок в WordPress

Чтобы включить отладку в WordPress, нужно отредактировать файл wp-config.php. Добавьте или измените следующие строки:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);

Объяснение настроек:

• WP_DEBUG — основной режим отладки, включает вывод ошибок;
• WP_DEBUG_LOG — ошибки сохраняются в файл wp-content/debug.log;
• WP_DEBUG_DISPLAY и ini_set отключают вывод ошибок на экран — это важно для безопасности, чтобы посетители не видели внутренние ошибки.

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

Анализ и работа с файлом debug.log

Файл debug.log — ваш основной источник информации об ошибках. Чтобы быстро находить нужные записи, используйте текстовые редакторы с поиском и фильтрацией, например Notepad++, VSCode или grep в терминале.

Типичные ошибки в логе выглядят так:

[15-Jun-2024 14:23:45 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function wpfaq_my_function() in /var/www/html/wp-content/plugins/myplugin/myplugin.php on line 45

По сообщению видно, что вызвана неопределённая функция wpfaq_my_function(). Это значит, что либо функция не объявлена, либо плагин подключён неправильно.

Если вы видите много предупреждений (warnings) или уведомлений (notices), имеет смысл постепенно их исправлять, так как они могут влиять на работу сайта.

Логирование пользовательских данных и отладка плагинов

Иногда нужно логировать не только ошибки PHP, но и свои данные для анализа работы плагина или темы. Для этого можно использовать функцию error_log():

function wpfaq_log_message($message) {
    if (defined('WP_DEBUG') && WP_DEBUG) {
        if (is_array($message) || is_object($message)) {
            $message = print_r($message, true);
        }
        error_log('[WPFAQ] ' . $message);
    }
}

// Пример использования
wpfaq_log_message('Плагин запустился успешно');

Такие записи будут попадать в debug.log. Это удобно для отслеживания состояния плагина или результата выполнения функций.

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

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

• Query Monitor — мощный инструмент для отладки запросов к базе данных, ошибок PHP, хуков и HTTP-запросов.
• Debug Bar — добавляет панель разработчика с информацией о запросах, ошибках и кэше.
• Log Deprecated Notices — помогает отследить устаревшие функции и методы в коде.

Все эти плагины бесплатны и значительно упрощают диагностику проблем на сайте.

Пример решения ошибки с подключением плагина

Рассмотрим ситуацию, когда в логе появляется ошибка вида:

PHP Fatal error:  Uncaught Error: Call to undefined function wpfaq_my_function() in /wp-content/plugins/myplugin/myplugin.php on line 45

Это значит, что функция wpfaq_my_function() вызывается, но не определена. Проверяем файл плагина:

<?php
// Неправильно
wpfaq_my_function();

function wpfaq_my_function() {
    // код функции
}
?>

Проблема в том, что функция вызывается до её объявления. Нужно изменить порядок:

<?php
function wpfaq_my_function() {
    // код функции
}

wpfaq_my_function();
?>

Или обернуть вызов в хук, который гарантирует загрузку функций:

add_action('init', 'wpfaq_my_function');

function wpfaq_my_function() {
    // код функции
}

После исправления ошибка исчезнет из лога.

Как отключить логирование после отладки

Включать логирование на продакшн-сайте не рекомендуется, так как файл debug.log может быстро расти и занимать много места, а ошибки не должны показываться пользователям.

Чтобы отключить отладку, просто в wp-config.php установите значения:

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

Это вернёт сайт в нормальный режим без логирования.

Полезные советы для эффективной отладки WordPress

• Регулярно проверяйте debug.log после установки новых плагинов и тем.
• Используйте локальную копию сайта или staging-сервер для включения полной отладки.
• Применяйте плагин Clearfy Pro для оптимизации и отключения лишних функций, которые могут генерировать ошибки.
• Если у вас плагин с собственным логированием, например, Expert Review, используйте его возможности для диагностики бизнес-логики.
• В случаях сложных ошибок включайте расширенный PHP-лог на сервере через настройки php.ini.

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