‏LaraGram یک فریم‌ورک توسعه‌پذیر، منعطف و مدرن به زبان PHP برای ساخت ربات‌های تلگرامه که با الهام از ساختار لاراول طراحی شده.

اگر با لاراول آشنایی دارید، کار با LaraGram براتون راحت، لذت‌بخش و قابل پیش‌بینی خواهد بود — و حتی اگه آشنایی ندارید، ساختار منظمش خیلی زود براتون جا می‌افته.

‏LaraGram امکانات زیادی درون خودش داره که می‌تونید سخت‌ترین ربات‌ها رو با چند خط کد پیاده‌سازی کنید، اگر قابلیتی رو هم نداشته باشه می‌تونید به عنوان پکیج جانبی بهش اضافه کنید یا حتی برای اون پکیج توسعه بدید.

به عنوان مثال، LaraGram مجهز به یک سیستم Update Listener پیشرفته هست که به شما امکاناتی مانند گروه‌بندی لیسنرها، نام‌دهی به هر لیسنر، اعمال محدودیت و Middleware بر روی لیسنر، پردازش متن و ورودی‌ها، و... رو میده.

همچنین نسخه بازنویسی شده Eloquent ORM رو در خودش جا داده با پشتیبانی از ۵ دیتابیس مختلف، همراه با تعریف روابط، Migrations، Seeders و Factory‌ها.

سایر قابلیت های کلیدی اون:

🔐‌ سیستم کنترل مجوز با قابلیت تعریف Gate و Policy برای مدیریت دقیق سطح دسترسی کاربران به منابع مختلف.

‏💻‌ Commander System برای ساخت و اجرای راحت command‌ها، مدیریت ساده‌تر پروژه، و زمان‌بندی اجرای وظایف (Scheduled Tasks).

📨‌ ‏Queue و Job System برای ساخت صف و اجرای کارها در پس‌زمینه با زمان‌بندی دلخواه.

🧰‌ رابط Redis با امکانات لازم برای توسعه‌های وابسته به کش، صف و پیام‌رسانی آنی.

🧠‌ سیستم کشینگ با پشتیبانی از ۷ درایور مختلف برای ذخیره‌سازی داده‌های موقتی، به‌همراه پیاده‌سازی Step Manager بر همین بستر.

🔁‌ کالکشن‌ها برای کار ساده‌تر و منعطف‌تر با داده‌های Iterable، مشابه کالکشن‌های Laravel.

⚙️‏‌ Concurrency‏ داخلی با امکان پردازش هم‌زمان چند درخواست در پس‌زمینه بدون پیچیدگی اضافه.

🔒‌ ابزارهای امنیتی با پشتیبانی از سیستم‌های رمزنگاری (Crypt) و هشینگ (Hash).

‏📢‌ Event Dispatcher برای تعریف و مدیریت رویدادها و واکنش به آن‌ها.

🎛‌ کیبورد بیلدر توسعه‌یافته با استفاده ساده و انعطاف پذیری بالا.

🧩‌ موتور قالب‌سازی پیشرفته الهام‌گرفته از Blade برای ساخت پیام‌ها به‌صورت پویا و قابل نگهداری.

🌍‌ سیستم چندزبانه (Translation) برای ساخت ربات‌هایی با پشتیبانی از زبان‌های مختلف.

✅‌ سیستم اعتبارسنجی با قوانین متنوع و امکان تعریف Rule‌های سفارشی.

🤖‌ پشتیبانی از چند ربات هم‌زمان و امکان تعریف چند کانکشن و مدیریت آن‌ها به‌صورت مستقل.

یک مثال ساده برای ایجاد یک کامند بن با user_id به مدت 7 روز، با کنترل دسترسی و شرط ریپلای نشدن کامند:

Bot::onCommand("ban {id}", function (Request $request, $id) {
  $request->banChatMember(
    chat_id: chat()->id,
    user_id: $id,
    until_date: now()->addDays(7)->timestamp
  );
})->can('administrator')->hasNotReply();

برخی از ویژگی‌ها با افزونه‌ها و پکیج‌های جانبی به LaraGram اضافه می‌شوند، به عنوان مثال:

‏⚡️‌ LaraGram Surge
پکیجی برای اجرای سریع‌تر ربات‌ها با پشتیبانی از Swoole و OpenSwoole

‏🔧‌ LaraGram Installer
برای نصب و راه‌اندازی سریع و ساده پروژه‌های LaraGram

‏🛢‌ LaraGram MongoDB‌‏
درایور پایگاه‌داده MongoDB برای Eloquent ORM


📚 مستندات رسمی LaraGram نیز از طریق لینک زیر در دسترس است:
🔗 laraxgram.github.io

💬 گروه پرسش و پاسخ:
🔹 @LaraGramChat

📌 پروژه در گیت‌هاب:
♦️ LaraGram

🔖 #TelegramBot, #ربات, #تلگرام

👤 AmirHossein

💎 Channel: @DevelopixRobot

🚀 ‏LaraGram Brain منتشر شد!

از این به بعد برای ساخت ربات‌های تلگرام با فریم‌ورک LaraGram، لازم نیست حتماً خودتون دست به کد بشید؛ یا حتی با توسعه ربات تلگرامی آشنا باشید!

