شروع کار با لاراول بله

نیازمندی‌ها

لاراول بله فقط لاراول ۱۳ و پی‌اچ‌پی ۸٫۳ یا جدیدتر را پشتیبانی می‌کند.

نصب

composer require sajaddp/laravel-bale

پیکربندی

توکن بازو را در محیط برنامه قرار دهید:

BALE_BOT_TOKEN=your-bot-token

در صورت نیاز تنظیم را منتشر کنید:

php artisan vendor:publish --tag=bale-config

سپس کلاس دسترسی را وارد کنید:

use Sajaddp\Bale\Facades\Bale;

نخستین پیام و پاسخ

Bale::sendMessage(chatId: 123456789, text: 'سلام');

Bale::replyToMessage(
    message: $update['message'],
    text: 'پاسخ شما',
);

replyToMessage متد کمکی پکیج است. دادهٔ خام پیام باید message_id و chat.id را به‌صورت عدد صحیح داشته باشد؛ در غیر این صورت پیش از ارسال درخواست اچ‌تی‌تی‌پی، InvalidArgumentException رخ می‌دهد.

خطاهای پایه

پاسخ معتبر بله با ok: false به Sajaddp\Bale\Exceptions\BaleRequestException تبدیل می‌شود. پاسخ ناموفق اچ‌تی‌تی‌پی یا ساختار پاسخ نامعتبر، رفتار معمول کارخواه اچ‌تی‌تی‌پی لاراول را حفظ می‌کند و ممکن است Illuminate\Http\Client\RequestException یا UnexpectedValueException بدهد.

use Sajaddp\Bale\Exceptions\BaleRequestException;

try {
    Bale::sendMessage(chatId: 123456789, text: 'سلام');
} catch (BaleRequestException $exception) {
    report($exception->description);
}

برای مثال‌های بعدی دستورپخت‌ها، برای حدود رابط برنامه‌نویسی پوشش رسمی، و برای آزمون بدون شبکه راهنمای آزمون را ببینید.