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. toropyga/telegram

ActiveLibrary

toropyga/telegram
=================

Libraries for working with Telegram bot from Toropyga

v2.2.0(4y ago)0128MITPHPPHP >=5.5.0

Since Aug 20Pushed 4y ago1 watchersCompare

[ Source](https://github.com/Toropyga/Telegram)[ Packagist](https://packagist.org/packages/toropyga/telegram)[ RSS](/packages/toropyga-telegram/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (2)Versions (9)Used By (0)

Telegram
========

[](#telegram)

Отправка сообщений от имени Телеграм бота

[![License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)[![Version](https://camo.githubusercontent.com/08897745b929c05efa725a6b7a04d2ecc58ef33397d87e6e8f8c4c308c0fa304/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d76322e322e302d626c75652e737667)](https://camo.githubusercontent.com/08897745b929c05efa725a6b7a04d2ecc58ef33397d87e6e8f8c4c308c0fa304/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d76322e322e302d626c75652e737667)[![PHP](https://camo.githubusercontent.com/f85e9a1e19d96dd19978f3b621237a876e188c358f8ed0908fea7d51eda1a225/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d76352e355f2d2d5f76382d626c756576696f6c65742e737667)](https://camo.githubusercontent.com/f85e9a1e19d96dd19978f3b621237a876e188c358f8ed0908fea7d51eda1a225/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d76352e355f2d2d5f76382d626c756576696f6c65742e737667)

Содержание
==========

[](#содержание)

- [Общие понятия](#%D0%BE%D0%B1%D1%89%D0%B8%D0%B5-%D0%BF%D0%BE%D0%BD%D1%8F%D1%82%D0%B8%D1%8F)
- [Установка](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0)
- [Настройка](#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0)
- [Описание работы](#%D0%BE%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B)
    - [Подключение файла класса](#%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0-%D0%BA%D0%BB%D0%B0%D1%81%D1%81%D0%B0)
    - [Инициализация класса](#%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D0%BA%D0%BB%D0%B0%D1%81%D1%81%D0%B0)
    - [Установка метода взаимодействия с API Телеграм](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D0%B0-%D0%B2%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D1%8F-%D1%81-API-%D0%A2%D0%B5%D0%BB%D0%B5%D0%B3%D1%80%D0%B0%D0%BC-%D0%BF%D1%80%D0%B8-%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B5-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D0%B9)
        - [Поддерживаемые методы](#%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)

Общие понятия
=============

[](#общие-понятия)

Класс Telegram предназначен для отправки сообщений от имени Телеграм бота.

Для работы необходимо наличие PHP версии 5.5 и выше, библиотеки PHP php-json и php-curl. Также используются дополниельные библиотеки [Base](https://github.com/Toropyga/Base) и [NetContent](https://github.com/Toropyga/NetContent)

Установка
=========

[](#установка)

Рекомендуемый способ установки библиотеки NetContent с использованием [Composer](http://getcomposer.org/):

```
composer require toropyga/telegram
```

Настройка
=========

[](#настройка)

Предварительная настройка параметров по умолчанию может осуществлятся или непосредственно в самом классе, или с помощью именованных констант. Именованные константы при необходимости обявляются до вызова класса, например, в конфигурационном файле, и определяют параметры по умолчанию.

- TELEGRAM\_TOKEN - [токен Телеграм бота](https://core.telegram.org/bots/api#authorizing-your-bot);
- TELEGRAM\_ID - [идентификатор чата](https://t.me/username_to_id_bot) (человека) которому посылаем сообщение
- TELEGRAM\_DEBUG - включение или отключение параметров отладки;
- TELEGRAM\_LOG\_NAME - имя файла логов;

Описание работы
===============

[](#описание-работы)

Подключение файла класса
------------------------

[](#подключение-файла-класса)

```
require_once("NetContent.php");
require_once("Base.php");
require_once("Telegram.php");
```

или с использованием composer

```
require_once("vendor/autoload.php");
```

---

Инициализация класса
--------------------

[](#инициализация-класса)

```
use \FYN\Base;
$net = new FYN\NetContent();
$telegram = new FYN\Telegram($net);
```

или с автоматическим подключением класса NetContent

```
use \FYN\Base;
$telegram = new FYN\Telegram();
```

---

Установка метода взаимодействия с API Телеграм при отправке сообщений
---------------------------------------------------------------------

[](#установка-метода-взаимодействия-с-api-телеграм-при-отправке-сообщений)

```
$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

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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 ~1 days

Total

8

Last Release

1723d ago

Major Versions

v1.1.0 → v2.0.02021-08-25

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 (18 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)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)