How miraliog/pelegram works
Pelegram is a webhook-only PHP wrapper for the Telegram Bot API. Its principal workflow is Telegram delivering an update to the application, Update exposing typed accessors and type detection, Router matching and dispatching it to a registered handler, and the handler using Bot or typed message/query actions to reply through Telegram. Filters, middleware, per-user state, typed objects, enums, and fluent keyboard builders support that workflow. The excerpts show Bot API calls and routing, but not all Router dispatch paths or Bot internals; unsupported connections are omitted.
Main entry points: Router.php Router · Bot.php Bot API client · Message.php Message · Update.php Webhook update
Components 22
Updates and types
- Webhook update
src/Update.php - Update accessors
src/Concerns/Accessors - Update detection
src/Concerns/Update - Message
src/Types/Message.php - Callback query
src/Types/CallbackQuery.php - Inline query
src/Types/InlineQuery.php
Routing and state
- Router
src/Router.php - Handler entry
src/HandlerEntry.php - Filters
src/Filters - Middleware
src/Contracts/MiddlewareInterface.php - User state
src/State/State.php - State data
src/State/StateData.php - State drivers
src/State/Drivers
Telegram API
- Bot API client
src/Bot.php - API enums
src/Enums
Keyboards
- Reply keyboards
src/Types/Keyboard/ReplyKeyboardMarkup.php - Inline keyboards
src/Types/Keyboard/InlineKeyboardMarkup.php - Keyboard buttons
src/Types/Keyboard/KeyboardButton.php - Inline buttons
src/Types/Keyboard/InlineKeyboardButton.php - Keyboard removal
src/Types/Keyboard/ReplyKeyboardRemove.php
Other components
- Telegram
- Bot application
Connections 27
- Telegram → Webhook update: delivers webhook
- Bot application → Router: dispatches bot
- Router → Webhook update: routes update
src/Router.php - Webhook update → Update accessors: uses traits
src/Update.php - Webhook update → Update detection: uses traits
src/Update.php - Router → Handler entry: registers handlers
src/Router.php - Handler entry → Filters: checks filters
src/HandlerEntry.php - Router → Filters: applies filters
src/Router.php - Router → Middleware: runs middleware
src/Router.php - Router → Message: constructs message
src/Router.php - Router → Callback query: constructs query
src/Router.php - Router → Inline query: constructs query
src/Router.php - Router → User state: loads state
src/Router.php - User state → State data: provides data
src/State/State.php - User state → State drivers: uses driver
src/State/State.php - Message → Bot API client: calls API
src/Types/Message.php - Callback query → Bot API client: calls API
src/Types/CallbackQuery.php - Inline query → Bot API client: calls API
src/Types/InlineQuery.php - Bot API client → Telegram: sends API requests
src/Bot.php - Reply keyboards → Keyboard buttons: contains buttons
src/Types/Keyboard/ReplyKeyboardMarkup.php - Inline keyboards → Inline buttons: contains buttons
src/Types/Keyboard/InlineKeyboardMarkup.php - Message → Reply keyboards: accepts markup
src/Types/Message.php - Message → Inline keyboards: accepts markup
src/Types/Message.php - Message → Keyboard removal: accepts markup
src/Types/Message.php - Bot API client → Reply keyboards: serializes markup
src/Bot.php - Bot API client → Inline keyboards: serializes markup
src/Bot.php - Bot API client → Keyboard removal: serializes markup
src/Bot.php