phenogram/framework

Telegram bot API 框架

2.6.1 2024-09-22 13:29 UTC

This package is auto-updated.

Last update: 2024-09-22 13:29:52 UTC


README

警告

项目处于活跃开发状态,不建议在生产环境中使用。

这是一个简单的PHP框架,用于创建任何复杂度的Telegram机器人。

主要动机是编写一个具有严格类型化的Telegram API工具。

所有API类型都位于相邻项目中:bindings,并且可以在不使用此框架的情况下使用。如果您只想发送请求并接收类型化响应,它们就足够了。

在框架中,生活品质将略有提高 - 路由、中间件、处理器。支持使用long-polling模式的事件循环。

开发优先考虑的是易用性和性能。由于底层运行amphp和fibers,因此可以编写异步处理器。

安装

composer require phenogram/framework

使用

最简单的示例

// bot.php
<?php

require_once __DIR__ . '/vendor/autoload.php';

$token = ''; // Ваш токен

$bot = new TelegramBot($token);
$bot
    ->addHandler(fn (Update $update) => $bot->api->sendMessage(
        chatId: $update->message->chat->id,
        text: $update->message->text
    ))
    ->supports(fn (Update $update) => $update->message?->text !== null);

$bot->run();

通过 php bot.php 运行

您在屏幕上什么也看不到,因为甚至日志记录器都没有配置。但是机器人将会工作并响应任何消息。

待办事项:完善README和文档

目前,您可以在这里找到一个更复杂的机器人示例(尽管它使用的是旧版本的框架):点击这里