PhpBotFramework

PHP-Bot-Framework

PhpBotFramework ist ein zuverlässiges und vollständiges Framework für die Telegram Bot API mit Unterstützung für Zahlungs-APIs .

Es ist schnell und einfach zu bedienen und bietet alle Funktionen, die ein Benutzer benötigt, um mit der Entwicklung von Telegram-Bots zu beginnen.

Verwendung

 

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

Merkmale

• Modular: Nehmen Sie nur das, was Sie brauchen
• Flexible HTTP-Anfragen mit Guzzle
• Entwickelt, um schnell und einfach zu bedienen zu sein
• Unterstützung für lokale Updates und Webhooks
• Unterstützung der wichtigsten API-Methoden
• Befehls-Handle-System für Nachrichten und Rückrufabfragen
• Aktualisierungstypbasierte Verarbeitung
• Einfache Inline-Tastaturerstellung
• Handler für Inline-Abfrageergebnisse
• Datenbankunterstützung und -einrichtungen
• Redis-Unterstützung
• Unterstützung für mehrsprachige Bots
• Unterstützung für Bot-Zustände
• Laden Sie lokale Dateien hoch
• Hochdokumentiert

Voraussetzungen

• PHP >= 7.0
• php-mbstring
• Composer (um dieses Paket und die erforderlichen Pakete zu installieren)
• Webserver: erforderlich für Webhook (wir empfehlen Nginx)
• SSL-Zertifikat: für Webhook erforderlich (folgen Sie diesen Schritten, um ein selbstsigniertes Zertifikat zu erstellen oder Let's Encrypt zu verwenden)

Installation

Sie können PhpBotFramework mit Composer installieren.

Gehen Sie zum Ordner Ihres Projekts und geben Sie Folgendes ein:

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

Dokumentation

Sehen Sie sich die Dokumentation an, um mehr über PHPBotFramework zu erfahren.

FAQ

• Warum implementieren wir keine asynchronen Anfragen?

  Wir verwenden Guzzle, um HTTP-Anfragen an die Telegram Bot API auszulösen.

  Leider werden keine echten asynchronen Anfragen implementiert, sondern eine Art .

  Weitere Informationen finden Sie in dieser Ausgabe.

• Warum gibt es keinen chat_id Parameter, der für API-Methoden übergeben werden kann?

  PhpBotFramework ist „intelligent“ genug, um es als aktuelle Benutzer-, Gruppen- oder Kanal-ID festzulegen. Bei den meisten verfügbaren Frameworks müssen Sie die Chat-ID für den Aufruf jeder Methode angeben, PhpBotFramework erledigt dies jedoch für Sie und ruft die meisten API-Methoden im aktuellen Chat auf.

Beispiele

Eine Liste mit Beispielen finden Sie direkt im Ordner examples/ .

Alle hier aufgeführten Beispiele sind voll funktionsfähig: Sie benötigen lediglich einen gültigen Telegram-Bot-Token .

Erstellt mit PHPBotFramework

• MyAddressBookBot: Probieren Sie es auf Telegram aus
• Giveaways_Bot: Probieren Sie es auf Telegram aus

Testen

PHPBotFramework wird mit einer Testsuite geliefert, die Sie mit PHPUnit ausführen können.

Sie müssen die Umgebungsvariable MOCK_SERVER_PORT festlegen, die PhpBotFramework mitteilt, auf welchem ​​Port der Mock-Server ausgeführt wird, der die Ausführung der Tests ermöglicht.

 export MOCK_SERVER_PORT=9696

Jetzt können Sie den Mock-Server ausführen:

./start_mock_server.sh

Und führen Sie die Testsuite aus:

php vendor/bin/phpunit

Autor

Dieses Framework wird von Danilo Spinella und Dom Corvasce entwickelt und gepflegt.

Lizenz

PHPBotFramework wird unter der GNU Lesser General Public License v3 veröffentlicht.

Sie dürfen die Software kopieren, verbreiten und modifizieren, sofern die Modifikationen unter LGPL-3 beschrieben und kostenlos lizenziert werden. Abgeleitete Werke (einschließlich Modifikationen) können nur unter LGPL-3 weitergegeben werden, Anwendungen, die das Framework verwenden, müssen dies jedoch nicht tun.