Stars: 764
Forks: 181
Pull Requests: 47
Issues: 104
Watchers: 57
Last Updated: 2023-09-16 07:40:37
Complete async capable Telegram bot API implementation for PHP7
License: MIT License
Languages: PHP, Shell, Dockerfile
This is a PHP7 bot API implementation for Telegram implementing the vast majority of Bot API up until v4.7. The only thing it does not implement is Telegram Passport which was introduced in Bot API v4.0. It is unlikely to be introduced as it may introduce security vulnerabilities. However, if you think you have a strong case for the need, feel free to let me know.
The only thing that is not included in this library (yet) is the Passport support. This was an ongoing development, but it ended up being a lot more work than initially thought, so if someone wants to pick that up... be my guest!
All other known bugs can be found in the form of issues or pull requests. Found a new bug? Feel free to submit a PR or create an issue! Not sure if you've found a new bug? You can always ask in the special group :)
Composer is a tool for dependency management in PHP. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you. Read this for installation instructions.
The preferred (and only for now) installation method is Composer, so add the following to your composer.json:
{
"require": {
"unreal4u/telegram-api": "~3.4"
}
}
If you are not familiar with it, I suggest reading the basic usage manual located here.
In order to use a proxy, you can use the https://github.com/clue/php-socks-react package and pass on the following options to the Client:
<?php
use Clue\React\Socks\Client;
$loop = Factory::create();
// Replace PROXY_ADDRESS and PROXY_PORT with the correct configuration
$proxy = new Client('socks5://' . PROXY_ADDRESS . ':' . PROXY_PORT, new Connector($loop));
$handler = new HttpClientRequestHandler($loop, [
'tcp' => $proxy,
'timeout' => 3.0,
'dns' => false
]);
$this->tgLog = new TgLog(BOT_TOKEN, $handler);
// The rest is exactly the same as it normally is, see the examples folder for more information
With these simple steps, a proxy is configured in no time!
A lot of backwards incompatibility changes, but in a nutshell:
TgLog
Please check the following Wiki page if you have to upgrade from v2 to v3.
<?php
use \unreal4u\TelegramAPI\HttpClientRequestHandler;
use \unreal4u\TelegramAPI\TgLog;
use \unreal4u\TelegramAPI\Telegram\Methods\SendMessage;
$loop = \React\EventLoop\Factory::create();
$handler = new HttpClientRequestHandler($loop);
$tgLog = new TgLog(BOT_TOKEN, $handler);
$sendMessage = new SendMessage();
$sendMessage->chat_id = A_USER_CHAT_ID;
$sendMessage->text = 'Hello world!';
$tgLog->performApiRequest($sendMessage);
$loop->run();
(Side note: In case React\EventLoop\Factory
cannot be resolved in the above code, add include('vendor/autoload.php')
to your PHP file).
With the SendMessage()
object, you can create a message to be sent through the TgLog object.
All other functionality is based upon this behaviour, so every other method is very similar: you instantiate an object,
pass that object to TelegramLog->performApiRequest(), which will return a Promise. If the method returns a reply,
pass a callback to its onFulfilled
parameter and you'll get the native Telegram response back as an object.
Different methods return different object types.
Please refer to the examples directory to view examples of some of the implemented methods, including inline bots.
For examples of actual code that works in a production environment, please refer to my other repo: https://github.com/unreal4u/telegram-bots
Please check the following wiki section for more information on this.
Please checkout the special wiki page about inline bots.
If you want to use this package, you'll need a bot API key. Check the following documentation for more instructions on that.
The most difficult thing to do when performing an action with the Telegram API is to get the chat_id, which is the actual conversation window the bot talks to. You can execute the GetUpdates() method in order to get this chatId. Note that there are some caveats on this, so you may be better out with the SetWebhook() method instead.
I will try my best to respect Semantic Versioning.
That being said, the first stable release is v1.0.0, from there on no mayor BC changes will occur unless we update
the major.
Collaborations are very welcome! Check this Wiki page out for more information that will make the development easier!
I actually don't use Telegram. Nah, kidding, I created a group where you can contact me at https://t.me/PHPBotAPI. Another great way to get in touch is to simply create an issue or a pull request!
I would appreciate it if you could handle these responsibly. If you happen to find a security issue relating to this Telegram Bot API client, please ask me to contact you privately over here.