PHPackages toropyga/telegram - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. toropyga/telegram ActiveLibrary[API Development](/categories/api) toropyga/telegram ================= Libraries for working with Telegram bot from Toropyga v3.0.1(2w ago)0140MITPHPPHP >=5.5.0 Since Aug 20Pushed 2w ago1 watchersCompare [ Source](https://github.com/Toropyga/Telegram)[ Packagist](https://packagist.org/packages/toropyga/telegram)[ RSS](/packages/toropyga-telegram/feed)WikiDiscussions master Synced 2d ago READMEChangelogDependencies (4)Versions (12)Used By (0) Telegram ======== [](#telegram) Sending messages on behalf of a Telegram bot [![License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)[![Version](https://camo.githubusercontent.com/9445ca3021af6c7cbfcf747a624d0bcf5ae2d37b018c3eebcf5a511d41ad13c2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d76332e302e312d626c75652e737667)](https://camo.githubusercontent.com/9445ca3021af6c7cbfcf747a624d0bcf5ae2d37b018c3eebcf5a511d41ad13c2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d76332e302e312d626c75652e737667)[![PHP](https://camo.githubusercontent.com/f85e9a1e19d96dd19978f3b621237a876e188c358f8ed0908fea7d51eda1a225/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d76352e355f2d2d5f76382d626c756576696f6c65742e737667)](https://camo.githubusercontent.com/f85e9a1e19d96dd19978f3b621237a876e188c358f8ed0908fea7d51eda1a225/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d76352e355f2d2d5f76382d626c756576696f6c65742e737667) Content ======= [](#content) - [General description](#General-description) - [Installation](#Installation) - [Configuration](#Configuration) - [Work description](#Work-description) - [Including a class file](#Including-a-class-file) - [Classes initialisation](#Classes-initialisation) - [Setting the method of interaction with the Telegram API when sending messages](#Setting-the-method-of-interaction-with-the-Telegram-API-when-sending-messages) - [Поддерживаемые методы](#%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5-%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D1%8B) - [Установка токена телеграм бота](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%D0%B0-%D1%82%D0%B5%D0%BB%D0%B5%D0%B3%D1%80%D0%B0%D0%BC-%D0%B1%D0%BE%D1%82%D0%B0) - [Установка параметров Webhook-сервера](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%BE%D0%B2-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0-Webhook) - [Удаление сервера Webhook](#%D0%A3%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B0-Webhook) - [Получение информации о сервере Webhook](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%B8-%D0%BE-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D0%B5-Webhook) - [Установка идентификатора получателя](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D0%B0-%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B0%D1%82%D0%B5%D0%BB%D1%8F) - [Включение отладки](#%D0%92%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D1%82%D0%BB%D0%B0%D0%B4%D0%BA%D0%B8) - [Получение логов](#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BB%D0%BE%D0%B3%D0%BE%D0%B2) - [Пример отправки сообщения](#%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B8-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F) - [Пример отправки фотографии](#%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B8-%D1%84%D0%BE%D1%82%D0%BE%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%B8) General description =================== [](#general-description) The Telegram class is designed to send messages on behalf of the Telegram bot. To work, you need PHP version 5.5 or higher, PHP libraries php-json and php-curl. Additional libraries are also used [Base](https://github.com/Toropyga/Base) and [NetContent](https://github.com/Toropyga/NetContent) Installation ============ [](#installation) Recommended way to install NetContent library using [Composer](http://getcomposer.org/): ``` composer require toropyga/telegram ``` Configuration ============= [](#configuration) Pre-setting of default parameters can be done either directly in the class itself or using named constants. Named constants are declared before calling the class, if necessary, for example in the configuration file, and define the default parameters. - TELEGRAM\_TOKEN - [Telegram Bot Token](https://core.telegram.org/bots/api#authorizing-your-bot); - TELEGRAM\_ID - [chat ID](https://t.me/username_to_id_bot) (person) to whom a message are sending - TELEGRAM\_DEBUG - enable or disable debugging options; - TELEGRAM\_LOG\_NAME - logs file name; Work description ================ [](#work-description) Including a class file ---------------------- [](#including-a-class-file) ``` require_once("NetContent.php"); require_once("Base.php"); require_once("Telegram.php"); ``` or use composer ``` require_once("vendor/autoload.php"); ``` --- Classes initialisation ---------------------- [](#classes-initialisation) ``` use Toropyga\Base; $net = new Toropyga\NetContent(); $telegram = new Toropyga\Telegram($net); ``` or with automatic connection of the NetContent class ``` use Toropyga\Base; $telegram = new Toropyga\Telegram(); ``` --- Setting the method of interaction with the Telegram API when sending messages ----------------------------------------------------------------------------- [](#setting-the-method-of-interaction-with-the-telegram-api-when-sending-messages) ``` $telegram->setMethod('sendVideo'); ``` ### Поддерживаемые методы [](#поддерживаемые-методы) - ['sendMessage'](https://core.telegram.org/bots/api#sendmessage) - отправка текстового сообщения, - ['sendPhoto'](https://core.telegram.org/bots/api#sendphoto) - отправка фотографии или изображения, - ['sendDocument'](https://core.telegram.org/bots/api#senddocument) - отправка документа как вложения, - ['sendVideo'](https://core.telegram.org/bots/api#sendvideo) - отправка видео файла, - ['sendAudio'](https://core.telegram.org/bots/api#sendaudio) - отправка звукового файла, - ['sendVoice'](https://core.telegram.org/bots/api#sendvoice) - отправка голосового сообщения, - ['sendAnimation'](https://core.telegram.org/bots/api#sendanimation) - отправка анимированного изображения. --- Установка токена телеграм бота ------------------------------ [](#установка-токена-телеграм-бота) ``` $telegram->setToken("000000000:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"); ``` --- Установка параметров сервера Webhook ------------------------------------ [](#установка-параметров-сервера-webhook) ``` $webhook_url = 'https://your_server_path'; // адрес Webhook-сервера $certificate = '/home/user/ssl/my_ssl'; // путь к персональному сертификату (необязательный параметр) $ip_address = '000.000.000.000'; // IP-адрес , который будет использоваться для отправки запросов Webhook вместо IP-адреса, полученного через DNS (необязательный параметр) $max_connections = 40; // максимальное количество одновременных подключений к Webhook-серверу [1-100] (необязательный параметр) $telegram->setWebhook ($webhook_url, $certificate, $ip_address, $max_connections); ``` --- Удаление сервера Webhook ------------------------ [](#удаление-сервера-webhook) ``` $telegram->deleteWebhook(); ``` --- Получение информации о сервере Webhook -------------------------------------- [](#получение-информации-о-сервере-webhook) ``` $info = $telegram->getWebhookInfo(); ``` --- Установка идентификатора получателя ----------------------------------- [](#установка-идентификатора-получателя) ``` $telegram->setChatID("000000000"); ``` --- Включение отладки ----------------- [](#включение-отладки) ``` $telegram->setDebug(true); ``` Если включен, то логируются все действия, в противном случае - только конечный результат. --- Получение логов --------------- [](#получение-логов) ``` $telegram->getLogs(); ``` Возвращается массив действий и ошибок, и имя файла логов --- Пример отправки сообщения ------------------------- [](#пример-отправки-сообщения) ``` $token = "000000000:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // токен Телеграм бота $chat_id = 000000000; // ID чата получателя $telegram->setMethod('sendMessage'); $telegram->setToken($token); $telegram->setChatID($chat_id); if (!$answer = $telegram->sendToTelegram($message)) Base::dump($telegram->getLogs()); else Base::dump($answer); ``` или отправка сообщения с использованием параметров по умолчанию ``` $message = "Hi!"; if (!$answer = $telegram->sendToTelegram($message)) Base::dump($telegram->getLogs()); else Base::dump($answer); ``` --- Пример отправки фотографии -------------------------- [](#пример-отправки-фотографии) ``` $token = "000000000:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // токен Телеграм бота $chat_id = 000000000; // ID чата получателя $reply_message_id = 0000; // ID сообщения на которое даём ответ, по умолчанию - 0; $caption = "It's my photo!"; $path_to_photo = "/home/images/my.jpeg"; $telegram->setDebug(true); $telegram->setToken($token); $telegram->setChatID($chat_id); $telegram->setMethod('sendPhoto'); if (!$answer = $telegram->sendToTelegram($caption, $path_to_photo, $reply_message_id)) Base::dump($telegram->getLogs()); else Base::dump($answer); ``` отправка документа пользователю ``` $chat_id = 111111111; // ID чата получателя $caption = "It's my photo!"; $path_to_photo = "/home/images/my.jpeg"; $telegram->setMethod('sendPhoto'); if (!$answer = $telegram->sendToTelegram($caption, $path_to_photo, 0, $chat_id)) Base::dump($telegram->getLogs()); else Base::dump($answer); ``` или отправка фотографии с использованием параметров по умолчанию ``` $caption = "It's my photo!"; $path_to_photo = "/home/images/my.jpeg"; $telegram->setMethod('sendPhoto'); if (!$answer = $telegram->sendToTelegram($caption, $path_to_photo)) Base::dump($telegram->getLogs()); else Base::dump($answer); ``` ### Health Score 45 — FairBetter than 91% of packages Maintenance96 Actively maintained with recent releases Popularity13 Limited adoption so far Community7 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~180 days Recently: every ~449 days Total 11 Last Release 19d ago Major Versions v1.1.0 → v2.0.02021-08-25 v2.2.2 → v3.0.02026-07-29 PHP version history (2 changes)v1.0.0PHP >=5.1.0 v2.1.0PHP >=5.5.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/57900903?v=4)[Toropyga](/maintainers/Toropyga)[@Toropyga](https://github.com/Toropyga) --- Top Contributors [![Toropyga](https://avatars.githubusercontent.com/u/57900903?v=4)](https://github.com/Toropyga "Toropyga (23 commits)") ### Embed Badge ![Health badge](/badges/toropyga-telegram/health.svg) ``` [![Health](https://phpackages.com/badges/toropyga-telegram/health.svg)](https://phpackages.com/packages/toropyga-telegram) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35816.5M7](/packages/exsyst-swagger)[lucasdotvin/laravel-soulbscription A straightforward interface to handle subscriptions and features consumption. 709209.3k](/packages/lucasdotvin-laravel-soulbscription)[pimax/fb-messenger-php Facebook Messenger Bot PHP API 313188.5k2](/packages/pimax-fb-messenger-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)