Home

Awesome

PHP Telegram Bot Example

:construction: Work In Progress :construction:

An A-Z example of Telegram bot using the PHP Telegram Bot library.

This repository aims to demonstrate the usage of all the features offered by the PHP Telegram Bot library and as such contains all example commands. Also, it gives an example setup for both the standard usage and using the PHP Telegram Bot Manager

:exclamation: Important!

Let's get started then! :smiley:

0. Cloning this repository

To start off, you can clone this repository using git:

$ git clone https://github.com/php-telegram-bot/example-bot.git

or better yet, download it as a zip file:

$ curl -o example-bot.zip https://github.com/php-telegram-bot/example-bot/archive/master.zip

Unzip the files to the root of your project folder.

1. Making it yours

Now you can choose what installation you would like, either the default one or using the Bot Manager project. Depending on which one you choose, you can delete the files that are not required.


First of all, you need to rename config.example.php to config.php and then replace all necessary values with those of your project.

Default Some of these files require extra configurations to be added. Check hook.php how they are loaded. Thanks to reading the main readme file, you should know what these files do.

Bot Manager Using the bot manager makes life much easier, as all configuration goes into a single file, manager.php.

If you decide to use the Bot Manager, be sure to read all about it and change the require block in the composer.json file:

"require": {
    "php-telegram-bot/telegram-bot-manager": "*"
}

Then, edit the following files, replacing all necessary values with those of your project.


Now you can install all dependencies using composer:

$ composer install

2. Adding your own commands

To use Commands enable the CustomCommands folder in the config.

You can find a few example commands in the Commands folder. Do NOT just copy all of them to your bot, but instead learn from them and only add to your bot what you need.

Adding any extra commands to your bot that you don't need can be a security risk!

To be continued!