The PHP extension tdlib allows you to work with the Telegram database library.
If simple, this is the usual functions wrapper for working with the tdlib/td json client. You can:
- create a JSON client
$client = td_json_client_create() - execute the synchronous request
$result = td_json_client_execute($client, $json); - perform an asynchronous request
td_json_client_send($client, $json);* - get all the responses at the moment
$response = td_json_client_receive($client, $timeout); - and destroy client
td_json_client_destroy($client);
* you must use td_json_client_receive to get a response from an asynchronous request.
td_json_client.h File Reference
Video tutorial how to install and simple usage
https://github.com/tdlib/td/blob/master/example/cpp/tdjson_example.cpp
<?php
$client = td_json_client_create();
td_json_client_execute($client, json_encode(['@type' => 'setLogVerbosityLevel', 'new_verbosity_level' => '0']));
$waitTimeout = 10;
while(true)
{
$result = td_json_client_receive($client, $waitTimeout);
if(!empty($result)) {
echo $result;
break;
}
}
td_json_client_destroy($client);$client = new \TDLib\JsonClient();
$client->setDefaultTimeout(10);
$result = $client->execute($stringQuery);
$client->send($stringQuery);
$response = $client->receive($floatTimeout);
$response = $client->query($stringQuery, $floatTimeout);
$responses = $client->getReceivedResponses();
$client->destroy();Thanks to @maxvgi, phptdlib has a really good implementation of query method. You no longer need to use send and receive (but you can if you want). An additional field will be added to query, and will wait for this additional field in the responses. Since this is for asynchronous requests, before you get an answer to the request, you can get others. And you can get all the responses to the last request with $client->getReceivedResponses();
Example. Simple workflow:
- create a client
setTdlibParameters- if need,
setDatabaseEncryptionKey - if
getAuthorizationStatereturnsauthorizationStateWaitPhoneNumber, thensetAuthenticationPhoneNumber - if
getAuthorizationStatereturnsauthorizationStateWaitCode, thencheckAuthenticationCode - if
getAuthorizationStatereturnsauthorizationStateReady, then you are allowed to do what you want withtdlib/td(Function class reference).
<?php
Error_Reporting(E_ALL);
ini_set('display_errors', 1);
$api_id = 11111; // must be an integer
$api_hash = 'abcdef1234567890abcdef1234567890';
$phone_number = '+380991234567';
try {
\TDApi\LogConfiguration::setLogVerbosityLevel(\TDApi\LogConfiguration::LVL_ERROR);
$client = new \TDLib\JsonClient();
$tdlibParams = new \TDApi\TDLibParameters();
$tdlibParams
->setParameter(\TDApi\TDLibParameters::USE_TEST_DC, true)
->setParameter(\TDApi\TDLibParameters::DATABASE_DIRECTORY, '/var/tmp/tdlib')
->setParameter(\TDApi\TDLibParameters::FILES_DIRECTORY, '/var/tmp/tdlib')
->setParameter(\TDApi\TDLibParameters::USE_FILE_DATABASE, false)
->setParameter(\TDApi\TDLibParameters::USE_CHAT_INFO_DATABASE, false)
->setParameter(\TDApi\TDLibParameters::USE_MESSAGE_DATABASE, false)
->setParameter(\TDApi\TDLibParameters::USE_SECRET_CHATS, false)
->setParameter(\TDApi\TDLibParameters::API_ID, $api_id)
->setParameter(\TDApi\TDLibParameters::API_HASH, $api_hash)
->setParameter(\TDApi\TDLibParameters::SYSTEM_LANGUAGE_CODE, 'en')
->setParameter(\TDApi\TDLibParameters::DEVICE_MODEL, php_uname('s'))
->setParameter(\TDApi\TDLibParameters::SYSTEM_VERSION, php_uname('v'))
->setParameter(\TDApi\TDLibParameters::APPLICATION_VERSION, '0.0.10')
->setParameter(\TDApi\TDLibParameters::ENABLE_STORAGE_OPTIMIZER, true)
->setParameter(\TDApi\TDLibParameters::IGNORE_FILE_NAMES, false);
$result = $client->setTdlibParameters($tdlibParams);
$result = $client->setDatabaseEncryptionKey();
$state = $client->getAuthorizationState();
// you must check the state and follow workflow. Lines below is just for an example.
// $result = $client->setAuthenticationPhoneNumber($phone_number, 3); // wait response 3 seconds. default - 1.
// $result = $client->query(json_encode(['@type' => 'checkAuthenticationCode', 'code' => 'xxxxx', 'first_name' => 'dummy', 'last_name' => 'dummy']), 10);
$result = $client->query(json_encode(['@type' => 'searchPublicChat', 'username' => 'telegram']), 10);
$allNotifications = $client->getReceivedResponses();
} catch (\Exception $exception) {
echo sprintf('something goes wrong: %s', $exception->getMessage());
}Please note that TDLib itself requires a lot of resources. The extension will be built in a couple of seconds. But the extension requires compiled tdlib/td. A minimum of 4GB of RAM is recommended. But I know that it is possible to build on a VPS with g++ and 2GB RAM + swap.
The most of dependencies are installed via git submodules currently.
But PHP-CPP currently has to be built separately.
git clone https://github.com/CopernicaMarketingSoftware/PHP-CPP.git
cd PHP-CPP
make
sudo make installIf you want to link other dependencies as dynamic libraries, you can pass some options to cmake. Look through CMakeLists.txt comments to find out how.
git clone --recurse-submodules https://github.com/yaroslavche/phptdlib.git
cd phptdlib && mkdir build && cd build
cmake ..
make
sudo make installphp -i | grep tdlib
php ../php_examples/func.phpFeel free to $client->query(json_encode(['@type' => 'sendMessage', 'chat' => '@yaroslavche'])); if you have any questions.