Как создать автоматический отчет об ошибках WordPress с примерами кода и плагинами

Автор: Дмитрий Белов | Опубликовано: 05.04.2026

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

Почему важно иметь автоматический отчет об ошибках WordPress

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

Узнавать о проблемах сразу после их возникновения;
Получать подробную информацию для быстрого исправления;
Отслеживать стабильность сайта и оценивать качество кода;
Снижать время простоя и минимизировать потери.

Реализовать систему можно несколькими способами, о которых мы поговорим ниже.

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

WordPress имеет встроенную систему отладки, которую можно включить в wp-config.php. Для автоматического логирования ошибок нужно добавить следующие строки:

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

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

Однако, файл нужно периодически проверять вручную или настраивать автоматическую отправку его содержимого.

Создание пользовательского обработчика ошибок с отправкой на email

Для автоматизации мы можем использовать PHP-функцию для перехвата ошибок и отправки их на почту или в систему мониторинга. Рассмотрим пример, как добавить обработчик ошибок в WordPress, который будет отправлять отчет на email.

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

function wpcodes_rus_custom_error_handler($errno, $errstr, $errfile, $errline) {
    $message = "\n\nОшибка [$errno]: $errstr\nФайл: $errfile\nСтрока: $errline\nВремя: " . date('Y-m-d H:i:s');
    $to = get_option('admin_email');
    $subject = 'Автоматический отчет об ошибке WordPress';
    $headers = array('Content-Type: text/plain; charset=UTF-8');
    wp_mail($to, $subject, $message, $headers);
    // Можно также записывать в лог
    error_log($message);
    return false; // Передаем обработку дальше стандартному обработчику
}
set_error_handler('wpcodes_rus_custom_error_handler');

Этот код перехватывает PHP-ошибки, формирует отчет и отправляет его на email администратора сайта, указанного в настройках WordPress. Также ошибки записываются в системный лог.

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

Плагины для автоматического сбора и анализа ошибок WordPress

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

Query Monitor — мощный инструмент для отладки, показывающий ошибки PHP, SQL-запросы, хуки и многое другое. Подробнее на WPSHOP
Log Deprecated Notices — плагин для отслеживания использования устаревших функций и хуков WordPress.
WP Debugging — упрощает настройку WP_DEBUG и вывод логов, интегрируется с Mail logging.
WP Activity Log — позволяет вести расширенный аудит и собирать ошибки, связанные с действиями пользователей.

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

Как сделать отчет об ошибках с дополнительной информацией о среде и пользователе

Для более подробного анализа полезно включать в отчет не только текст ошибки, но и информацию о среде: версия PHP, версия WordPress, данные пользователя, URL запроса, время и др.

Рассмотрим расширение нашего обработчика ошибок для добавления такой информации:

function wpcodes_rus_detailed_error_report($errno, $errstr, $errfile, $errline) {
    $user = wp_get_current_user();
    $environment = array(
        'PHP Version' => PHP_VERSION,
        'WordPress Version' => get_bloginfo('version'),
        'User ID' => $user->ID,
        'User Login' => $user->user_login,
        'URL' => esc_url($_SERVER['REQUEST_URI']),
        'Time' => date('Y-m-d H:i:s')
    );
    $message = "\n\nОшибка [$errno]: $errstr\nФайл: $errfile\nСтрока: $errline\n";
    foreach ($environment as $key => $value) {
        $message .= "$key: $value\n";
    }
    $to = get_option('admin_email');
    $subject = 'Детальный автоматический отчет об ошибке WordPress';
    $headers = array('Content-Type: text/plain; charset=UTF-8');
    wp_mail($to, $subject, $message, $headers);
    error_log($message);
    return false;
}
set_error_handler('wpcodes_rus_detailed_error_report');

Такой отчет дает полное понимание контекста, в котором произошла ошибка, что значительно ускоряет диагностику и устранение неполадок.

Использование внешних сервисов мониторинга ошибок

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

Sentry — мощный инструмент для отслеживания ошибок с поддержкой WordPress через плагины.
Rollbar — аналогичный сервис с удобной интеграцией и аналитикой.
New Relic — комплексный мониторинг производительности и ошибок.

Для интеграции с WordPress обычно используется плагин, который отсылает ошибки в систему. Например, плагин WP Sentry Integration.

Практический пример: интеграция с плагином WP Sentry Integration

Рассмотрим, как быстро подключить Sentry к WordPress:

Зарегистрируйтесь на sentry.io и создайте проект.
Установите плагин WP Sentry Integration через админку WordPress.
В настройках плагина вставьте DSN из вашего проекта Sentry.
Плагин начнет автоматически отправлять ошибки PHP и JavaScript в Sentry.

Это позволит вам видеть все ошибки в удобном интерфейсе, с фильтрацией, уведомлениями и историей.

Советы по оптимизации и безопасности отчетности ошибок

При работе с отчетами об ошибках учитывайте следующие моменты:

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

Заключение

Создание автоматического отчета об ошибках в WordPress — реальная и полезная задача, которая позволяет поддерживать стабильность сайта и быстро реагировать на проблемы. Выбор подхода зависит от масштаба проекта и специфики. Простое логирование и отправка email подходят для небольших сайтов, а для сложных проектов лучше использовать специализированные сервисы и плагины.

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

Если хотите упростить работу с логами и мониторингом, обратите внимание на плагины и сервисы, упомянутые в статье. Подробнее о полезных инструментах для WordPress можно узнать на WPSHOP.