telegram-bot-sdk

用 PHP 快速构建 Telegram 机器人，Laravel 开箱即用

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 676 🐛 待处理 29 👀 关注 99

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3300

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源PHP SDK，完全免费，无付费版本。

项目预览

项目数据

分类对话助手

开发团队irazasyed

官网地址https://telegram-bot-sdk.com

GitHubhttps://github.com/irazasyed/telegram-bot-sdk

定价模式🏷️完全免费

价格说明开源PHP SDK，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议BSD-3-Clause

主要语言PHP

技术栈/模型bot,bot-framework,botkit,chatbot,composer-packages,laravel,laravel-package,laravel-telegram,php,php-sdk,telegram,telegram-bot,telegram-bot-api,telegram-bot-sdk

GitHub 星标★ 3300

上线时间2015-06-29 00:00:00

代码更新2026-08-20

仓库体积2.1 MB

本站数据更新2026-11-08

维护状态维护中

收录时间2026-08-09

浏览次数4

项目介绍

telegram-bot-sdk 是一个用 PHP 编写的 Telegram Bot API 开发工具包，旨在让开发者用 PHP 快速构建 Telegram 机器人。它封装了 Telegram Bot API 的绝大部分接口，提供了简洁流畅的调用方式，并原生支持 Laravel 框架，可通过服务提供者和门面（Facade）无缝集成。该 SDK 解决了 PHP 开发者对接 Telegram Bot API 时需手动处理 HTTP 请求、参数格式化和响应解析的痛点，内置了键盘、内联模式、文件上传等高级功能，并支持 Webhook 和长轮询两种更新获取方式。其核心能力包括：完整的 API 方法覆盖、类型安全的响应对象、事件驱动处理更新、以及丰富的文档和示例，让开发者能专注于业务逻辑而非底层通信细节。无论是简单通知机器人还是复杂交互式助手，该 SDK 都能显著降低开发门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3300

技术标签

bot bot-framework chatbot laravel php

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 10 分钟部署方式：库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

PHP 运行环境（该 SDK 为 PHP 语言开发）
Composer 依赖管理工具（项目以 Packagist 包形式发布）
一个 Telegram 机器人及其 Token（需通过 Telegram Bot API 创建）
Laravel 项目（可选，README 说明开箱即支持 Laravel）

安装与启动步骤

1确认 PHP 环境

该 SDK 是用 PHP 编写的 Telegram Bot API 工具包，先确认本机已安装 PHP 并可正常执行。
```
php -v
```
2确认 Composer

项目通过 Packagist 以 Composer 包形式分发，需先安装 Composer 才能引入依赖。
```
composer -V
```
3查阅官方安装文档

README 节选未包含 Installation 章节，请先打开官网与仓库 README 获取准确的安装方式与版本要求。
4在项目中引入 SDK

按官方文档说明，将 Packagist 上的包 irazasyed/telegram-bot-sdk 作为依赖安装到你的 PHP 项目。
```
composer require irazasyed/telegram-bot-sdk
```
5创建并配置机器人

前往 Telegram 按 Bot API 与 Bot FAQ 的说明创建机器人，拿到访问 Token 后写入项目配置。

关键配置

配置项	必填	说明	示例
`TELEGRAM_BOT_TOKEN`	是	机器人访问令牌，调用 Telegram Bot API 时用于鉴权，在机器人创建流程中获取	`123456789:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`