muxtorov98/php-telegram-framework

⚡ Modular Telegram Bot Framework built with PHP 8.2+, supporting Handlers, Attributes, and Long Polling.

Maintainers

Details

github.com/Muxtorov98/php-telegram-framework

Source

Issues

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

pkg:composer/muxtorov98/php-telegram-framework

v1.0.0 2025-11-11 08:24 UTC

Requires

MIT bee48e14b5f0300d347e212eb8d2d6d52b432bf2

frameworkphpbotmodularlong-pollingtelegramtelegram-bot-sdk

This package is auto-updated.

Last update: 2025-11-11 08:26:38 UTC

README

Bu loyiha — Telegram orqali mahsulotlarni ko‘rish, savatga qo‘shish va buyurtma berish imkonini beruvchi modulli Telegram Shop Bot tizimi.

⚙️ Texnologiyalar

  • PHP 8.2+
  • Telegram Bot SDK (irazasyed/telegram-bot-sdk)
  • Illuminate Database (Capsule ORM) – Laravel ORM
  • PostgreSQL
  • Docker & Docker Compose
  • Long Polling (Webhook’siz)

📁 Loyihaning tuzilishi

app/
 ├── Console/
 │   ├── Commands/
 │   │   ├── MigrateCommand.php
 │   │   ├── SetBotCommands.php
 │   │   └── ResetBotCommands.php
 │   └── ConsoleKernel.php
 ├── Core/
 │   ├── Bot.php
 │   ├── Router.php
 │   ├── Polling.php
 │   ├── FormFlowManager.php
 │   ├── Attributes/
 │   │   ├── Handler.php
 │   │   ├── FormStep.php
 │   │   └── Permission.php
 │   └── Helpers/
 │       ├── SessionHelper.php
 │       └── FileHelper.php
 ├── Handlers/
 │   ├── Users/
 │   │   ├── StartHandler.php
 │   │   ├── RegisterHandler.php
 │   │   └── AuthHandler.php
 │   └── Shop/
 │       ├── ProductViewHandler.php
 │       ├── CartHandler.php
 │       └── OrderHandler.php
 ├── Services/
 │   ├── LoggerService.php
 │   ├── PaginationHelper.php
 │   ├── ProductService.php
 │   ├── OrderService.php
 │   └── CartService.php
 └── Data/
     └── Config.php

🚀 Ishga tushirish

1️⃣ Muhitni sozlash

.env fayl yarating (yoki example.env dan nusxa oling):

BOT_TOKEN=YOUR_TELEGRAM_BOT_TOKEN
DB_CONNECTION=pgsql
DB_HOST=db
DB_PORT=5432
DB_DATABASE=shop_bot
DB_USERNAME=postgres
DB_PASSWORD=postgres
CHAT_IDS=1234567
ADMIN_IDS=1234567,9999999
MANAGER_IDS=8888888,7777777
APP_DEBUG=true

2️⃣ Docker Compose bilan ishga tushirish

docker compose up -d --build

3️⃣ Ma’lumotlar bazasi migratsiyalari

docker compose exec telegram-bot php bin/console migrate

Migratsiya komandalar:

Komanda Tavsif
migrate Barcha migratsiyalarni ishga tushiradi
migrate down So‘nggi migratsiyalarni orqaga qaytaradi
migrate refresh Hammasini o‘chirib, qayta yaratadi

4️⃣ Botni ishga tushirish

docker compose exec telegram-bot php bin/console bot:run

Bu Polling orqali botni ishga tushiradi:

🤖 Bot started via long polling...

🧩 Komandalar (sidebar menyular)

Har bir rol uchun alohida menyu o‘rnatiladi:

👤 User menyu

/start
/products
/cart
/my_orders
/help

👑 Admin menyu

/start
/add_product
/products
/cart
/orders
/notify_users
/help

🧑‍💼 Manager menyu

/start
/orders
/products
/help

Menyularni yangilash:

docker compose exec telegram-bot php bin/console set:commands

Eski menyularni tozalash:

docker compose exec telegram-bot php bin/console reset:commands

🧱 Asosiy komponentlar

🔹 FormFlowManager

  • Har bir chat_id uchun step va answers ma’lumotlarini sessiyada saqlaydi
  • context bo‘yicha formani boshqaradi
  • reset() orqali tozalaydi

🔹 Router

  • #[Handler] attributlari orqali avtomatik handlerlarni topadi
  • #[Permission] orqali rolga asoslangan ruxsatni tekshiradi
  • Fayl turlari (photo, document va boshqalar) uchun file download imkonini beradi
  • callback_query bilan JSON yoki prefix:data formatlarini avtomatik ajratadi

🔹 Polling

  • Long polling loop
  • Har ishga tushganda avtomatik SetBotCommands chaqiradi
  • Har bir update uchun Bot::run() orqali Routerni chaqiradi

💼 Shop modullari

🛍 ProductViewHandler

  • /products orqali mahsulotlarni chiqaradi
  • Inline tugmalar: ▶️ keyingi, ◀️ oldingi, 🛒 savatga qo‘shish
  • PaginationHelper orqali page boshqariladi

🛒 CartHandler

  • /cart yoki 🛒 Savatim orqali savatni ko‘rsatadi
  • Inline tugmalar: ✅ Buyurtma berish, 🗑 Tozalash
  • Session orqali cart saqlanadi ($_SESSION['cart'][$chatId])

📦 OrderHandler

  • ✅ Buyurtma berish tugmasi orqali savatdagi mahsulotlardan order yaratadi
  • Orderlar orders jadvalida saqlanadi
  • /my_orders komandasi orqali foydalanuvchi buyurtmalarini ko‘rishi mumkin

🧹 Avtomatik menyu yangilanishi

Polling ishga tushganda har safar:

(new \App\Console\Commands\SetBotCommands())->handle();

– shu sababli bot restart qilinganda menyular yangilanadi.

🛠 CLI komandalar

Komanda Tavsif
php bin/console migrate Migratsiyalarni ishga tushirish
php bin/console set:commands Telegram menyularni o‘rnatish
php bin/console reset:commands Eski menyularni tozalash
php bin/console bot:run Botni ishga tushirish (polling)

📜 Loglar

Barcha loglar:

/storage/logs/bot.log

LoggerService quyidagi holatlarni rangli formatda yozadi:

  • ✅ SUCCESS
  • ⚠️ WARNING
  • ❌ ERROR
  • ℹ️ INFO

📦 Keyingi rejalashtirilgan modullar

  • 🔐 JWT asosida autentifikatsiya
  • 🧾 Excel / CSV buyurtma export
  • 🧠 AI product recommendation
  • 📊 Admin panel (Next.js + API)

👨‍💻 Muallif

Tulqin Muxtorov
GitHub: muxtorov98

🚀 “Chat orqali sotuv — bu kelajakdagi e-commerce!”