- Для версий
- 2.1
- 2.2
- 2.3
Описание Monolog Logging Service:
Аддон для XenForo 2.x добавляет возможности ведения логов с использованием библиотеки Monolog.Основные функции Monolog Logging Service:
- Логирование в файл:
- По умолчанию логи записываются в файл internal_data/monolog.log.
- Возможность настроить путь к файлу.
- Отправка логов по электронной почте:
- Логи отправляются с дедупликацией и буферизацией.
- Настройка минимальных уровней логирования для файлов и электронной почты.
- Добавление дополнительных данных в логи:
- Данные о посетителях: user_id и имя пользователя.
- Данные о веб-запросах: текущий URI, метод запроса, IP-адрес клиента.
- Инструмент для тестирования:
- Проверка записи логов на диск: AdminCP > Tools > Checks and tests > Test Monolog.
Примечания:
- Версия v3.x использует Monolog v1.
- Версия v4.x использует Monolog v2.
- Функциональные различия между версиями отсутствуют, различие только в версии Monolog.
Инструкции по использованию
По умолчанию аддон будет записывать события в файл internal_data/monolog.log - это настраивается.Чтобы использовать стандартный способ ведения журнала, сделайте следующее в коде аддона:
PHP:
use Monolog\Helper\Log;
Log::info('an info message', ['context' => 'foo']);
Log::error('an error message', ['data' => 'bar']);
PHP:
$logger = \XF::app()->get('monolog')->newChannel('myaddon');
$logger->warning('a warning message', ['context' => 'foo']);
Вы можете создать свой собственный стек обработчиков, чтобы настроить процесс регистрации событий:
PHP:
use Monolog\Logger;
$monolog = \XF::app()->get('monolog');
$streamhandler = $monolog->stream(); // return our default stream handler for logging to a file
//(or create your own!)
/** @var Monolog\Logger $logger */
$logger = $monolog->logger('myaddon');
$logger->pushHandler($streamhandler); // push our stream handler onto the handler stack
// you can apply any other customisations you like here as well by adding custom handlers, formatters or processors
$logger->critical('a critical message', ['context' => 'foo']);