Эффективное логирование PHP-приложений: настройка и примеры

Расширенные примеры логирования с помощью Monolog

Пример 1. Несколько обработчиков и форматирование

В одном логгере можно комбинировать разные обработчики: запись в файл и отправка email для критических ошибок.

<?php
require 'vendor/autoload.php';

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\NativeMailerHandler;
use Monolog\Formatter\LineFormatter;

$log = new Logger('app');

// Формат строки
$formatter = new LineFormatter("[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n");

// Обработчик для файла: все уровни
$fileHandler = new StreamHandler(__DIR__ . '/app.log', Logger::DEBUG);
$fileHandler->setFormatter($formatter);
$log->pushHandler($fileHandler);

// Обработчик для email: только ERROR и выше
$mailHandler = new NativeMailerHandler('admin@example.com', 'Critical Error', 'from@example.com', Logger::ERROR);
$log->pushHandler($mailHandler);

$log->info('Пользователь зарегистрирован'); // пойдёт только в файл
$log->error('База данных недоступна');       // пойдёт в файл и на email

# app.log после выполнения:
[2025-04-13 10:00:00] app.INFO: Пользователь зарегистрирован [] []
[2025-04-13 10:00:01] app.ERROR: База данных недоступна [] []
# Письмо с темой 'Critical Error' отправлено на admin@example.com

Пример 2. Ротация файлов на основе размера

Monolog предоставляет готовый обработчик RotatingFileHandler, который автоматически создаёт новый файл каждый день (или по другому периоду) и удаляет старые.

<?php
use Monolog\Logger;
use Monolog\Handler\RotatingFileHandler;

$log = new Logger('app');
// Файл будет вида app-2025-04-13.log, хранить 30 дней
$handler = new RotatingFileHandler(__DIR__ . '/app.log', 30, Logger::DEBUG);
$log->pushHandler($handler);

$log->info('Логи будут ротироваться ежедневно');

# После нескольких дней в папке появятся файлы:
app-2025-04-13.log
app-2025-04-14.log
...
# Файлы старше 30 дней будут автоматически удалены

Пример 3. Логирование с контекстом и исключениями

Monolog позволяет передавать произвольные данные и объекты исключений.

<?php
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger('app');
$log->pushHandler(new StreamHandler('app.log', Logger::DEBUG));

// Контекст - массив дополнительных данных
try {
    // код, который может выбросить исключение
    throw new \Exception('Неверный формат', 42);
} catch (\Exception $e) {
    $log->error('Ошибка выполнения', [
        'exception' => $e,
        'user_id' => 123
    ]);
}

# app.log:
[2025-04-13 10:05:00] app.ERROR: Ошибка выполнения {"exception":"[object] (Exception(code: 42): Неверный формат at /path/to/file.php:12)","user_id":123} []

Пример 4. Использование процессоров для добавления метаданных

Процессоры автоматически добавляют информацию (IP, сессию, URL) к каждой записи.

<?php
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Processor\WebProcessor;
use Monolog\Processor\IntrospectionProcessor;

$log = new Logger('app');
$log->pushHandler(new StreamHandler('app.log', Logger::DEBUG));

// Добавляет IP, User-Agent, URL
$log->pushProcessor(new WebProcessor());
// Добавляет файл, строку, класс, функцию откуда вызван логгер
$log->pushProcessor(new IntrospectionProcessor());

$log->info('Запрос обработан');

# app.log (пример):
[2025-04-13 10:10:00] app.INFO: Запрос обработан {"url":"/index.php","ip":"127.0.0.1","http_method":"GET","server":"localhost","referrer":""} {"file":"/var/www/index.php","line":15,"class":null,"function":null}