README

📝 Introduction

Laravel Telegram Git Notifier is a Laravel package that allows you to create a Telegram bot to receive notifications from GitHub or GitLab events and manage customization through messages and buttons on Telegram.

• Send notifications of your GitHub/GitLab repositories to Telegram Bots, Groups, Super Groups (Multiple Topics), and Channels.
• The bot must be created using the BotFather

📋 Requirements

• PHP ^8.4|^8.5
• Laravel ^11.0|^12.0
• Composer
• Core: Telegram Git Notifier

🔧 Installation

You can install this package via Composer:

composer require cslant/laravel-telegram-git-notifier

✨ What's New in v2.0

New Features

• Webhook Security: VerifyWebhookSecret middleware with timing-safe hash_equals() comparison
• Webhook Status Command: Check webhook status via php artisan tg-notifier:webhook:status
• Deferrable Provider: Lazy-loaded service provider with singleton bindings for better performance
• API Retry Logic: Exponential backoff for Telegram API rate limits (HTTP 429)
• In-Memory Caching: Config files cached in memory with dirty flag
• Clean Template Format: Simplified emoji usage (single emoji per event type)

Improvements

• PHP 8.4+ support with readonly classes and properties
• Full type safety with explicit return types and nullable params
• match expressions instead of switch for cleaner code
• PSR-3 LoggerInterface support

Available Artisan Commands

🚀 Usage

See the Usage - Telegram git notifier Documentation for a list of usage.

Please check and update some configurations in the documentation.

📖 Official Documentation

Please see the Telegram Git Notifier Documentation for more information.

✨ Supported events

GitHub Events Available

• Push

• Issues

• Issue Comment

• Pull Request

• Pull Request Review

• Fork

• Commit Comment

• Deployment

• Deployment Status

• Fork

• Workflow

• Watch

  ... and more events can be seen in the all GitHub events available

GitLab Events Available

• Push

• Tag Push

• Issue

• Merge Request

• Note

• Pipeline

• Wiki Page

• Build

• Deployment

• Release

  ... and more events can be seen in the all GitLab events available

License

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

📦 Changelog

Please see CHANGELOG for more information on what has changed recently.