metallheart/laravel-telegram-logger

Laravel package for logging to Telegram

v1.0.0 2025-07-14 20:29 UTC

Requires

• php: ^8.2
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0
• monolog/monolog: ^3.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Metallheart

• logging
• monolog
• laravel
• telegram

README

Пакет для отправки логов Laravel в Telegram.

Установка

composer require metallheart/laravel-telegram-logger

Пакет автоматически регистрируется через Laravel Package Discovery.

Настройка

1. Опубликуйте конфигурацию:

php artisan vendor:publish --tag=telegram-logger-config

1. Добавьте переменные в .env:

TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id
TELEGRAM_LOG_LEVEL=error
TELEGRAM_LOG_ENABLED=true

1. Добавьте канал в config/logging.php:

'channels' => [
    // ... другие каналы
  
    'telegram' => [
        'driver' => 'telegram',
    ],
  
    // Или добавьте в stack
    'stack' => [
        'driver' => 'stack',
        'channels' => ['single', 'telegram'],
    ],
],

Использование

Основное использование

use Illuminate\Support\Facades\Log;

// Отправка логов через канал telegram
Log::channel('telegram')->error('Произошла ошибка!');
Log::channel('telegram')->info('Информационное сообщение');

// Или используя stack
Log::error('Ошибка будет отправлена в файл и Telegram');

С контекстом

Log::channel('telegram')->error('Ошибка в оплате', [
    'user_id' => 123,
    'amount' => 1000,
    'payment_method' => 'card'
]);

Конфигурация

Доступные опции в config/telegram-logger.php:

• bot_token - Токен бота Telegram
• chat_id - ID чата для отправки сообщений
• log_level - Минимальный уровень логов (debug, info, notice, warning, error, critical, alert, emergency)
• timeout - Таймаут HTTP запроса (секунды)
• fallback_channel - Резервный канал при недоступности Telegram
• enabled - Включить/отключить логирование
• message_format - Формат сообщения
• include_context - Включать контекст в сообщения
• include_extra - Включать дополнительные данные
• date_format - Формат даты

Получение Bot Token и Chat ID

Bot Token

1. Найдите @BotFather в Telegram
2. Отправьте /newbot
3. Следуйте инструкциям
4. Скопируйте токен

Chat ID

1. Добавьте бота в чат или группу
2. Отправьте сообщение
3. Откройте https://api.telegram.org/bot<TOKEN>/getUpdates
4. Найдите chat.id в ответе

Лицензия

MIT