Библиотека пхпшника | PHP, Laravel, Symfony, CodeIgniter: “⌛️ Как настроить production-ready логирование в PHP Логи в проде

⌛️ Как настроить production-ready логирование в PHP

Логи в проде — это не просто error_log(). Это структурированные данные, correlation ID, асинхронная запись и ротация. Разбираем пошаговую настройку.

1️⃣ Выбираем стек: Monolog

PHP де-факто стандарт для логирования — Monolog. Устанавливаем через Composer:

composer require monolog/monolog

Если на Laravel, уже есть из коробки. Если нет, то подключаем вручную.

2️⃣ Базовая конфигурация с JSON-форматом

use Monolog\Logger;
use Monolog\Handler\RotatingFileHandler;
use Monolog\Formatter\JsonFormatter;

$log = new Logger('app');

$handler = new RotatingFileHandler(
    __DIR__ . '/logs/application.log',
    maxFiles: 30,
    level: Logger::INFO
);

$handler->setFormatter(new JsonFormatter());
$log->pushHandler($handler);

JSON-формат удобен для парсинга в ELK / Grafana Loki.

3️⃣ Добавляем Correlation ID

Трекаем каждый запрос через Processor:

class CorrelationIdProcessor implements ProcessorInterface
{
    private string $correlationId;

    public function __construct()
    {
        $this->correlationId = $_SERVER['HTTP_X_CORRELATION_ID']
            ?? bin2hex(random_bytes(16));

        header('X-Correlation-ID: ' . $this->correlationId);
    }

    public function __invoke(array $record): array
    {
        $record['extra']['correlation_id'] = $this->correlationId;
        return $record;
    }
}

$log->pushProcessor(new CorrelationIdProcessor());

Теперь каждая строка лога привязана к конкретному запросу.

4️⃣ Ротация и лимиты

$handler = new RotatingFileHandler(
    filename: __DIR__ . '/logs/app.log',
    maxFiles: 30,
    level: Logger::WARNING,
);

Для ограничения по размеру связываем с logrotate на уровне системы:

# /etc/logrotate.d/php-app
/var/www/app/logs/*.log {
    daily
    rotate 30
    compress
    missingok
    size 100M
}

5️⃣ Асинхронная запись

PHP синхронный по природе, но можно буферизовать тяжёлые хендлеры:

use Monolog\Handler\BufferHandler;

$bufferHandler = new BufferHandler(
    handler: new StreamHandler('logs/app.log'),
    bufferSize: 100,
    flushOnOverflow: true
);

$log->pushHandler($bufferHandler);

Буферизуем записи и сбрасываем пачкой → меньше I/O операций.

6️⃣ Интеграция с мониторингом

Отправляем в Graylog через GELF:

use Monolog\Handler\GelfHandler;
use Gelf\Publisher;
use Gelf\Transport\UdpTransport;

$publisher = new Publisher(
    new UdpTransport('logstash.example.com', 12201)
);

$log->pushHandler(new GelfHandler($publisher));

Или напрямую в Telegram для критических ошибок. Отдельный хендлер, 5 минут работы.

📌 Итог

Monolog + JsonFormatter + CorrelationId + logrotate = логи, с которыми не стыдно идти в прод.

Библиотека пхпшника