PhpBotFramework هو إطار عمل موثوق وكامل لواجهة برمجة تطبيقات Telegram Bot مع دعم واجهات برمجة تطبيقات الدفعات .
تم تصميمه ليكون سريعًا وسهل الاستخدام، فهو يوفر جميع الميزات التي يحتاجها المستخدم لبدء تطوير روبوتات Telegram.
// Include the framework
require ' ./vendor/autoload.php ' ;
// Create a bot
$ bot = new PhpBotFramework Bot ( " token " );
// Create a command that will be triggered everytime the user send `/start`
$ start_command = new PhpBotFramework Commands MessageCommand ( " start " ,
function ( $ bot , $ message ) {
// Reply with a message
$ bot -> sendMessage ( " Hello, folks! " );
}
);
$ bot -> addCommand ( $ start_command );
// A shortcut for message commands.
$ bot -> addMessageCommand ( ' about ' , function ( $ bot , $ message ) {
$ bot -> sendMessage ( ' Powered by PhpBotFramework ' );
});
// Receive updates from Telegram using getUpdates
$ bot -> run ( GETUPDATES );
يمكنك تثبيت PhpBotFramework باستخدام Composer .
انتقل إلى مجلد مشروعك واكتب:
composer require danyspin97/php-bot-framework
composer install --no-dev
تحقق من الوثائق لمعرفة المزيد حول PhpBotFramework.
لماذا لا ننفذ الطلبات غير المتزامنة؟
نحن نستخدم Guzzle لإطلاق طلبات HTTP إلى Telegram Bot API.
لسوء الحظ، فإنه لا ينفذ الطلبات الحقيقية غير المتزامنة ولكن نوعًا من .
ألق نظرة على هذه المشكلة لمزيد من المعلومات.
لماذا لا توجد معلمة chat_id
لتمريرها إلى أساليب واجهة برمجة التطبيقات؟
يعد PhpBotFramework "ذكيًا" بدرجة كافية لتعيينه كمعرف المستخدم الحالي أو المجموعة أو القناة. تتطلب معظم الأطر الموجودة منك تحديد معرف الدردشة لكل استدعاء لكل طريقة، لكن PhpBotFramework يقوم بذلك نيابةً عنك من خلال الاتصال بمعظم أساليب API في الدردشة الحالية.
يمكنك العثور على قائمة بأمثلة الروبوتات مباشرةً في المجلد examples/
.
جميع الأمثلة المذكورة هنا تعمل بكامل طاقتها: ما عليك سوى رمز مميز لبوت Telegram صالح.
يأتي PhpBotFramework مزودًا بمجموعة اختبار يمكنك تشغيلها باستخدام PHPUnit .
تحتاج إلى تعيين متغير البيئة MOCK_SERVER_PORT
الذي يخبر PhpBotFramework بالمنفذ الذي يقوم بتشغيل الخادم الوهمي الذي يسمح بتنفيذ الاختبارات.
export MOCK_SERVER_PORT=9696
يمكنك الآن تشغيل تشغيل الخادم الوهمي:
./start_mock_server.sh
وقم بتشغيل مجموعة الاختبار:
php vendor/bin/phpunit
تم تطوير هذا الإطار وصيانته بواسطة Danilo Spinella وDom Corvasce.
تم إصدار PhpBotFramework بموجب ترخيص GNU العام الأصغر v3.
يجوز لك نسخ البرنامج وتوزيعه وتعديله بشرط أن يتم وصف التعديلات وترخيصها مجانًا بموجب LGPL-3. لا يمكن إعادة توزيع أعمال المشتقات (بما في ذلك التعديلات) إلا بموجب LGPL-3، ولكن ليس من الضروري إعادة توزيع التطبيقات التي تستخدم إطار العمل.