php-telegram-bot/laravel

Package to integrate PHP Telegram Bot library in Laravel 5.x

Telegram Bot Package for Laravel 6.x, 7.x, and 8.x

, _(*1)

This package helps easily integrate PHP Telegram Bot library in Laravel application., _(*2)

Table of Contents

• Installation
• Usage
• TODO
• Troubleshooting
• Contributing
• License
• Credits

Installation

Install this package through Composer., _(*3)

Edit your project's composer.json file to require php-telegram-bot/laravel, _(*4)

Create composer.json file:, _(*5)

{
    "name": "yourproject/yourproject",
    "type": "project",
    "require": {
        "php-telegram-bot/laravel": "^1.0"
    }
}

And run composer update, _(*6)

Or run a command in your command line:, _(*7)

composer require php-telegram-bot/laravel

Copy the package config and migrations to your project with the publish command:, _(*8)

php artisan vendor:publish --provider="PhpTelegramBot\Laravel\ServiceProvider"

After run migration command, _(*9)

php artisan migrate

In the config you have to specify Telegram API KEY, _(*10)

Usage

You can inject PhpTelegramBot\Laravel\PhpTelegramBotContract in anywhere and use bot instance, _(*11)

For example:, _(*12)

<?php
namespace App\Http\Controllers;

use PhpTelegramBot\Laravel\PhpTelegramBotContract;

class CustomController extends Controller
{
    public function handle(PhpTelegramBotContract $telegramBot)
    {
        // Call handle method
        $telegramBot->handle();

        // Or set webhook 
        $hookUrl = 'https://hook.url';
        $telegramBot->setWebhook($hookUrl);

        // Or handle telegram getUpdates request
        $telegramBot->handleGetUpdates();
    }
}

More details about usage you can see on the PHP Telegram Bot docs: https://github.com/php-telegram-bot/core#instructions, _(*13)

TODO

write more tests, _(*14)

Troubleshooting

If you like living on the edge, please report any bugs you find on the php-telegram-bot/laravel issues page., _(*15)

Contributing

Pull requests are welcome. See CONTRIBUTING.md for information., _(*16)

License

Please see the LICENSE included in this repository for a full copy of the MIT license, which this project is licensed under., _(*17)

Credits

• Avtandil Kikabidze aka LONGMAN

Full credit list in CREDITS, _(*18)