包简介

Advanced strictly typed Telegram Bot Library

README 文档

README

🌟 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

💯 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.

📦 Installation

To install the library, use Composer:

composer require andrew-gos/telegram-bot

📚 Documentation

To get started and explore the library's features in-depth, please refer to the following sections:

Section	Description
🚀 Basic Usage (BASIC.md)	Start here. A step-by-step guide to creating your first bot and handling commands.
⚙️ Advanced Usage (ADVANCED.md)	Learn about Middleware, Plugins, custom `Checkers`, and other powerful tools.
🧩 Framework Integration
• Symfony (SYMFONY.md)	A guide to setting up the library as a service in Symfony applications.
• Yii2 (YII2.md)	A guide for integrating with the Yii2 framework's DI container.

🤝 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 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

Fork the repository on GitHub.
Create a new branch for your changes (e.g. fix/message-parsing-error).
Make your changes. Ensure your code adheres to the project's coding style.
Run the code style fixer. This project uses php-cs-fixer. You can apply the style rules by running:
```
composer php-cs-fix
```
Add or update tests. Your pull request should include tests that cover your changes.
Submit a Pull Request to the master branch with a clear description of your changes.

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

andrew-gos/telegram-bot 适用场景与选型建议

andrew-gos/telegram-bot 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 251 次下载、GitHub Stars 达 1，最近一次更新时间为 2025 年 05 月 05 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「php」「api」「bot」「telegram」「telegram-bot」「andrew-gos」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 andrew-gos/telegram-bot 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 andrew-gos/telegram-bot 我们能提供哪些服务？

定制开发 / 二次开发

基于 andrew-gos/telegram-bot 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发