Как определить пользовательский форматировщик логирования

Каждый обработчик логирования использует Formatter, чтобы форматировать запись перед тем, как её логировать. Все обработчики Monolog по умолчанию используют экземпляр Monolog\Formatter\LineFormatter,, но вы можете с лёгкостью заменить его. Ваш форматировщик должен релизовывать Monolog\Formatter\FormatterInterface.

Например, чтобыиспользовать встроенный JsonFormatter, зарегистрируйте его как сервис, а потом сконфигурируйте ваш обработчик так, чтобы он его использовал:

1
2
3
4
5
6
7

# config/packages/prod/monolog.yaml (and/or config/packages/dev/monolog.yaml)
monolog:
    handlers:
        file:
            type: stream
            level: debug
            formatter: 'monolog.formatter.json'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

<!-- config/packages/prod/monolog.xml (and/or config/packages/dev/monolog.xml) -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:monolog="http://symfony.com/schema/dic/monolog"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/monolog
        https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">

    <monolog:config>
        <monolog:handler
            name="file"
            type="stream"
            level="debug"
            formatter="monolog.formatter.json"
        />
    </monolog:config>
</container>

1
2
3
4
5
6
7
8
9
10

// config/packages/prod/monolog.php (and/or config/packages/dev/monolog.php)
use Symfony\Config\MonologConfig;

return static function (MonologConfig $monolog): void {
    $monolog->handler('file')
        ->type('stream')
        ->level('debug')
        ->formatter('monolog.formatter.json')
    ;
};

В Monolog имеется множество встроенных форматировщиков. Многие из них объявлены как сервисы и могут быть использованы в опции ``formatter'':

• monolog.formatter.chrome_php: форматирует запись в соответствии с форматом массива ChromePHP
• monolog.formatter.gelf_message: сериализует формат в формат GELF
• monolog.formatter.html: форматирует запись в HTML-таблицу
• monolog.formatter.json: сериализует запись в объект JSON
• monolog.formatter.line: форматирует запись в одну строку
• monolog.formatter.loggly: форматирует информацию о записи в JSON в формате, совместимом с Loggly
• monolog.formatter.logstash: сериализует запись в формат событий Logstash
• monolog.formatter.normalizer: нормализует запись для удаления объектов/ресурсов, чтобы её было проще скидывать на различные цели
• monolog.formatter.scalar: форматирует запись в ассоциативный массив скалярных (+ null) значений (объекты и массивы будут закодированы в JSON)
• monolog.formatter.wildfire: сериализует запись в соответствии с требованиями Wildfire к заголовкам