PHPackages                             raifucore/laravel-telegram-logger - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. raifucore/laravel-telegram-logger

ActiveLibrary[Logging & Monitoring](/categories/logging)

raifucore/laravel-telegram-logger
=================================

Send logs to Telegram

1.8.0(3w ago)13071[1 PRs](https://github.com/raifucore/laravel-telegram-logger/pulls)MITPHPPHP ^8.1

Since Jun 1Pushed 1mo agoCompare

[ Source](https://github.com/raifucore/laravel-telegram-logger)[ Packagist](https://packagist.org/packages/raifucore/laravel-telegram-logger)[ RSS](/packages/raifucore-laravel-telegram-logger/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (14)Versions (9)Used By (0)

Laravel Telegram Logger
=======================

[](#laravel-telegram-logger)

Send Laravel logs to Telegram chat via Telegram Bot API.

Install
-------

[](#install)

```
composer require raifucore/laravel-telegram-logger
```

Publish package config and views:

```
php artisan vendor:publish --provider="RaifuCore\TelegramLogger\ServiceProvider"
```

Configure environment
---------------------

[](#configure-environment)

Add these variables to your `.env`:

```
TELEGRAM_LOGGER_ENABLE=true
TELEGRAM_LOGGER_BOT_TOKEN=7123456789:ABHo3qcH6G1wMi4VPc8xxZZ474UizrF5e6Dk
TELEGRAM_LOGGER_CHAT_ID=-1112223334445
TELEGRAM_LOGGER_MESSAGE_THREAD_ID=

TELEGRAM_LOGGER_QUEUE=default
TELEGRAM_LOGGER_QUEUE_CONNECTION=sync
TELEGRAM_LOGGER_TIMEOUT=5

# optional
TELEGRAM_LOGGER_PROXY=
```

### Variables

[](#variables)

- `TELEGRAM_LOGGER_ENABLE`: enable or disable telegram logging.
- `TELEGRAM_LOGGER_BOT_TOKEN`: Telegram bot token from `@BotFather`.
- `TELEGRAM_LOGGER_CHAT_ID`: target chat id.
- `TELEGRAM_LOGGER_MESSAGE_THREAD_ID`: optional topic id for forum chats.
- `TELEGRAM_LOGGER_QUEUE`: queue name for log delivery jobs.
- `TELEGRAM_LOGGER_QUEUE_CONNECTION`: queue connection (`sync`, `redis`, etc.).
- `TELEGRAM_LOGGER_TIMEOUT`: HTTP timeout (seconds) for Telegram API calls.
- `TELEGRAM_LOGGER_PROXY`: optional proxy URL, for example:
    - `tcp://host:port`
    - `tcp://user:pass@host:port`
    - `socks5://user:pass@host:port`

Configure `config/logging.php`
------------------------------

[](#configure-configloggingphp)

Add a custom channel:

```
'telegram' => [
    'driver' => 'custom',
    'via' => \RaifuCore\TelegramLogger\Logger::class,
    'level' => 'debug',
],
```

If your default channel is `stack`, add `telegram` there:

```
'stack' => [
    'driver' => 'stack',
    'channels' => ['single', 'telegram'],
],
```

Or set default channel:

```
LOG_CHANNEL=telegram
```

Usage
-----

[](#usage)

Use Laravel `Log` as usual:

```
use Illuminate\Support\Facades\Log;

Log::error('Payment failed', ['order_id' => 123]);
Log::channel('telegram')->warning('Telegram channel only');
```

Queue behavior
--------------

[](#queue-behavior)

Messages are dispatched as jobs (`RaifuCore\TelegramLogger\Job`).

- With `TELEGRAM_LOGGER_QUEUE_CONNECTION=sync`, jobs are executed immediately.
- With async connections (for example `redis`), jobs are pushed to queue workers.

Templates
---------

[](#templates)

By default package uses Blade template:

```
'template' => 'telegram_logger::standard',
```

To customize templates:

1. Publish package views.
2. Create your own template in `resources/views/vendor/telegram_logger/`.
3. Set `template` in `config/telegram_logger.php` or at runtime:

```
config(['telegram_logger.template' => 'telegram_logger::minimal']);
```

Per-level overrides
-------------------

[](#per-level-overrides)

You can override parameters per log level in `config/telegram_logger.php`:

```
'levels' => [
    'error' => [
        'chat_id' => env('TELEGRAM_LOGGER_ERROR_CHAT_ID'),
        'options' => [
            'disable_notification' => true,
        ],
    ],
],
```

Supported keys per level:

- `token`
- `chat_id`
- `message_thread_id`
- `template`
- `options`

Create Telegram bot
-------------------

[](#create-telegram-bot)

1. Open `@BotFather`.
2. Run `/newbot`.
3. Configure bot name and username.
4. Copy token to `.env`.
5. Open your bot and send `/start`.

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance94

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~60 days

Recently: every ~5 days

Total

8

Last Release

22d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/213864914?v=4)[raifucore](/maintainers/raifucore)[@raifucore](https://github.com/raifucore)

---

Top Contributors

[![raifucore](https://avatars.githubusercontent.com/u/213864914?v=4)](https://github.com/raifucore "raifucore (9 commits)")

### Embed Badge

![Health badge](/badges/raifucore-laravel-telegram-logger/health.svg)

```
[![Health](https://phpackages.com/badges/raifucore-laravel-telegram-logger/health.svg)](https://phpackages.com/packages/raifucore-laravel-telegram-logger)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.9k556.2M21.5k](/packages/laravel-framework)[craftcms/cms

Craft CMS

3.6k3.7M3.4k](/packages/craftcms-cms)[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.8M228](/packages/backpack-crud)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)[statamic/cms

The Statamic CMS Core Package

4.9k3.8M1.2k](/packages/statamic-cms)[unopim/unopim

UnoPim Laravel PIM

10.8k2.5k](/packages/unopim-unopim)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)