کتابخانه RubikaBot PHP

یک پکیج PHP قدرتمند و کامل برای ساخت ربات‌های روبیکا با معماری شیءگرا و امکانات پیشرفته. این کتابخانه توسعه ربات‌ها را بسیار ساده و لذت‌بخش می‌کند.

ویژگی‌های اصلی¶

✅ پشتیبانی کامل از Markdown و HTML برای فرمت‌بندی متن
✅ مدیریت پیشرفته کیبوردهای اینلاین و معمولی
✅ سیستم فیلترینگ قدرتمند برای مدیریت پیام‌ها
✅ مدیریت خودکار اسپم و محافظت از ربات
✅ آپلود و ارسال انواع فایل‌ها
✅ پشتیبانی از تمام انواع پیام‌ها
✅ معماری شیءگرا و قابل توسعه
✅ مستندات کامل و مثال‌های متعدد

مراحل استفاده¶

با استفاده از Bot Father به آدرس @BotFather در روبیکا یک بات بسازید.
توکن دریافتی را کپی کنید و در باقی مراحل از آن استفاده کنید.

نصب و راه‌اندازی¶

اول از همه از طریق ین لینک کتبخاته را گیت کلون کنید!
```
https://github.com/Daniyel-Vanguard/Rubika-Bot.git
```

نصب با Composer

composer require rubikabot/rubikabot:dev-main

راه‌اندازی اولیه

<?php
require_once 'vendor/autoload.php';

use RubikaBot\Bot;
use RubikaBot\Filters\Filters;

$token = "YOUR_BOT_TOKEN";
$bot = new Bot($token);

// تعریف هندلر برای دستور start
$bot->onMessage(Filters::command('start'), function(Bot $bot, $message) {
    $bot->chat($message->chat_id)
        ->message("سلام! به ربات خوش آمدید 👋")
        ->send();
});

// اجرای ربات
$bot->run();

مثال سریع¶

یک ربات ساده که به پیام‌ها پاسخ می‌دهد:

<?php
require_once 'vendor/autoload.php';

use RubikaBot\Bot;
use RubikaBot\Filters\Filters;

$bot = new Bot('YOUR_TOKEN');

// پاسخ به دستور start
$bot->onMessage(Filters::command('start'), function(Bot $bot, $message) {
    $bot->chat($message->chat_id)
        ->message('به ربات خوش آمدید! 🎉')
        ->send();
});

// پاسخ به سلام
$bot->onMessage(Filters::text('سلام'), function(Bot $bot, $message) {
    $bot->chat($message->chat_id)
        ->message('سلام! چطور می‌تونم کمک کنم؟')
        ->send();
});

// مدیریت فایل‌های ارسالی
$bot->onMessage(Filters::file(), function(Bot $bot, $message) {
    $bot->chat($message->chat_id)
        ->message('فایل شما دریافت شد! 📁')
        ->send();
});

$bot->run();

مثال پیشرفته با کیبورد

<?php
require_once 'vendor/autoload.php';

use RubikaBot\Bot;
use RubikaBot\Keyboard\Keypad;
use RubikaBot\Keyboard\Button;

$bot = new Bot('YOUR_TOKEN');

// ساخت کیبورد اینلاین
$keypad = Keypad::make()
    ->row()
        ->add(Button::simple('btn1', 'دکمه ۱'))
        ->add(Button::simple('btn2', 'دکمه ۲'))
    ->row()
        ->add(Button::simple('btn3', 'دکمه ۳'));

$bot->onMessage(Filters::command('start'), function(Bot $bot, $message) use ($keypad) {
    $bot->chat($message->chat_id)
        ->message('منوی اصلی:')
        ->inlineKeypad($keypad->toArray())
        ->send();
});

// مدیریت کلیک دکمه‌ها
$bot->onMessage(Filters::button('btn1'), function(Bot $bot, $message) {
    $bot->chat($message->chat_id)
        ->message('شما دکمه ۱ را زدید!')
        ->send();
});

$bot->run();

آموزش‌های ویدیویی

برای یادگیری کامل می‌توانید از آموزش‌های ویدیویی استفاده کنید:

نکته

این کتابخانه به طور مداوم در حال توسعه و بهبود است. برای دریافت آخرین نسخه و گزارش مشکلات به صفحه GitHub مراجعه کنید.