Настройка эффективного логирования PHP приложений

Расширенные примеры логирования PHP

Настройка Monolog с ротацией и форматированием JSON

Пример конфигурации с несколькими обработчиками: запись всех логов в JSON-файл с ротацией по дням, а предупреждения и выше – отдельно в syslog.

<?php
use Monolog\Logger;
use Monolog\Handler\RotatingFileHandler;
use Monolog\Handler\SyslogHandler;
use Monolog\Formatter\JsonFormatter;
use Monolog\Processor\IntrospectionProcessor;
use Monolog\Processor\WebProcessor;

$logger = new Logger('api');

// Обработчик для JSON с ротацией (7 дней)
$jsonHandler = new RotatingFileHandler('/var/log/php/api.json', 7, Logger::DEBUG);
$jsonHandler->setFormatter(new JsonFormatter());
$logger->pushHandler($jsonHandler);

// Syslog для ошибок
$syslogHandler = new SyslogHandler('api', LOG_USER, Logger::WARNING);
$logger->pushHandler($syslogHandler);

// Процессоры добавляют контекст
$logger->pushProcessor(new IntrospectionProcessor(Logger::DEBUG, ['Monolog\\']));
$logger->pushProcessor(new WebProcessor());

$logger->info('Запрос обработан', ['method' => $_SERVER['REQUEST_METHOD']]);
$logger->error('Исключение PDO', ['exception' => $e->getMessage()]);
?>

Содержимое api.json (каждая строка – JSON):

{"message":"Запрос обработан","context":{"method":"GET"},"level":200,"level_name":"INFO","channel":"api","datetime":"2025-04-05T10:30:00.123+03:00","extra":{"class":"App\\Controller\\UserController","function":"index","file":"/var/www/app/Controller/UserController.php","line":45,"url":"/users","ip":"192.168.1.1","http_method":"GET","server":"127.0.0.1"}}
{"message":"Исключение PDO","context":{"exception":"SQLSTATE[23000]: Integrity constraint violation"},"level":400,"level_name":"ERROR","channel":"api","datetime":"2025-04-05T10:30:01.456+03:00","extra":{...}}

Логирование через SAPI (для встроенного веб-сервера PHP)

Встроенный сервер (php -S) поддерживает только stderr. Чтобы перенаправить логи в файл, используется обёртка.

# Запуск с перенаправлением stderr в файл
php -S 0.0.0.0:8080 -t public 2>> /var/log/php/dev.log

# Альтернатива – использование Monolog с StreamHandler('php://stderr')
$log->pushHandler(new StreamHandler('php://stderr', Logger::DEBUG));

Условное логирование на основе окружения

Часто требуется разный уровень логирования в dev и prod. Используется переменная окружения или константа.

<?php
$level = (getenv('APP_ENV') === 'production') ? Logger::WARNING : Logger::DEBUG;
$handler = new StreamHandler('/var/log/php/app.log', $level);
$log->pushHandler($handler);

// В production можно добавить только критичные ошибки в Sentry
if (getenv('APP_ENV') === 'production') {
    $sentryHandler = new RavenHandler(new Raven_Client('DSN'), Logger::ERROR);
    $log->pushHandler($sentryHandler);
}
?>

Логирование в формате Graylog (GELF)

Для интеграции с Graylog используется протокол GELF. Monolog имеет GelfHandler, отправляющий UDP-пакеты.

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

$transport = new UdpTransport('graylog.example.com', 12201);
$publisher = new Publisher($transport);
$handler = new GelfHandler($publisher, Logger::WARNING);
$log->pushHandler($handler);
$log->warning('Высокая нагрузка CPU', ['cpu' => 0.95]);

Бенчмарк времени выполнения с логированием

Monolog поддерживает процессинг времени выполнения через TimerProcessor или ручной замер.

$start = microtime(true);
// ... выполнение кода ...
$log->info('Запрос завершен', ['duration_ms' => (microtime(true) - $start) * 1000]);

Обработка ошибок через пользовательский exception handler

Чтобы все неперехваченные исключения автоматически попадали в лог, устанавливают собственный обработчик.

<?php
function exceptionHandler($e) {
    global $log;
    $log->critical('Необработанное исключение', [
        'message' => $e->getMessage(),
        'file' => $e->getFile(),
        'line' => $e->getLine(),
        'trace' => $e->getTraceAsString()
    ]);
    http_response_code(500);
    echo 'Внутренняя ошибка сервера';
}
set_exception_handler('exceptionHandler');

// Также можно обработать фатальные ошибки через register_shutdown_function
?>