PhpBotFramework

Estrutura de bot PHP

PhpBotFramework é um framework confiável e completo para Telegram Bot API com suporte a APIs de pagamentos .

Projetado para ser rápido e fácil de usar, oferece todos os recursos que um usuário precisa para começar a desenvolver bots do Telegram.

Uso

 

// 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: leve apenas o que você precisa
• Solicitações HTTP flexíveis com Guzzle
• Projetado para ser rápido e fácil de usar
• Suporte para atualizações locais e webhooks
• Suporte para os métodos API mais importantes
• Sistema de manipulação de comandos para mensagens e consultas de retorno de chamada
• Processamento baseado em tipo de atualização
• Criação fácil de teclado embutido
• Manipulador de resultados de consulta in-line
• Suporte e recursos de banco de dados
• Suporte Redis
• Suporte para bots multilíngues
• Suporte para estados de bot
• Carregar arquivos locais
• Altamente documentado

Requisitos

• PHP >= 7.0
• php-mbstring
• Composer (para instalar este pacote e os necessários)
• Servidor Web: necessário para webhook (recomendamos nginx)
• Certificado SSL: necessário para webhook (siga estas etapas para criar um certificado autoassinado ou use Let's Encrypt)

Instalação

Você pode instalar o PhpBotFramework usando o Composer .

Vá para a pasta do seu projeto e digite:

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

Documentação

Verifique a documentação para aprender mais sobre o PhpBotFramework.

Perguntas frequentes

• Por que não implementamos solicitações assíncronas?

  Usamos Guzzle para disparar solicitações HTTP para a API Telegram Bot.

  Infelizmente, ele não implementa solicitações assíncronas reais, mas uma espécie de .

  Dê uma olhada neste problema para obter mais informações.

• Por que não existe um parâmetro chat_id para passar para métodos de API?

  PhpBotFramework é "inteligente" o suficiente para defini-lo como o usuário, grupo ou ID de canal atual. A maioria das estruturas existentes exige que você especifique o ID do chat para cada chamada de método, mas o PhpBotFramework faz isso para você chamar a maioria dos métodos de API no chat atual.

Exemplos

Você pode encontrar uma lista de exemplos de bot diretamente na pasta examples/ .

Todos os exemplos listados aqui são totalmente funcionais: você só precisa de um token de bot válido do Telegram .

Feito com PhpBotFramework

• MyAddressBookBot: experimente no Telegram
• Giveaways_Bot: Experimente no Telegram

Teste

PhpBotFramework vem com um conjunto de testes que você pode executar usando PHPUnit .

Você precisa definir a variável de ambiente MOCK_SERVER_PORT que informa ao PhpBotFramework em qual porta executa o servidor simulado que permite a execução dos testes.

 export MOCK_SERVER_PORT=9696

Agora você pode executar o servidor simulado:

./start_mock_server.sh

E execute o conjunto de testes:

php vendor/bin/phpunit

Autor

Este framework é desenvolvido e mantido por Danilo Spinella e Dom Corvasce.

Licença

PhpBotFramework é lançado sob GNU Lesser General Public License v3.

Você pode copiar, distribuir e modificar o software, desde que as modificações sejam descritas e licenciadas gratuitamente sob LGPL-3. Obras derivadas (incluindo modificações) só podem ser redistribuídas sob LGPL-3, mas os aplicativos que usam a estrutura não precisam ser.