transport.md

Transport

By default TelegramBotApi uses cURL to make requests to the Telegram Bot API and download files from Telegram servers. But you can use any other transport implementation that implements the Vjik\TelegramBot\Api\Transport\TransportInterface interface.

Out of the box, available two transport implementations: cURL and PSR.

cURL

The CurlTransport class is a transport implementation for making requests to the Telegram Bot API using the cURL extension in PHP. This transport is often the easiest choice since the cURL extension is included in most PHP installations.

General usage:

use Vjik\TelegramBot\Api\TelegramBotApi;
use Vjik\TelegramBot\Api\Transport\CurlTransport;

// Telegram bot authentication token
$token = '110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw';

$transport = new CurlTransport();

$api = new TelegramBotApi($token, transport: $transport);

PSR

PSR transport requires the PSR-18 HTTP client and PSR-17 HTTP factories.

For example, you can use the php-http/curl-client and httpsoft/http-message:

composer require php-http/curl-client httpsoft/http-message

General usage:

use Http\Client\Curl\Client;
use HttpSoft\Message\RequestFactory;
use HttpSoft\Message\ResponseFactory;
use HttpSoft\Message\StreamFactory;
use Vjik\TelegramBot\Api\TelegramBotApi;
use Vjik\TelegramBot\Api\Transport\PsrTransport;

$streamFactory = new StreamFactory();
$responseFactory = new ResponseFactory();
$requestFactory = new RequestFactory();
$client = new Client($responseFactory, $streamFactory);

// Telegram bot authentication token
$token = '110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw';

$transport = new PsrTransport(
    $client,
    $requestFactory,
    $streamFactory,
);

$api = new TelegramBotApi($token, transport: $transport);

Constructor parameters:

• $client — PSR-18 HTTP client;
• $requestFactory — PSR-17 HTTP request factory;
• $streamFactory — PSR-17 HTTP stream factory;