Repolode
提交项目
nutgram

nutgram/nutgram

用于构建 Telegram 机器人的 PHP 框架，支持处理器、中间件、会话与完整 Bot API。

在 GitHub 查看官网
Star
757
Fork
82
未关闭 Issue
5
最近提交
上个月

这是什么？

Nutgram 是一个用于编写 Telegram 机器人的 PHP 框架。它封装了 Telegram Bot API，开发者可以为命令、文本匹配等各类更新注册处理器，几行代码即可运行机器人。简单的机器人可以快速搭建，复杂的交互流程则可以借助中间件、分组、会话和内联菜单来组织。

框架覆盖了机器人开发的常见需求，包括全局与用户数据存储、可替换的缓存和日志（分别兼容 PSR-16 和 PSR-3）、速率限制、批量与分块发送消息以及测试工具。它基于 PHP 8.2，与具体框架无关，同时提供原生 PHP 入门模板，并有 Laravel 与 Symfony 的集成包。

核心功能

  • 01为命令、文本匹配及所有 Telegram 更新类型注册处理器
  • 02通过中间件和分组在多个处理器间复用逻辑
  • 03提供会话系统和 InlineMenu 类，便于构建多步骤交互
  • 04支持全局与用户数据存储，缓存和日志可替换为 PSR 标准实现
  • 05支持批量与分块发送消息，并内置速率限制

适用场景

  • 构建响应命令和关键词的客服或常见问题机器人
  • 实现问卷、预订、注册引导等多步骤 Telegram 交互
  • 为现有 Laravel 或 Symfony 应用添加 Telegram 接入
  • 向大量用户群发消息并遵守 Telegram 的发送限制

快速上手

  1. 1

    使用 Composer 安装该包

    composer require nutgram/nutgram
  2. 2

    用你的 Telegram 令牌创建 bot 实例、注册处理器，然后调用 run

使用前须知

  • 当前主版本 4.x 需要 PHP 8.2 或更高版本；3.x 版本支持 PHP 8.0+ 但已停止维护。

收录于专题

AI 聊天机器人与聊天客户端应用开发框架

标签

#telegram-bot#php#bot-framework#telegram-bot-api#chatbot#messaging#api#framework#hacktoberfest#laravel

常见问题

nutgram 是什么？
用于构建 Telegram 机器人的 PHP 框架，支持处理器、中间件、会话与完整 Bot API。 Nutgram 是一个用于编写 Telegram 机器人的 PHP 框架。它封装了 Telegram Bot API，开发者可以为命令、文本匹配等各类更新注册处理器，几行代码即可运行机器人。简单的机器人可以快速搭建，复杂的交互流程则可以借助中间件、分组、会话和内联菜单来组织。
nutgram 可以免费使用吗？用的什么许可证？
nutgram 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
nutgram 还在维护吗？
半年内有更新。nutgram 最近一次提交是在 2026年10月4日。
nutgram 适合用来做什么？
构建响应命令和关键词的客服或常见问题机器人 实现问卷、预订、注册引导等多步骤 Telegram 交互 为现有 Laravel 或 Symfony 应用添加 Telegram 接入 向大量用户群发消息并遵守 Telegram 的发送限制
nutgram 怎么安装和运行？
使用 Composer 安装该包: composer require nutgram/nutgram 用你的 Telegram 令牌创建 bot 实例、注册处理器，然后调用 run
在哪里获取 nutgram？
源代码和安装说明在 GitHub 上：https://github.com/nutgram/nutgram

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目