PHPackages andrew-gos/telegram-bot - 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. [API Development](/categories/api) 4. / 5. andrew-gos/telegram-bot ActiveLibrary[API Development](/categories/api) andrew-gos/telegram-bot ======================= Advanced strictly typed Telegram Bot Library 4.7.3(1w ago)22491MITPHPPHP >=8.2CI passing Since May 5Pushed 1w ago1 watchersCompare [ Source](https://github.com/CiBeRHeMuL/TelegramBot)[ Packagist](https://packagist.org/packages/andrew-gos/telegram-bot)[ Docs](https://github.com/CiBeRHeMuL/TelegramBot)[ RSS](/packages/andrew-gos-telegram-bot/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependencies (62)Versions (34)Used By (1) Telegram Bot API Library ======================== [](#telegram-bot-api-library) [![Latest Stable Version](https://camo.githubusercontent.com/0332e97c43769e9b3ae86c08ecebe4326511fba8f53202bf0b9856cf9a3f2f64/68747470733a2f2f706f7365722e707567782e6f72672f616e647265772d676f732f74656c656772616d2d626f742f762f737461626c65)](https://packagist.org/packages/andrew-gos/telegram-bot)[![License](https://camo.githubusercontent.com/1d3bba8932f2c7197b8b8b9a7ef2e255489e44b50388fd41fe4726279c7dc3dc/68747470733a2f2f706f7365722e707567782e6f72672f616e647265772d676f732f74656c656772616d2d626f742f6c6963656e7365)](https://packagist.org/packages/andrew-gos/telegram-bot)[![PHP Version Require](https://camo.githubusercontent.com/b9c486d3b6c9efc04dab77062050ee26e2d534845f318e365fac7254e9f85c75/687474703a2f2f706f7365722e707567782e6f72672f616e647265772d676f732f74656c656772616d2d626f742f726571756972652f706870)](https://packagist.org/packages/andrew-gos/telegram-bot)[![CI](https://github.com/CiBeRHeMuL/TelegramBot/actions/workflows/ci.yml/badge.svg)](https://github.com/CiBeRHeMuL/TelegramBot/actions/workflows/ci.yml)[![codecov](https://camo.githubusercontent.com/c8b0856858385daaf2061114241a01384bb985894979c89a7145fb8659745623/68747470733a2f2f636f6465636f762e696f2f67682f436942655248654d754c2f54656c656772616d426f742f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/CiBeRHeMuL/TelegramBot) ### 🌟 Overview [](#-overview) This is a powerful, strictly-typed PHP library for building Telegram bots. It fully leverages the capabilities of **PHP 8.2+** and modern programming standards to make your development process fast, reliable, and enjoyable. The library provides a complete toolset for interacting with the **Telegram Bot API**, allowing you to focus on your bot's logic rather than on low-level implementation details. At its core is a flexible update processing kernel built on `HandlerGroup`, `Checker`, and `Middleware`, ensuring exceptional modularity and extensibility. ### ✨ Key Features [](#-key-features) - **πŸ’― Full API Coverage:** Supports all methods and types of the Telegram Bot API (currently version **10.1**). - **πŸ”’ Strict Typing:** Maximum code reliability and excellent IDE support. - **🧩 Modern Architecture:** A flexible update handling system using `HandlerGroup`, `Checker`, and `Middleware`. - **πŸ”Œ Extensibility:** Easily integrate your own logic through plugins and middleware. - **🀝 PSR Compliant:** Effortless integration with any modern framework. - **πŸ§ͺ Under Active Test Development:** 891+ tests, 1300+ assertions. Core components + Entity deserialization + API via HTTP mock. Full coverage strategy β€” see [Coverage Strategy](README/COVERAGE.md). ### πŸ“¦ Installation [](#-installation) To install the library, use Composer: ``` composer require andrew-gos/telegram-bot ``` ### πŸ“š Documentation [](#-documentation) To get started and explore the library's features in-depth, please refer to the following sections: SectionDescriptionπŸš€ **[Basic Usage (BASIC.md)](README/BASIC.md)****Start here.** A step-by-step guide to creating your first bot and handling commands.βš™οΈ **[Advanced Usage (ADVANCED.md)](README/ADVANCED.md)**Learn about Middleware, Plugins, custom `Checkers`, and other powerful tools.🧩 **Framework Integration**β€’ **[Symfony (SYMFONY.md)](README/SYMFONY.md)**A guide to setting up the library as a service in Symfony applications.β€’ **[Yii2 (YII2.md)](README/YII2.md)**A guide for integrating with the Yii2 framework's DI container.### 🀝 Contributing [](#-contributing) Contributions are welcome and greatly appreciated! This project follows the standard GitHub fork & pull request workflow. **Reporting Bugs and Requesting Features** - Please use the [GitHub Issues](https://github.com/CiBeRHeMuL/TelegramBot/issues) tracker to report bugs or request new features. - When reporting a bug, please provide a clear description, steps to reproduce it, and your environment details (PHP version, library version). - For feature requests, describe the problem you're trying to solve and your proposed solution. **Submitting Code Changes** 1. **Fork the repository** on GitHub. 2. **Create a new branch** for your changes (e.g. `fix/message-parsing-error`). 3. **Make your changes.** Ensure your code adheres to the project's coding style. 4. **Run the code style fixer.** This project uses `php-cs-fixer`. You can apply the style rules by running: ``` composer php-cs-fix ``` 5. **Add or update tests.** Your pull request should include tests that cover your changes. 6. **Submit a Pull Request** to the `master` branch with a clear description of your changes. ### πŸ“œ License [](#-license) This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details. ### Health Score 49 β€” FairBetter than 94% of packages Maintenance98 Actively maintained with recent releases Popularity17 Limited adoption so far Community8 Small or concentrated contributor base Maturity61 Established project with proven stability 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 ~13 days Recently: every ~7 days Total 33 Last Release 13d ago Major Versions 2.2.1 β†’ 3.0.02025-08-25 3.1.0 β†’ v4.x-dev2025-09-14 ### Community Maintainers ![](https://www.gravatar.com/avatar/4b8138927f33d6978608e73d01f2c42ef975bacd471c0b3235420beffcd21c90?d=identicon)[Andrew\_gos](/maintainers/Andrew_gos) --- Tags phpapibottelegramtelegram botandrew-gos ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/andrew-gos-telegram-bot/health.svg) ``` [![Health](https://phpackages.com/badges/andrew-gos-telegram-bot/health.svg)](https://phpackages.com/packages/andrew-gos-telegram-bot) ``` ### Alternatives [tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[typo3/cms TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL. 1.2k1.9M122](/packages/typo3-cms)[cakephp/cakephp The CakePHP framework 8.9k19.5M1.8k](/packages/cakephp-cakephp)[typo3/cms-core TYPO3 CMS Core 3713.2M5.1k](/packages/typo3-cms-core)[symfony/symfony The Symfony PHP framework 31.4k87.2M2.2k](/packages/symfony-symfony)[drupal/core-recommended Locked core dependencies; require this project INSTEAD OF drupal/core. 6942.5M420](/packages/drupal-core-recommended) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)