کافیه ایده و توضیحات پروژه‌ای که می‌خواید رو به یک ایجنت هوش‌مصنوعی بدید و باقی کار رو به خودش بسپارید. 🤖

‏LaraGram Brain یک MCP Server برای فریم‌ورک LaraGram هست که مجموعه‌ای از ابزارها و اسکیل‌ها رو در اختیار ایجنت‌های هوش‌مصنوعی قرار می‌ده تا بتونن پروژه رو بهتر بشناسن، پیاده‌سازی کنن، تست بگیرن و حتی مشکلاتش رو بررسی کنن.

از جمله امکاناتش:
• اجرای متدهای تلگرام در محیط Sandbox بدون ارسال واقعی
• دسترسی به Schema و مستندات Telegram
• بررسی ساختار و Queryهای دیتابیس
• مشاهده Logهای برنامه
• جست‌وجو در مستندات LaraGram
•‏ Skillهای مربوط به Bot، MTProto، TMA و Web Pages

فرقی نمی‌کنه پروژه‌تون یه ربات ساده باشه یا یک پروژه پیچیده با MTProto و TMA؛ توضیحاتش رو به ایجنت بدید و اجازه بدید کار رو خودش انجام بده.

لینک پروژه‌ها:
🧩 LaraGram
🧩 Brain

🔖 #TelegramBot #ربات #تلگرام

💎 Channel: @DevelopixRobot

🚀 اجرای ربات تلگرامی در لوکال‌هاست!

‏LaraGram API Server یک پیاده‌سازی از Telegram Bot API Server با زبان PHP و مبتنی بر LaraGram MTProto است که امکان اجرای سرور اختصاصی Bot API تلگرام را بدون نیاز به بیلد کردن نسخه رسمی telegram-bot-api و وابستگی به سرویس‌های تونل‌سازی مانند ngrok فراهم می‌کند.

⚙️ معماری و نحوه عملکرد

این پروژه با استفاده از پروتکل MTProto و ایجاد یک لایه‌ی سازگار با Telegram Bot API، درخواست‌های استاندارد ربات‌های تلگرامی را پردازش می‌کند.
‏LaraGram API Server به‌عنوان یک جایگزین سازگار با سرور رسمی Telegram Bot API طراحی شده است؛ بنابراین، رابط HTTP، ساختار پاسخ‌ها، پیام‌های خطا و متدهای Bot API را پشتیبانی می‌کند و می‌تواند بدون وابستگی به فریم‌ورک LaraGram، در کنار کتابخانه‌های ربات‌نویسی در زبان‌های مختلف مورد استفاده قرار بگیرد.

✨ قابلیت‌های کلیدی

سازگاری با Bot API رسمی: پشتیبانی از تمام متدهای Telegram Bot API و سازگاری با ابزارها و کتابخانه‌های موجود.

بدون نیاز به بیلد دستی: نصب مستقیم از طریق Composer، بدون نیاز به کامپایل سورس کد سرور رسمی تلگرام.

اجرای مستقل و لوکال: امکان اجرای سرور روی لوکال‌هاست یا زیرساخت اختصاصی.

پشتیبانی از Local Mode: امکان آپلود فایل تا حجم ۲۰۰۰ مگابایت، دانلود فایل بدون محدودیت حجم و استفاده از مسیر محلی فایل‌ها.

پشتیبانی از Webhook: امکان استفاده از IP و پورت دلخواه برای دریافت آپدیت‌ها و پیکربندی اتصالات Webhook.

مدیریت و مانیتورینگ: پشتیبانی از گزارش‌گیری، ثبت لاگ و مشاهده آمار درخواست‌ها، آپدیت‌ها و مصرف منابع.

آماده برای محیط Production: قابلیت اجرا به‌صورت سرویس پایدار با ابزارهایی مانند systemd.

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

پیش‌نیازهای اصلی شامل PHP 8.3 یا بالاتر، افزونه Swoole و افزونه‌های JSON و Mbstring است.
نصب سراسری پکیج تنها با اجرای دستور زیر انجام می‌شود:

composer global require laraxgram/apiserver

پس از دریافت api_id و api_hash از پنل توسعه‌دهندگان تلگرام، می‌توانید سرور را اجرا کنید:

laragram-server --api-id=YOUR_API_ID --api-hash=YOUR_API_HASH --local

همچنین امکان نصب پکیج به‌صورت وابستگی پروژه و استفاده مستقیم از آن در اکوسیستم LaraGram وجود دارد.

📚 مستندات و راهنمای کامل

برای مشاهده پیش‌نیازها، تنظیمات، گزینه‌های اجرایی، نحوه استفاده در LaraGram، مدیریت فایل‌ها و راه‌اندازی Production، مستندات رسمی پروژه را مطالعه کنید:
🔗 https://laraxgram.github.io/v4/apiserver

و در نهایت با استار دادن به گیت‌هاب پروژه و معرفی به دیگران از اون حمایت کنید:
🔗 https://github.com/laraXgram/APIServer

@LaraXGram
@LaraGramChatFa

🔖 #TelegramBot #ربات #تلگرام

💎 Channel: @DevelopixRobot