PhpBotFramework

Kerangka Bot Php

PhpBotFramework adalah kerangka kerja yang andal dan lengkap untuk API Bot Telegram dengan dukungan API Pembayaran .

Dirancang agar cepat dan mudah digunakan, ia menyediakan semua fitur yang dibutuhkan pengguna untuk mulai mengembangkan bot Telegram.

Penggunaan

 

// 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 );

Fitur

• Modular: ambil hanya yang Anda perlukan
• Permintaan HTTP fleksibel dengan Guzzle
• Dirancang agar cepat dan mudah digunakan
• Dukungan untuk pembaruan lokal dan webhook
• Dukungan untuk metode API yang paling penting
• Sistem pegangan perintah untuk pesan dan permintaan panggilan balik
• Perbarui pemrosesan berbasis tipe
• Pembuatan keyboard sebaris yang mudah
• Pengendali hasil kueri sebaris
• Dukungan dan fasilitas database
• Dukungan Redis
• Dukungan untuk bot multibahasa
• Dukungan untuk status bot
• Unggah file lokal
• Sangat terdokumentasi

Persyaratan

• PHP >= 7.0
• php-mbstring
• Komposer (untuk menginstal paket ini dan yang diperlukan)
• Server web: diperlukan untuk webhook (kami merekomendasikan nginx)
• Sertifikat SSL: diperlukan untuk webhook (ikuti langkah-langkah berikut untuk membuat sertifikat yang ditandatangani sendiri atau gunakan Let's Encrypt)

Instalasi

Anda dapat menginstal PhpBotFramework menggunakan Composer .

Buka folder proyek Anda dan ketik:

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

Dokumentasi

Periksa dokumentasi untuk mempelajari lebih lanjut tentang PhpBotFramework.

Pertanyaan Umum

• Mengapa kami tidak menerapkan permintaan asinkron?

  Kami menggunakan Guzzle untuk menjalankan permintaan HTTP ke Telegram Bot API.

  Sayangnya itu tidak mengimplementasikan permintaan asinkron yang sebenarnya, melainkan semacam .

  Lihatlah masalah ini untuk informasi lebih lanjut.

• Mengapa tidak ada parameter chat_id yang diteruskan ke metode API?

  PhpBotFramework cukup "pintar" untuk menetapkannya sebagai ID pengguna, grup, atau saluran saat ini. Sebagian besar kerangka kerja di luar sana mengharuskan Anda menentukan ID obrolan untuk setiap panggilan metode tetapi PhpBotFramework melakukannya untuk Anda memanggil sebagian besar metode API pada obrolan saat ini.

Contoh

Anda dapat menemukan daftar contoh bot langsung di folder examples/ .

Semua contoh yang tercantum di sini berfungsi penuh: Anda hanya memerlukan token bot Telegram yang valid.

Dibuat dengan PhpBotFramework

• MyAddressBookBot: Cobalah di Telegram
• Giveaways_Bot: Cobalah di Telegram

Pengujian

PhpBotFramework hadir dengan rangkaian pengujian yang dapat Anda jalankan menggunakan PHPUnit .

Anda perlu menyetel variabel lingkungan MOCK_SERVER_PORT yang memberi tahu PhpBotFramework di port mana yang menjalankan server tiruan yang memungkinkan pengujian dijalankan.

 export MOCK_SERVER_PORT=9696

Sekarang Anda dapat menjalankan server tiruan:

./start_mock_server.sh

Dan jalankan rangkaian pengujian:

php vendor/bin/phpunit

Pengarang

Kerangka kerja ini dikembangkan dan dikelola oleh Danilo Spinella dan Dom Corvasce.

Lisensi

PhpBotFramework dirilis di bawah GNU Lesser General Public License v3.

Anda boleh menyalin, mendistribusikan, dan memodifikasi perangkat lunak asalkan modifikasi tersebut dijelaskan dan dilisensikan secara gratis berdasarkan LGPL-3. Karya turunan (termasuk modifikasi) hanya dapat didistribusikan ulang di bawah LGPL-3, namun aplikasi yang menggunakan kerangka tersebut tidak harus.