tds/telegram-bundle

Symfony service wrapper for irazasyed/telegram-bot-sdk

TDSTelegramBundle

TDSTelegramBundle is just a service wrapper for Telegram Bot API PHP SDK, _(*1)

WARNING Not all features of the original SDK are supported (although the main features are working). See the TODOs section for more info., _(*2)

Installation

Step 1: Download Bundle using composer, _(*3)

Require the bundle with composer:, _(*4)

$ composer require tds/telegram-bundle "dev-master"

Composer will install the bundle to your project's vendor directory., _(*5)

Step 2: Enable the bundle, _(*6)

Enable the bundle in the kernel:, _(*7)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new TDS\TelegramBundle\TelegramBundle(),
        // ...
    );
}

Step 3: Configure your application's config.yml, _(*8)

    tds_telegram:
        default: 'default'
        async_requests: false
        http_client_handler: ~
        bots:
            default:
                username: 'SampleBot'
                token: 'YOUR TOKEN HERE'

Step 4: Create your commands, _(*9)

1. Create a command class, as shown at the SDK documentation
2. Make this command a symfony service at your services.yml:

    app.telegram_command.start_command:
        class: AppBundle\Telegram\Command\StartCommand
        tags:
          - { name: 'tds_telegram.command', bot: 'default' }

As you can notice 'bot' parameter is the same as bot, defined at main config's bots section. It tells the BotManager where it should inject this command, defined as a an ordinary symfony service., _(*10)

Step 5: Use the library, _(*11)

Simple example of getting BotsManager service, fetching from it the desired bot and processing updates with commands:, _(*12)

    $manager = $this->getContainer()->get('tds_telegram.bot.bots_manager');
    $bot = $manager->bot('default');
    while (1) {
        $upd = $bot->commandsHandler();
    }

Step 6: Read the docs, _(*13)

Investigate the SDK documentation, _(*14)

TODOs

This section here is a reminder of the current bundle's minimalistic composition. Feel free to contribute!, _(*15)

1. Unit tests and CI
2. http_client_handler option is untested
3. command_groups and shared_commands options are not implemented
4. Think about late commands initialization
5. Think about builtin CLI command and controller
6. Better config docs

License

This bundle is under the MIT license. See the complete license in the bundle:, _(*16)

LICENSE, _(*17)