madmagestelegram/client

Telegram bot client

0.6.0 2023-12-17 16:56 UTC

Requires

• php: ^7.4 | ^8
• ext-json: *
• guzzlehttp/guzzle: ^7
• madmagestelegram/types: *

MIT

• rpc
• bot
• telegram

README

Telegram client for php. Based on telegram bot types

Install

composer require madmagestelegram/client

Usage

// Basic client instance,
// its possible redefine guzzle client on second argument with own options, if necessary
$client = new \MadmagesTelegram\Client\Client('BOT_TOKEN');

// Chat id.
// Usually received in webhook or (https://core.telegram.org/bots/api#getupdates)
$chatId = 0;

// Simple text message
$client->sendMessage($chatId, 'Hello world');

// Simple text + disable message notification
$client->sendMessage($chatId, 'Here is silent message', null, null, null, true);


// It`s possible to send a file
$file = new \MadmagesTelegram\Types\Type\InputFile('/var/photos/some-photo.jpg');

// Here we can send "photo" as photo
$client->sendPhoto($chatId, $file);
// or document
$sentMessage = $client->sendDocument($chatId, $file);

// $sentMessage is instance of \MadmagesTelegram\Types\Type\Message
// As we send document in few lines upper, the property "document" is filled in returned message,
// so we can print it, accessing by getter
print_r($sentMessage->getDocument());

// it prints something like...
// MadmagesTelegram\Types\Type\Document Object
// (
//     [fileId:protected] => ...
//     [fileUniqueId:protected] => ...
//     [thumb:protected] => ...
//     [fileName:protected] => ...
//     [mimeType:protected] => ...
//     [fileSize:protected] => ...
// )

API

All methods definitions defined here