Обновлённая версия класса TelegramMessage: добавлен метод sendWithButtons() с inline-кнопками, код переписан под PHP 8 с именованными аргументами и типами.

Что умеет класс:

  • рассылать одно сообщение списку получателей — пользователям, группам или каналам;
  • вычищать из текста HTML-теги, которые не поддерживает Telegram (оставляет a, b, i, code, pre);
  • прикреплять inline-клавиатуру из кнопок-ссылок;
  • выводить ответ API, если отправка конкретному получателю не удалась.

§Код

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
<?php
class TelegramMessage
{
	private $recipients;
	private $token;
	private $parseMode;

	public function __construct($parse_mode = 'HTML')
	{
		$this->parseMode = $parse_mode;
		$this->token = '';
		$this->recipients = [];
	}

	public function setToken($token): void
	{
		$this->token = $token;
	}

	public function setRecipients($list = []): void
	{
		$this->recipients = $list;
	}

	public function send($message): void
	{
		if (!count(value: $this->recipients)) {
			exit('Список получателей пуст');
		}

		if (!strlen(string: $this->token)) {
			exit('Токен не задан');
		}

		$message = $this->filterMessage(message: $message);
		$this->sendMessageToRecipients(message: $message);
	}

	public function sendWithButtons($message, $buttons): void
	{
		if (!count(value: $this->recipients)) {
			exit('Список получателей пуст');
		}

		if (!strlen(string: $this->token)) {
			exit('Токен не задан');
		}

		$message = $this->filterMessage(message: $message);

		$keyboard = array("inline_keyboard" => $buttons);
		$replyMarkup = json_encode(value: $keyboard);

		$this->sendMessageToRecipients(message: $message, replyMarkup: $replyMarkup);
	}

	private function filterMessage($message): string
	{
		// Фильтрация тегов
		preg_match_all(pattern: '/<.+?[\s]*\/?[\s]*>/si', subject: $message, matches: $tags);
		$tags = array_unique(array: $tags[0]);

		$allowed_tags = [
			'<a\s.*?>',
			'<\/a>',
			'<b>',
			'<b\s.*?>',
			'<\/b>',
			'<i>',
			'<i\s.*?>',
			'<\/i>',
			'<code>',
			'<code\s.*?>',
			'<\/code>',
			'<pre>',
			'<pre\s.*?>',
			'<\/pre>',
		];

		foreach ($tags as $tag) {
			$find_tag = false;
			foreach ($allowed_tags as $allowed_tag) {
				if (preg_match(pattern: '/' . $allowed_tag . '/', subject: $tag)) {
					$find_tag = true;
					break;
				}
			}
			if (!$find_tag) {
				$message = preg_replace(
					pattern: '/' . addcslashes(string: $tag, characters: '/[]().+?') . '/',
					replacement: '',
					subject: $message
				);
			}
		}

		return urlencode(string: $message);
	}

	private function sendMessageToRecipients($message, $replyMarkup = null): void
	{
		$token = $this->token;
		$parse_mode = $this->parseMode;

		foreach ($this->recipients as $id) {
			$url = "https://api.telegram.org/bot{$token}/sendMessage?chat_id={$id}&parse_mode={$parse_mode}&text={$message}";
			
			if ($replyMarkup) {
				$url .= "&reply_markup=" . urlencode(string: $replyMarkup);
			}

			$ch = curl_init();
			curl_setopt_array(handle: $ch, options: [
				CURLOPT_URL => $url,
				CURLOPT_RETURNTRANSFER => true
			]);
			$response = curl_exec(handle: $ch);
			$response = json_decode(json: $response);

			if (!$response->ok) {
				echo json_encode(value: [
					'target_id' => $id,
					'response' => $response,
					'message' => urldecode(string: $message),
				]);
			}

			curl_close(handle: $ch);
		}
	}
}

§Пример использования

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
$telegram = new TelegramMessage();
$telegram->setToken('your_telegram_bot_token');
$telegram->setRecipients(['recipient_chat_id']);

// Создаем кнопки
$buttons = [
    [
        ["text" => "Google", "url" => "https://www.google.com"],
        ["text" => "YouTube", "url" => "https://www.youtube.com"]
    ]
];

// Отправляем сообщение с кнопками
$telegram->sendWithButtons("Here are some useful links:", $buttons);

$buttons — это массив строк клавиатуры, каждая строка — массив кнопок. Две кнопки в одном вложенном массиве встанут в ряд.

§Где взять токен и chat_id

  • Токен выдаёт @BotFather при создании бота.
  • chat_id пользователя можно узнать, написав боту и открыв https://api.telegram.org/bot<TOKEN>/getUpdates. Для публичного канала вместо ID подойдёт @username, но бот должен быть администратором канала.

Не храните токен в коде, который попадает в репозиторий, — выносите его в конфиг или переменные окружения.