Как установить и настроить WPConfig Logger для логирования ошибок в WordPress

Автор: Алина Полякова | Опубликовано: 27.02.2026

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

Что такое WPConfig Logger и зачем он нужен

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

Основные преимущества WPConfig Logger:

Гибкая настройка уровня логирования (ошибки, предупреждения, информация).
Логирование в отдельный файл с возможностью указать путь.
Возможность добавлять собственные сообщения в лог через функции плагина.
Минимальное влияние на производительность сайта.

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

Установка плагина WPConfig Logger

Для установки плагина выполните следующие шаги:

Скачайте архив с плагином с официального сайта или репозитория WPConfig Logger на WPSHOP.RU.
Зайдите в админку WordPress, перейдите в раздел "Плагины" → "Добавить новый" → "Загрузить плагин".
Выберите скачанный архив и нажмите "Установить".
Активируйте плагин после установки.

После активации плагина нужно настроить параметры логирования в файле wp-config.php.

Настройка логирования в wp-config.php

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

define('WPCONFIG_LOGGER_ENABLED', true); // Включение логирования
// Уровни логирования: E_ERROR | E_WARNING | E_NOTICE | E_ALL
// Рекомендуется использовать E_ALL для полного логирования

// Уровень логирования ошибок
if (!defined('WPCONFIG_LOGGER_LEVEL')) {
    define('WPCONFIG_LOGGER_LEVEL', E_ALL);
}

// Путь к файлу лога (относительно корня сайта)
if (!defined('WPCONFIG_LOGGER_FILE')) {
    define('WPCONFIG_LOGGER_FILE', WP_CONTENT_DIR . '/wpconfig-logs/error.log');
}

Обратите внимание, что папка wpconfig-logs должна существовать в каталоге wp-content и иметь права на запись. Если папки нет, создайте её вручную.

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

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

Помимо стандартного логирования PHP-ошибок, WPConfig Logger предоставляет функцию для записи пользовательских сообщений в лог. Это удобно для отладки своих функций, хуков и AJAX-запросов.

Пример использования функции wpconfig_logger_log():

if (!function_exists('wpconfig_logger_log')) {
    /**
     * Записывает сообщение в лог WPConfig Logger.
     * @param string $message Текст сообщения
     * @param string $level Уровень важности ('info', 'warning', 'error')
     */
    function wpconfig_logger_log($message, $level = 'info') {
        if (!defined('WPCONFIG_LOGGER_ENABLED') || !WPCONFIG_LOGGER_ENABLED) return;
        $levels = ['info' => 'INFO', 'warning' => 'WARNING', 'error' => 'ERROR'];
        $levelStr = isset($levels[$level]) ? $levels[$level] : 'INFO';
        $date = date('Y-m-d H:i:s');
        $logMessage = "[{$date}] [{$levelStr}] {$message}\n";
        error_log($logMessage, 3, WPCONFIG_LOGGER_FILE);
    }
}

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

wpconfig_logger_log('Произошло событие обновления данных пользователя с ID ' . $user_id, 'info');

Практический пример: логирование AJAX-запросов

Часто возникает необходимость отследить ошибки в AJAX-запросах. Рассмотрим, как с помощью WPConfig Logger добавлять записи в лог при обработке AJAX.

Добавьте следующий код в файл functions.php вашей темы или в свой плагин:

add_action('wp_ajax_wpconfig_log_test', 'wpconfig_wp_ajax_log_test');
function wpconfig_wp_ajax_log_test() {
    wpconfig_logger_log('Начинаем обработку AJAX запроса wpconfig_log_test', 'info');

    // Пример ошибки
    if (!isset($_POST['param'])) {
        wpconfig_logger_log('Ошибка: отсутствует параметр param в AJAX запросе', 'error');
        wp_send_json_error(['message' => 'Не передан параметр param']);
    }

    $param = sanitize_text_field($_POST['param']);
    wpconfig_logger_log('Получен параметр param: ' . $param, 'info');

    // Обработка запроса...

    wp_send_json_success(['message' => 'AJAX запрос успешно обработан']);
}

Таким образом, вы сможете отслеживать весь процесс обработки AJAX прямо в логах.

Оптимизация и ротация логов

При активном логировании размер файла лога может быстро вырасти. Чтобы избежать проблем с заполнением диска, рекомендуется настроить ротацию логов. Например, можно использовать системные задачи cron для архивирования и очистки логов.

Пример скрипта для ротации (bash):

# Архивировать текущий лог и очистить
if [ -f /path_to_wp_content/wpconfig-logs/error.log ]; then
    mv /path_to_wp_content/wpconfig-logs/error.log /path_to_wp_content/wpconfig-logs/error_$(date +"%Y%m%d_%H%M%S").log
    touch /path_to_wp_content/wpconfig-logs/error.log
fi

Запланируйте этот скрипт на выполнение ежедневно или еженедельно в зависимости от интенсивности логирования.

Дополнительные советы и рекомендации

Права доступа к файлам и безопасности

Убедитесь, что папка с логами закрыта от прямого доступа через веб-сервер. Добавьте в неё файл .htaccess с содержимым:

deny from all

Это предотвратит просмотр логов посторонними через браузер.

Интеграция с другими плагинами

WPConfig Logger отлично сочетается с плагинами безопасности и оптимизации, такими как Clearfy Pro, для комплексного контроля сайта.

Поддержка и обновления

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