Error Monitor & Notifier

Часто задаваемые вопросы

Каким способом плагин отправляет уведомления об ошибках, когда сайт ломается или возвращает внутреннюю ошибку 500 Internal Server Error?

Error Monitor & Notifier цепляется к PHP-функции завершения работы при событии shutdown — обработчик, который запускается даже при фатальных ошибках. Поэтому плагин умеет обнаруживать и сообщать об ошибках наподобие Fatal Error, исключениях ParseError, неотловленных исключениях с сообщением Uncaught Exception, о превышении предела доступной памяти и других критических PHP-сбоях.

Плагин собирает подробную информацию об ошибке, включая трассировку стека, номер файла и строки, URL-адрес, пользовательский агент и многое другое, и отправляет информацию по электронной почте или в Telegram непосредственно перед остановкой выполнения скрипта PHP-движком, даже если на сайте отображается белый экран смерти (англ. White Screen of Death, WSOD) или возвращается ошибка 500.

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

Как остановить избыточные дубликаты оповещений об ошибках?

Включите настройку «Не обрабатывать повторные ошибки».

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

Совет: Уведомления о конкретных типах ошибок отключают, пока не исправят ошибку, и повторно включают после решения проблемы.

Сломают ли сайт неотловленные исключения?

Нет, за счёт фильтра enot_exception_handler_should_exit неотловленные исключения не вызовут сбой сайта.

Error Monitor & Notifier перехватывает 100 % неотловленных исключений и ошибок в PHP-коде, которые выбрасываются как объекты классов Error, Exception и исключения пользовательских типов. Плагин перехватывает исключение, прежде чем PHP прерывает выполнение скрипта, если исключение не обработали в блоке try-catch или если исключение выбросила тема, плагин или ядро.

Фильтр enot_exception_handler_should_exit определяет, требуется ли прерывать выполнение скрипта или продолжить выполнять код:

add_filter('enot_exception_handler_should_exit', static function (bool $should_exit, \Throwable $e): bool {
    if ($e instanceof MyCustomException) {
        my_logger()->log("Caught exception: " . $e->getMessage());
        return false; // Prevent script termination
    }

    return $should_exit;
}, 10, 2);

Возможно ли проигнорировать конкретные ошибки наподобие предупреждений, которые генерирует плагин WooCommerce?

Да, только добавьте обработку фильтра enot_ignore_error.

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

add_filter('enot_ignore_error', static function (bool $ignore, \ErrorException $e): bool {
    if ($e->getSeverity() === E_WARNING && strpos($e->getFile(), '/plugins/woocommerce/') !== false) {
        return true; // Ignore this error
    }

    return $ignore;
}, 10, 2);

Рекомендация: Добавьте обработчик фильтра в файл наподобие mu-plugins/enot-ignore-error.php, чтобы прикрепиться к фильтру как можно раньше, даже во время событий cron или AJAX-запросов.