README

A modern, fully featured PHP wrapper for the Telegram Bot API — built for developers who want full control and modern structure with PSR-4 compatibility.

GitHub: github.com/mostafabaghi/telegram-bot

🚀 Features

• PSR-4 autoloading
• Full API support (sendMessage, sendMedia, Polls, Payments...)
• Debug logging
• Webhook handler system
• Event Dispatcher system (like Laravel listeners)
• IP validation for Telegram
• File uploads via URL, local, or stream (memory)

📦 Installation

composer require mostafabaghi/telegram-bot

Or manually clone:

git clone https://github.com/mostafabaghi/telegram-bot.git
cd telegram-bot
composer install

🔧 Usage Example

Basic usage:

use TelegramBot\TelegramBotPlus;

$bot = new TelegramBotPlus('YOUR_BOT_TOKEN');
$bot->sendMessage(123456789, 'Hello world!');

Webhook handling:

$bot->setWebhookHandler(function($update) use ($bot) {
    if (isset($update['message']['text'])) {
        $chatId = $update['message']['chat']['id'];
        $bot->sendMessage($chatId, "Received: " . $update['message']['text']);
    }
});

$bot->handleWebhook();

📚 Documentation

✅ Core Methods

⚙️ Webhook Management

$bot->setWebhook('https://yourdomain.com/webhook.php');
$bot->deleteWebhook();
$bot->getWebhookInfo();

💡 Event System

$bot->on('message.text', function($message) use ($bot) {
    $bot->sendMessage($message['chat']['id'], 'Handled via event!');
});

🔐 IP Validation

if (!$bot->isFromTelegram()) {
    http_response_code(403);
    exit('Access Denied');
}

🧪 Testing

composer install
vendor/bin/phpunit

📜 License

MIT License © mostafabaghi