PhpBotFramework

Marco PHP Bot

PhpBotFramework es un marco confiable y completo para Telegram Bot API con soporte para API de pagos .

Diseñado para ser rápido y fácil de usar, proporciona todas las funciones que un usuario necesita para comenzar a desarrollar bots de Telegram.

Uso

 <?php

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

Características

• Modular: lleva sólo lo que necesitas
• Solicitudes HTTP flexibles con Guzzle
• Diseñado para ser rápido y fácil de usar
• Soporte para actualizaciones locales y webhooks
• Soporte para los métodos API más importantes.
• Sistema de manejo de comandos para mensajes y consultas de devolución de llamadas.
• Procesamiento basado en el tipo de actualización
• Fácil creación de teclado en línea
• Controlador de resultados de consultas en línea
• Soporte e instalaciones de bases de datos.
• Soporte Redis
• Soporte para bots multilenguaje
• Soporte para estados de bots
• Subir archivos locales
• Altamente documentado

Requisitos

• PHP >= 7.0
• php-mbstring
• Composer (para instalar este paquete y los necesarios)
• Servidor web: requerido para webhook (recomendamos nginx)
• Certificado SSL: requerido para webhook (siga estos pasos para crear un certificado autofirmado o use Let's Encrypt)

Instalación

Puedes instalar PhpBotFramework usando Composer .

Vaya a la carpeta de su proyecto y escriba:

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

Documentación

Consulte la documentación para obtener más información sobre PhpBotFramework.

Preguntas frecuentes

• ¿Por qué no implementamos solicitudes asincrónicas?

  Usamos Guzzle para enviar solicitudes HTTP a la API de Telegram Bot.

  Lamentablemente, no implementa solicitudes asincrónicas reales, sino una especie de .

  Eche un vistazo a este número para obtener más información.

• ¿Por qué no hay un parámetro chat_id para pasar a los métodos API?

  PhpBotFramework es lo suficientemente "inteligente" como para configurarlo como el ID de usuario, grupo o canal actual. La mayoría de los marcos que existen requieren que especifiques el ID del chat para la llamada de cada método, pero PhpBotFramework lo hace por ti llamando a la mayoría de los métodos API en el chat actual.

Ejemplos

Puede encontrar una lista de ejemplos directamente en la carpeta examples/ .

Todos los ejemplos enumerados aquí son completamente funcionales: solo necesita un token de bot de Telegram válido.

Hecho con PhpBotFramework

• MyAddressBookBot: Pruébelo en Telegram
• Giveaways_Bot: Pruébalo en Telegram

Pruebas

PhpBotFramework viene con un conjunto de pruebas que puedes ejecutar usando PHPUnit .

Debe configurar la variable de entorno MOCK_SERVER_PORT que le indica a PhpBotFramework en qué puerto se ejecuta el servidor simulado que permite ejecutar las pruebas.

 export MOCK_SERVER_PORT=9696

Ahora puedes ejecutar el servidor simulado:

./start_mock_server.sh

Y ejecute el conjunto de pruebas:

php vendor/bin/phpunit

Autor

Este marco es desarrollado y mantenido por Danilo Spinella y Dom Corvasce.

Licencia

PhpBotFramework se publica bajo la licencia pública general reducida GNU v3.

Puede copiar, distribuir y modificar el software siempre que las modificaciones se describan y tengan licencia gratuita según LGPL-3. Los trabajos derivados (incluidas las modificaciones) solo se pueden redistribuir bajo LGPL-3, pero las aplicaciones que utilizan el marco no tienen que serlo.