Як визначити користувацький форматувальник логування

Кожний обробник логування використовує 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.logly: форматує інформацію про запис у JSON у форматі, сумісному з Loggly
• monolog.formatter.logstash: серіалізує запис у формат подій Logstash
• monolog.formatter.normalizer: нормалізує запис для видалення об'єктів/джерел, щоб полегшити скидання до різних цілей
• monolog.formatter.scalar: форматує запис в асоціативний масив скалярних (+ null) значень (об'єкти і масиви будуть закодовані в JSON)
• monolog.formatter.wildfire: серіалізує запис відповідно до вимог Wildfire до заголовків