PHPackages                             cslant/telegram-git-notifier - 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. [Mail &amp; Notifications](/categories/mail)
4. /
5. cslant/telegram-git-notifier

ActiveLibrary[Mail &amp; Notifications](/categories/mail)

cslant/telegram-git-notifier
============================

Send notification from Gitlab and Github events to Telegram

v1.5.0(2y ago)2388.4k↓25%5[1 PRs](https://github.com/cslant/telegram-git-notifier/pulls)6MITPHPPHP ^8.1|^8.2CI passing

Since Sep 28Pushed 2mo ago5 watchersCompare

[ Source](https://github.com/cslant/telegram-git-notifier)[ Packagist](https://packagist.org/packages/cslant/telegram-git-notifier)[ Docs](https://github.com/cslant/telegram-git-notifier)[ GitHub Sponsors](https://github.com/tanhongit)[ RSS](/packages/cslant-telegram-git-notifier/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (7)Versions (21)Used By (6)

Telegram Git Notifier Core Package
==================================

[](#telegram-git-notifier-core-package)

This package provides the ability to integrate the Telegram messaging service with GitHub and GitLab. With this package, you can create a Telegram bot to receive notifications from GitHub or GitLab events and manage customization through messages and buttons on Telegram.

 [![Telegram git notifier core](https://private-user-images.githubusercontent.com/35853002/294656144-d731d731-3c32-40a7-80d2-b079d7f1de6c.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI5NjM3MzUsIm5iZiI6MTc4Mjk2MzQzNSwicGF0aCI6Ii8zNTg1MzAwMi8yOTQ2NTYxNDQtZDczMWQ3MzEtM2MzMi00MGE3LTgwZDItYjA3OWQ3ZjFkZTZjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA3MDIlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNzAyVDAzMzcxNVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWVmMjE5Yjk5NTJkNjZiZTcxZWZmZGZhNGQ2MzU2ZDZjNzkyZWY4ZTY4YWRhZWU5ODFhYWZhOTYzOThhMjgwNzcmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.fzvRAJtPmyFx8sSmontJjzjX4Cv705OrBL-H7xemWXc)](https://private-user-images.githubusercontent.com/35853002/294656144-d731d731-3c32-40a7-80d2-b079d7f1de6c.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI5NjM3MzUsIm5iZiI6MTc4Mjk2MzQzNSwicGF0aCI6Ii8zNTg1MzAwMi8yOTQ2NTYxNDQtZDczMWQ3MzEtM2MzMi00MGE3LTgwZDItYjA3OWQ3ZjFkZTZjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA3MDIlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNzAyVDAzMzcxNVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWVmMjE5Yjk5NTJkNjZiZTcxZWZmZGZhNGQ2MzU2ZDZjNzkyZWY4ZTY4YWRhZWU5ODFhYWZhOTYzOThhMjgwNzcmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.fzvRAJtPmyFx8sSmontJjzjX4Cv705OrBL-H7xemWXc)

[![License](https://camo.githubusercontent.com/48a9fda1c2eda900bced09f608b5aba11958ac163dcd21bf83048f6266b7ee22/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63736c616e742f74656c656772616d2d6769742d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265)](#)[![Latest Version on Packagist](https://camo.githubusercontent.com/8b00e716852163925c7617fe606554e594d4c8a0dbe0ef1f241a9f1268f958b4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f63736c616e742f74656c656772616d2d6769742d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/cslant/telegram-git-notifier)[![Total Downloads](https://camo.githubusercontent.com/df9bfb71c49b956c973afab37cda162bfd9fff6947e521722d2d76391c3c67d1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f63736c616e742f74656c656772616d2d6769742d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cslant/telegram-git-notifier)[![Test Status](https://camo.githubusercontent.com/e23a7b80f5b28b53844cb1df257a820fdc9cd43d6855b4368ab5b1307f37b3f6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f63736c616e742f74656c656772616d2d6769742d6e6f7469666965722f73657475705f746573742e796d6c3f6c6162656c3d7465737473266272616e63683d6d61696e)](https://github.com/cslant/telegram-git-notifier/actions/workflows/setup_test.yml)[![Code Style Status](https://camo.githubusercontent.com/a2ec70999455c9116cb342e16affc25bdb85f9e9b27efa4012d2f9e811ea56eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f63736c616e742f74656c656772616d2d6769742d6e6f7469666965722f7068702d63732d66697865722e796d6c3f6c6162656c3d636f64652532307374796c65266272616e63683d6d61696e)](https://github.com/cslant/telegram-git-notifier/actions/workflows/php-cs-fixer.yml)[![Quality Score](https://camo.githubusercontent.com/32bfa663926a2210df7361928f0542da02414cf0d3c014936609b02e0761d95f/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f63736c616e742f74656c656772616d2d6769742d6e6f7469666965722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/cslant/telegram-git-notifier)[![Maintainability](https://camo.githubusercontent.com/90c4c428de2db17a33c616343d1dcdc912fa53bbbc66b896aa1247d14856f066/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f62366631363136346435353830396430393138652f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/cslant/telegram-git-notifier/maintainability)

📋 Requirements
--------------

[](#-requirements)

- PHP ^8.4|^8.5
- [Composer](https://getcomposer.org/)
- [Telegram Bot](https://core.telegram.org/api)

🔧 Installation
--------------

[](#-installation)

You can install this package via Composer:

```
composer require cslant/telegram-git-notifier
```

✨ Features
----------

[](#-features)

- **Platform Enum**: Type-safe GitHub/GitLab platform handling
- **ChatTarget DTO**: Structured chat ID parsing with thread support
- **In-Memory Caching**: Config files cached in memory with dirty flag for efficient I/O
- **PSR-3 Logger**: Standardized logging interface support
- **API Retry Logic**: Exponential backoff for Telegram API rate limits (HTTP 429)
- **Safe Template Rendering**: Closure-isolated scope for view templates
- **Strict Types**: Full type safety with `readonly` properties and explicit nullable params

🧪 Testing
---------

[](#-testing)

```
composer test
```

📖 Official Documentation
------------------------

[](#-official-documentation)

Please see the [Telegram Git Notifier Documentation](https://docs.cslant.com/telegram-git-notifier) for more information.

📦 Changelog
-----------

[](#-changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance56

Moderate activity, may be stable

Popularity40

Moderate usage in the ecosystem

Community27

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 90.5% 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 ~59 days

Recently: every ~188 days

Total

16

Last Release

168d ago

Major Versions

v1.5.0 → v2.0.x-dev2026-03-02

PHP version history (4 changes)v1.0.0PHP ^8.0

v1.3.0PHP ^8.1

v1.4.0PHP ^8.1|^8.2

v2.0.x-devPHP ^8.4|^8.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/35853002?v=4)[Tan Nguyen](/maintainers/tanhongit)[@tanhongit](https://github.com/tanhongit)

---

Top Contributors

[![tanhongit](https://avatars.githubusercontent.com/u/35853002?v=4)](https://github.com/tanhongit "tanhongit (256 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)")[![avaelo](https://avatars.githubusercontent.com/u/127422332?v=4)](https://github.com/avaelo "avaelo (3 commits)")[![LuongTienThinh](https://avatars.githubusercontent.com/u/91936861?v=4)](https://github.com/LuongTienThinh "LuongTienThinh (2 commits)")[![mytruong-z](https://avatars.githubusercontent.com/u/41782955?v=4)](https://github.com/mytruong-z "mytruong-z (2 commits)")[![hokhacminhtri](https://avatars.githubusercontent.com/u/57437836?v=4)](https://github.com/hokhacminhtri "hokhacminhtri (1 commits)")[![kenautomus](https://avatars.githubusercontent.com/u/69226680?v=4)](https://github.com/kenautomus "kenautomus (1 commits)")[![pxthinh](https://avatars.githubusercontent.com/u/105281722?v=4)](https://github.com/pxthinh "pxthinh (1 commits)")[![cslant-dev](https://avatars.githubusercontent.com/u/175740988?v=4)](https://github.com/cslant-dev "cslant-dev (1 commits)")

---

Tags

botcslantgithub-eventsgithub-notificationsgithub-telegramgithub-telegram-botgitlab-notifiergitlab-telegramgitlab-webhooknotification-botnotificationsphptelegramtelegram-bottelegram-botstelegram-messagestelegram-notificationstelegram-notifiertelegram-notifier-coretelegram botnotifygit-webhooktelegram-notifiergithub-notifiergithub-telegram-botgitlab-notifiergitlab-telegram-bottelegram-bot-github-notifytelegram-bot-gitlab-notifytelegram-git-notifiercslant

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/cslant-telegram-git-notifier/health.svg)

```
[![Health](https://phpackages.com/badges/cslant-telegram-git-notifier/health.svg)](https://phpackages.com/packages/cslant-telegram-git-notifier)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.9k556.2M21.5k](/packages/laravel-framework)[cslant/laravel-telegram-git-notifier

Send notification from Gitlab and GitHub events to Telegram

3752.0k1](/packages/cslant-laravel-telegram-git-notifier)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19467.3M1.9k](/packages/drupal-core)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)[lion/bundle

Lion-framework configuration and initialization package

132.4k5](/packages/lion-bundle)

PHPackages © 2026

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