กรอบงาน Php Bot

โลโก้ PhpBotFramework

PhpBotFramework เป็นเฟรมเวิร์กที่เชื่อถือได้และสมบูรณ์สำหรับ Telegram Bot API พร้อมรองรับ Payments API

ออกแบบมาให้ใช้งานได้รวดเร็วและง่ายดาย โดยมีคุณสมบัติทั้งหมดที่ผู้ใช้ต้องการเพื่อเริ่มพัฒนาบอท 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 );

คุณสมบัติ

โมดูลาร์: หยิบมาเฉพาะสิ่งที่คุณต้องการเท่านั้น
คำขอ HTTP ที่ยืดหยุ่นด้วย Guzzle
ออกแบบมาให้ใช้งานง่ายและรวดเร็ว
รองรับการอัปเดตท้องถิ่นและ webhooks
รองรับวิธี API ที่สำคัญที่สุด
ระบบจัดการคำสั่งสำหรับข้อความและคำสั่งโทรกลับ
อัปเดตการประมวลผลตามประเภท
การสร้าง คีย์บอร์ดอินไลน์ อย่างง่ายดาย
ตัวจัดการผลลัพธ์แบบสอบถามแบบอินไลน์
การสนับสนุนฐานข้อมูลและสิ่งอำนวยความสะดวก
การสนับสนุน Redis
รองรับบอทหลายภาษา
รองรับสถานะบอท
อัปโหลดไฟล์ในเครื่อง
มีเอกสารชัดเจน

ข้อกำหนด

PHP >= 7.0
php-mbstring.php
ผู้แต่ง (เพื่อติดตั้งแพ็คเกจนี้และแพ็คเกจที่จำเป็น)
เว็บเซิร์ฟเวอร์: จำเป็นสำหรับ webhook (เราแนะนำ nginx)
ใบรับรอง SSL: จำเป็นสำหรับ webhook (ทำตามขั้นตอนเหล่านี้เพื่อสร้างใบรับรองที่ลงนามด้วยตนเอง หรือใช้ Let's Encrypt)

การติดตั้ง

คุณสามารถติดตั้ง PhpBotFramework โดยใช้ Composer

ไปที่โฟลเดอร์โครงการของคุณแล้วพิมพ์:

composer require danyspin97/php-bot-framework
composer install --no-dev

เอกสารประกอบ

ตรวจสอบเอกสารประกอบเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับ PhpBotFramework

คำถามที่พบบ่อย

เหตุใดเราจึงไม่ใช้คำขอแบบอะซิงโครนัส
เราใช้ Guzzle เพื่อส่งคำขอ HTTP ไปยัง Telegram Bot API
น่าเสียดายที่ไม่ได้ใช้คำขอแบบอะซิงโครนัสจริง แต่ เป็นประเภท .
ดูปัญหานี้สำหรับข้อมูลเพิ่มเติม
เหตุใดจึงไม่มีพารามิเตอร์ chat_id ที่จะส่งผ่านสำหรับวิธี API
PhpBotFramework นั้น "ฉลาด" พอที่จะตั้งค่าเป็นรหัสผู้ใช้ กลุ่ม หรือช่องสัญญาณปัจจุบัน กรอบงานส่วนใหญ่กำหนดให้คุณต้องระบุ ID แชทสำหรับการเรียกทุกวิธี แต่ PhpBotFramework ทำเพื่อคุณในการเรียกวิธี API ส่วนใหญ่ในการแชทปัจจุบัน

ตัวอย่าง

คุณสามารถดูรายการตัวอย่างบอทได้ในโฟลเดอร์ examples/

ตัวอย่างทั้งหมดที่แสดงไว้ที่นี่ทำงานได้อย่างสมบูรณ์: คุณจำเป็นต้องมี โทเค็นบอต Telegram ที่ถูกต้องเท่านั้น

สร้างด้วย PhpBotFramework

MyAddressBookBot: ลองใช้บน Telegram
Giveaways_Bot: ลองใช้บน 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 Lesser General Public License v3

คุณสามารถคัดลอก แจกจ่าย และแก้ไขซอฟต์แวร์ได้ โดยมีเงื่อนไขว่าจะมีการอธิบายและอนุญาตการแก้ไขได้ฟรีภายใต้ LGPL-3 งานอนุพันธ์ (รวมถึงการดัดแปลง) สามารถแจกจ่ายซ้ำได้ภายใต้ LGPL-3 เท่านั้น แต่ไม่จำเป็นต้องเผยแพร่แอปพลิเคชันที่ใช้เฟรมเวิร์ก

ขยาย

ข้อมูลเพิ่มเติม