Логирование PHP на русском: практические решения и код

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

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

Настройка логгера, который записывает сообщения в файл и одновременно отправляет критичные ошибки на email (с русским текстом).

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

date_default_timezone_set('Asia/Yekaterinburg'); // Екатеринбург, Россия

$log = new Logger('myapp');

// Единый формат для всех обработчиков
$formatter = new LineFormatter(
    "[%datetime%] %channel%.%level_name%: %message% %context%\n",
    'd.m.Y H:i:s',
    true,
    true
);

// Файловый обработчик
$fileHandler = new StreamHandler(__DIR__ . '/data/application.log', Logger::INFO);
$fileHandler->setFormatter($formatter);
$log->pushHandler($fileHandler);

// Email-обработчик для ошибок (только для критических уведомлений)
$mailHandler = new NativeMailerHandler(
    'admin@example.com',                          // кому
    'Ошибка в приложении (Русский лог)',           // тема
    'from@example.com',                           // от кого
    Logger::ERROR                                 // уровень
);
$mailHandler->setFormatter($formatter);
$log->pushHandler($mailHandler);

// Логирование
$log->info('Приложение инициализировано', ['version' => '2.1.0']);
$log->error('Транзакция не завершена: недостаточно средств на счете', ['account' => '40817810099910004321']);

[11.03.2025 14:32:10] myapp.INFO: Приложение инициализировано {"version":"2.1.0"}
[11.03.2025 14:32:12] myapp.ERROR: Транзакция не завершена: недостаточно средств на счете {"account":"40817810099910004321"}

2. Ротация логов с русским суффиксом даты

Использование RotatingFileHandler для автоматического создания архива с русским названием файлов (например, app_2025-03-11.log).

use Monolog\Logger;
use Monolog\Handler\RotatingFileHandler;
use Monolog\Formatter\JsonFormatter; // альтернативный формат

$log = new Logger('rotate');

// Хранить файлы за 30 дней, уровень DEBUG
$handler = new RotatingFileHandler(__DIR__ . '/logs/rus_app.log', 30, Logger::DEBUG);
// Формат с русскими датами в имени файла (по умолчанию Y-m-d)
$handler->setFilenameFormat('rus_app_{date}', 'Y-m-d');
$log->pushHandler($handler);

$log->debug('Отладочное сообщение: проверка соединения');
$log->info('Сессия создана', ['user' => 'Иван Петров']);
$log->warning('Время выполнения близко к лимиту', ['time' => '28.5s']);

(созданы файлы в директории logs/):
  rus_app_2025-03-11.log
  rus_app_2025-03-10.log (с предыдущего дня)

3. Логирование с русскими именами каналов и контекстом

Создание отдельных логгеров для разных модулей приложения (например, 'пользователи', 'заказы', 'платежи').

$userLogger = new Logger('пользователи');
$orderLogger = new Logger('заказы');

// Оба пишут в один файл, но с разными метками канала
$handler = new StreamHandler(__DIR__ . '/logs/main.log', Logger::INFO);
$handler->setFormatter(new LineFormatter("[%datetime%] [%channel%] %level_name%: %message%\n"));
$userLogger->pushHandler($handler);
$orderLogger->pushHandler($handler);

$userLogger->info('Регистрация нового пользователя', ['email' => 'test@русский.рф', 'role' => 'клиент']);
$orderLogger->info('Создан заказ №1234', ['сумма' => 1500.50, 'позиции' => 3]);
$orderLogger->warning('Заказ №1234: недостаточно товара на складе', ['склад' => 'Москва']);

[11.03.2025 15:00:01] [пользователи] INFO: Регистрация нового пользователя {"email":"test@xn--80ahd...","role":"клиент"}
[11.03.2025 15:00:02] [заказы] INFO: Создан заказ №1234 {"сумма":1500.5,"позиции":3}
[11.03.2025 15:00:03] [заказы] WARNING: Заказ №1234: недостаточно товара на складе {"склад":"Москва"}

4. Использование SAPI-зависимого логирования (Web vs CLI)

Настройка разного вывода для веб-запросов и консольных скриптов с русскими сообщениями.

$log = new Logger('multi');

if (php_sapi_name() === 'cli') {
    // В CLI вывод в stdout с цветовой подсветкой (если терминал поддерживает)
    $handler = new StreamHandler('php://stdout', Logger::DEBUG);
    $handler->setFormatter(new LineFormatter("%level_name%: %message%\n"));
} else {
    // В вебе записываем в файл и добавляем IP-адрес клиента
    $handler = new StreamHandler(__DIR__ . '/logs/web.log', Logger::WARNING);
    $formatter = new LineFormatter(
        "[%datetime%] %extra.client_ip% %message%\n"
    );
    $handler->setFormatter($formatter);
    $log->pushProcessor(function ($record) {
        $record['extra']['client_ip'] = $_SERVER['REMOTE_ADDR'] ?? 'неизвестен';
        return $record;
    });
}
$log->pushHandler($handler);

$log->info('Скрипт запущен из ' . (php_sapi_name() === 'cli' ? 'командной строки' : 'веба'));

5. Интеграция с логированием Yandex Cloud (через HTTP)

Отправка логов в сервис Yandex Cloud Logging с использованием cURL и русскоязычных сообщений.

function sendToYandexCloud($message, $level = 'INFO') {
    $logData = [
        'timestamp' => date('c'),
        'level' => $level,
        'message' => $message,
        'resource' => ['type' => 'php-app', 'id' => 'production']
    ];

    $ch = curl_init('https://logging.yandexcloud.net/v1/entries');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($logData, JSON_UNESCAPED_UNICODE));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Authorization: Bearer ' . getenv('YC_IAM_TOKEN'),
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $result = curl_exec($ch);
    if (curl_error($ch)) {
        error_log('Ошибка отправки лога в Yandex Cloud: ' . curl_error($ch));
    }
    curl_close($ch);
}

sendToYandexCloud('Приложение запущено успешно', 'INFO');
sendToYandexCloud('Критическая ошибка в модуле оплаты', 'ERROR');

(при успешной отправке ответ от API: 200 OK, ошибки записываются в локальный журнал)

6. Логирование с поддержкой Unicode (эмодзи, японский и русский одновременно)

Monolog корректно обрабатывает любые символы UTF‑8 при использовании правильного формата.

$log = new Logger('unicode_test');
$handler = new StreamHandler('php://output', Logger::DEBUG);
$handler->setFormatter(new LineFormatter("[%datetime%] %message%"));
$log->pushHandler($handler);

$log->info('Логирование на русском: привет мир!');
$log->info('Emoji: ? PHP 8.2 работает');
$log->info('Японский: こんにちは世界');

[11.03.2025 16:00:00] Логирование на русском: привет мир!
[11.03.2025 16:00:00] Emoji: ? PHP 8.2 работает
[11.03.2025 16:00:00] Японский: こんにちは世界