Download the PHP package bagart/telegram-bot-lib without Composer

telegram-bot-lib

Pure Telegram Bot API library.

Installation

Commands

commands/poller.php

Long polling with DTO (typed objects).

commands/poller-raw.php

Long polling in raw mode: no DTOs, no Processors, no Registry

commands/mapper.php

Simulate incoming webhook payloads. Offline DTO mapper example

commands/webhook.php

You can configure your bot webhook via web interface: bagart.github.io/tg-webhook. Is more powerful and useful.

Manage webhook — show current, set or delete. Secret is auto-generated in format {botId}:{sha256(tokenPart)}.

commands/actualize.sh

Generate Telegram Bot API DTOs. Actualize is mean: npm update schema + build json + generate DTOs

Webhook Entry Point

Framework-free Example of Webhook entry point for web server with DTOProcessors (default: echo, store) Usage: point your web server to telegram-bot-lib/public/

Allowed Security:

• IP firewall: allows only Telegram IPs (149.154.160.0/20, 91.108.4.0/22)
• Expect Secret as {botId}:{sha256(tokenPart)} format validation via AutoSecretByTokenService

Processors

Update processors handle incoming Telegram updates. Build-in DTOProcessors

Register processors:

Benchmarks

DNS resolution benchmark (./cmd/xhprof_bench_dns):

Ranked by time (fastest → slowest):

1. ask-dns — 0.0648s (724.9 rps, fairness 98/100, mem 10.0 MB)
2. react-dns — 0.0721s (651.7 rps, fairness 97/100, mem 10.0 MB)
3. amphp-dns — 0.2421s (194.1 rps, fairness 100/100, mem 20.0 MB, 10.0 MB Δ)
4. native — 2.4466s (19.2 rps, fairness 96/100, mem 10.0 MB)

Components

commands - framework-free command for polling and set webhook public - Framework-free Example of Webhook entry point for web server with DTOProcessors src/ - framework-free Telegram Bot lib ├── ApiCommunication/ — Guzzler async client and TelegramBot specific options │ ├── TgBotApiClient — raw Guzzle Api client to Telegram │ └── TgBotApiDTOClient — full DTO Telegram Client ├── BotServices/ │ ├── AutoSecretByTokenService — secret service as {botId}:{sha256(tokenPart)} │ ├── BotRegistry — Registry of bot to use them by tokens or secrets(webhook) │ ├── BotSecretDTO — Bot token and secret DTO │ └── WebhookManager — get/set/delete webhook, auto-secret, buildTextInfo ├── Contracts/ - All copde with strict consistency contracts ├── DevTool/ │ └── DTOGenerator — DTO AutoGenerator for Telegram Types and Methods ├── ExampleServices/ — framework-free services │ ├── TgPureFactory — factory for example commands and webhook │ └── TinyFileCache — simple framework-free PSR-16 file cache implementation ├── Http/ │ ├── Validators/ — simple framework-free PSR-16 file cache implementation │ │ ├── Laravel/ — Laravel middleware │ │ │ └── .. │ │ ├── Symfony/ — Symfony middleware │ │ │ └── .. │ │ ├── TelegramIpValidator — Validate Telegram Bot Webhook by IP ranges │ │ └── AutoSecretByTokenService — Validate Telegram Bot Webhook by secret(auto secret by default) │ ├── TgApiResponse — Regular Telegram Response format │ ├── TgApiWebhookHandler — framework-free Response Processor for controller │ └── TgBotApiReturnParser — ^^^^^^^ is need to union ├── TgApi/ — Autogenerated DTO and Enum. Try to not edit. It will auto-re-generated │ ├── Methods/ — Autogenerated DTO and Enum for Methods │ ├── Types/ — Autogenerated DTO and Enum for Types │ └── TgApiEntityScopeEnum — Discovery of TelegramScope (Methods|Types) with all AutoGenerated DTO List ├── TgApiServices/ — Services for DTO │ ├── TgApiDTOMapper — Map Raw(array) Telegram Types/Methods to DTO │ ├── TgApiProperty — data schema for TgApiDTOContract::tgPropertyMetas │ ├── TgEntityNamer — Simple helper to return nname of user|chat|etc │ ├── TgEntityToDTORegistry — Registry of TgEntity(original terlegram name) to DTO. Can be registered Outaside of TelegramBot Lib │ └── TgEntityToDTORegistryFactory — Factory of TgEntityToDTORegistry ├── TypeDTOProcessor/ — Processors with Resistry to process incoming returns with TypeDTOContracts │ ├── Processors/ — Default Processods │ │ └── .. │ └── TypeDTOProcessorRegistry — Registry for Processors By TgApiTypeDTO ├── Wrappers/ — Wrappers for Framework-free code │ ├── TgBotCacheWrapper — Cache Wrapper │ └── TgBotLogWrapper — Logger Wrapper └── TelegramBotServiceProvider — Laravel ServiceProvider (optional)