Управление лог-файлами в PHP-проектах

Расширенные примеры работы с лог-файлами

В этом разделе представлены подробные примеры с пояснениями и результатами выполнения.

Пример 1: Настройка Monolog с несколькими обработчиками

Один логгер может отправлять сообщения в разные места в зависимости от уровня:

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

$logger = new Logger('multi');

// Все уровни пишут в файл
$fileHandler = new StreamHandler('/var/log/app.log', Logger::DEBUG);
$logger->pushHandler($fileHandler);

// Ошибки и критические отправляются почтой
$mailHandler = new NativeMailerHandler(
    'admin@example.com',
    'Критическая ошибка приложения',
    'logger@example.com',
    Logger::ERROR
);
$mailHandler->setFormatter(new LineFormatter("[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n"));
$logger->pushHandler($mailHandler);

$logger->info('Обычное событие');
$logger->error('Ошибка подключения к БД');

Результат: в файл попадут все сообщения, на почту только ERROR и выше.

Пример 2: Ротация по дате с RotatingFileHandler

Обработчик автоматически создает новый файл каждый день и удаляет старые:

use Monolog\Logger;
use Monolog\Handler\RotatingFileHandler;

$logger = new Logger('daily');
$handler = new RotatingFileHandler('/var/log/daily.log', 30, Logger::DEBUG);
// Второй параметр - количество хранимых файлов (30 дней)
$logger->pushHandler($handler);

$logger->info('Новый день начался');

Результат: создаются файлы daily-2025-04-01.log, daily-2025-04-02.log и т.д. Файлы старше 30 дней удаляются автоматически.

Пример 3: Логирование с контекстом и форматом JSON вручную

Создание структурированного лога с контекстом запроса:

$logEntry = [
    'date' => gmdate('Y-m-d\TH:i:s\Z'),
    'level' => 'WARNING',
    'message' => 'Время выполнения превысило порог',
    'extra' => [
        'duration_ms' => 1500,
        'route' => '/api/report'
    ]
];

$json = json_encode($logEntry, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT);
file_put_contents('/var/log/api_errors.json', $json . PHP_EOL, FILE_APPEND);

Результат (пример содержимого файла):

{
    "date": "2025-04-01T12:00:00Z",
    "level": "WARNING",
    "message": "Время выполнения превысило порог",
    "extra": {
        "duration_ms": 1500,
        "route": "/api/report"
    }
}

Пример 4: Логирование в системный журнал (syslog)

Использование встроенной функции syslog() для записи в системный лог (например, /var/log/syslog):

openlog('myapp', LOG_PID | LOG_NDELAY, LOG_USER);
syslog(LOG_INFO, 'Приложение запущено');
syslog(LOG_ERR, 'Критическая ошибка: ' . $e->getMessage());
closelog();

Просмотреть логи можно командой tail -f /var/log/syslog. Результат:

Apr  1 12:00:00 hostname myapp[1234]: Приложение запущено
Apr  1 12:01:00 hostname myapp[1234]: Критическая ошибка: connection refused

Пример 5: Кастомный форматтер для Monolog с цветным выводом в консоль

Пример для отладки: вывод логов в консоль с цветом в зависимости от уровня:

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Formatter\FormatterInterface;

class ColorConsoleFormatter implements FormatterInterface
{
    public function format(array $record): string
    {
        $colors = [
            Logger::DEBUG => "\033[37m",    // белый
            Logger::INFO => "\033[32m",     // зеленый
            Logger::WARNING => "\033[33m",  // желтый
            Logger::ERROR => "\033[31m",    // красный
            Logger::CRITICAL => "\033[1;31m", // ярко-красный
        ];
        $color = $colors[$record['level']] ?? "\033[0m";
        return $color . $record['level_name'] . ": " . $record['message'] . "\033[0m" . PHP_EOL;
    }

    public function formatBatch(array $records): string
    {
        return implode('', array_map([$this, 'format'], $records));
    }
}

$logger = new Logger('console');
$handler = new StreamHandler('php://stdout', Logger::DEBUG);
$handler->setFormatter(new ColorConsoleFormatter());
$logger->pushHandler($handler);

$logger->info('Зеленое сообщение');
$logger->error('Красное сообщение');

Результат в консоли (если поддерживает ANSI) - цветные строки.

Пример 6: Логирование PDO-запросов с замерами времени

Обертка для PDO, которая логирует каждый запрос и его длительность:

class LoggablePDO extends PDO
{
    private $logger;

    public function __construct($dsn, $user, $pass, $opts, callable $logger)
    {
        parent::__construct($dsn, $user, $pass, $opts);
        $this->logger = $logger;
    }

    public function query($statement, ...$fetchModeArgs)
    {
        $start = microtime(true);
        $result = parent::query($statement, ...$fetchModeArgs);
        $time = round((microtime(true) - $start) * 1000, 2);
        ($this->logger)('query', $statement, $time);
        return $result;
    }
}

$logger = function($level, $message, $time) {
    file_put_contents('/var/log/sql.log', sprintf("[%s] %s: %s (%.2fms)\n", date('c'), $level, $message, $time), FILE_APPEND);
};

$pdo = new LoggablePDO('mysql:host=localhost;dbname=test', 'user', 'pass', [], $logger);
$pdo->query('SELECT * FROM users');

Результат в файле /var/log/sql.log:

[2025-04-01T12:00:00+00:00] query: SELECT * FROM users (0.45ms)