Telegram Bot на PHP - Полный Список Команд и Примеры Использования

Создайте Telegram-бота на PHP с помощью библиотеки Telegram Bot API. Установите её через Composer, выполнив команду composer require telegram-bot/api. Это позволит быстро начать работу с API Telegram и упростит процесс разработки.

Для обработки входящих сообщений используйте метод getUpdates или настройте вебхук. Вебхук предпочтителен для проектов с высокой нагрузкой, так как он обеспечивает мгновенную обработку запросов. Укажите URL вашего сервера в настройках бота через метод setWebhook.

Добавьте команды, которые будут реагировать на действия пользователей. Например, команда /start может отправлять приветственное сообщение. Используйте метод sendMessage для отправки текста. Чтобы сделать бота интерактивным, добавьте кнопки с помощью InlineKeyboardMarkup или ReplyKeyboardMarkup.

Обрабатывайте входящие данные с помощью getMessage и getCallbackQuery. Это позволит боту реагировать на текстовые сообщения и нажатия на кнопки. Например, можно создать команду /weather, которая будет запрашивать город у пользователя и возвращать текущую погоду.

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

Тестируйте бота в различных сценариях, чтобы убедиться в его стабильности. Используйте метод getMe для проверки корректной работы API. Опубликуйте бота в Telegram, чтобы пользователи могли начать с ним взаимодействовать.

Настройка окружения для создания Telegram Bot на PHP

Установите PHP версии 7.4 или выше. Проверьте текущую версию командой php -v. Если PHP отсутствует, установите его через пакетный менеджер вашей операционной системы:

Для Ubuntu/Debian: sudo apt install php
Для CentOS/Fedora: sudo yum install php
Для Windows: скачайте установщик с официального сайта.

Убедитесь, что установлены необходимые расширения PHP:

curl для работы с HTTP-запросами.
json для обработки данных в формате JSON.

Проверьте их наличие командой php -m. Если расширения отсутствуют, установите их через пакетный менеджер.

Создайте каталог для вашего проекта и инициализируйте его как репозиторий Composer:

Создайте папку: mkdir telegram-bot.
Перейдите в неё: cd telegram-bot.
Запустите команду: composer init и следуйте инструкциям.

Установите библиотеку для работы с Telegram Bot API. Используйте telegram-bot/api через Composer:

composer require telegram-bot/api

Создайте файл .env для хранения токена вашего бота. Добавьте в него строку:

TELEGRAM_BOT_TOKEN=ваш_токен

Используйте библиотеку vlucas/phpdotenv для работы с переменными окружения:

composer require vlucas/phpdotenv

Настройте веб-сервер для обработки запросов. Если используете Apache, создайте файл .htaccess с содержимым:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ index.php [L]

Для Nginx добавьте в конфигурацию сервера:

location / {
try_files $uri $uri/ /index.php?$query_string;
}

Проверьте работоспособность окружения, создав файл index.php с простым кодом:

<?php
require 'vendor/autoload.php';
echo "Окружение настроено!";

Откройте файл в браузере, чтобы убедиться, что всё работает корректно.

Выбор хостинга и установка PHP

Для запуска Telegram-бота на PHP выберите хостинг с поддержкой PHP 7.4 и выше. Хорошим вариантом станут VPS-серверы от TimeWeb, Reg.ru или Beget. Они предоставляют стабильную работу, удобную панель управления и быструю техническую поддержку.

Если бюджет ограничен, обратите внимание на бесплатные хостинги, такие как InfinityFree или 000webhost. Они подойдут для тестирования и небольших проектов, но могут иметь ограничения по производительности и времени работы.

После выбора хостинга установите PHP, если он не предустановлен. На VPS-серверах используйте команду sudo apt-get install php для Linux-систем. Убедитесь, что установлена последняя версия PHP, чтобы избежать проблем с совместимостью. Для проверки версии выполните команду php -v.

Настройте PHP для работы с вашим ботом. Откройте файл php.ini и включите необходимые расширения, такие как curl и json. Это позволит вашему боту взаимодействовать с Telegram API и обрабатывать данные.

Для упрощения управления проектом установите Composer. Запустите команду php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" и следуйте инструкциям. Composer поможет установить библиотеки, необходимые для работы бота.

После завершения настройки загрузите файлы бота на сервер через FTP или SSH. Проверьте доступность бота, открыв его URL в браузере или отправив команду через Telegram.

Создание и получение токена бота

Перейдите в Telegram и найдите BotFather – официального бота для создания и управления ботами. Начните диалог с командой /start, затем используйте /newbot, чтобы создать нового бота.

Укажите имя бота, которое будет отображаться в чатах, и его уникальное имя пользователя. Имя пользователя должно заканчиваться на bot, например, my_example_bot. После успешного создания BotFather предоставит вам токен – уникальный ключ для доступа к API Telegram.

Сохраните токен в надежном месте, так как он потребуется для настройки и работы вашего бота. Токен выглядит как строка символов, например: 123456789:ABCdefGhIJKlmNoPQRstuVWXyz.

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

Теперь, когда токен получен, вы можете приступить к разработке бота, используя библиотеки для PHP, такие как Telegram Bot API или LongmanTelegramBot.

Обзор библиотеки для работы с Telegram API

Для создания Telegram-бота на PHP используйте библиотеку TelegramBotPHP. Она предоставляет простой интерфейс для взаимодействия с Telegram API, поддерживает все основные методы и позволяет быстро интегрировать бота в ваш проект.

Установите библиотеку через Composer, выполнив команду:

composer require telegram-bot/api

После установки настройте бота, указав токен, полученный от BotFather. Пример инициализации:

$telegram = new TelegramBotApiBotApi('YOUR_BOT_TOKEN');

Библиота предлагает широкий функционал, включая отправку сообщений, обработку команд и работу с inline-клавиатурами. Например, для отправки текстового сообщения используйте:

$telegram->sendMessage($chatId, 'Привет, это ваш бот!');

Для обработки входящих сообщений и команд подключите вебхук или используйте метод getUpdates. Пример обработки команды /start:

$update = $telegram->getWebhookUpdate();
if ($update->getMessage()->getText() == '/start') {
$telegram->sendMessage($chatId, 'Добро пожаловать!');
}

Библиота также поддерживает работу с медиафайлами. Вы можете отправлять фото, аудио, видео и документы. Пример отправки фото:

$telegram->sendPhoto($chatId, new CURLFile('path/to/photo.jpg'));

Сравним основные возможности библиотеки:

Функция	Описание
sendMessage	Отправка текстового сообщения
sendPhoto	Отправка изображения
getWebhookUpdate	Получение данных через вебхук
setWebhook	Настройка вебхука

Библиота активно поддерживается разработчиками, регулярно обновляется и имеет подробную документацию. Это делает её удобным инструментом для создания ботов любой сложности.

Основные команды и их применение в Telegram Bot

Для начала работы с Telegram Bot на PHP, создайте команду /start. Она запускает бота и отправляет приветственное сообщение. Это помогает пользователю понять, как взаимодействовать с ботом.

/help – отправляет список доступных команд и их описание. Это упрощает навигацию для пользователя.
/settings – позволяет настроить параметры бота, например, язык или уведомления.
/info – предоставляет информацию о боте, его версии или функционале.

Для обработки текстовых сообщений используйте метод getMessage(). Это позволяет боту реагировать на ввод пользователя. Например, если пользователь отправляет текст, бот может анализировать его и выдавать соответствующий ответ.

Создайте команду /weather, чтобы бот мог отправлять текущую погоду. Используйте API погодных сервисов для получения данных.
Добавьте команду /reminder для создания напоминаний. Сохраняйте данные в базу и отправляйте уведомления в указанное время.
Реализуйте команду /search для поиска информации. Например, бот может искать товары в каталоге или статьи в базе данных.

Для работы с кнопками используйте метод sendMessage с параметром reply_markup. Это позволяет создавать интерактивные меню. Например, кнопки «Да» и «Нет» для подтверждения действия.

Кнопка InlineKeyboardButton – отправляет запрос без изменения текущего сообщения.
Кнопка ReplyKeyboardMarkup – добавляет клавиатуру под полем ввода.

Для обработки ошибок используйте команду /error. Она отправляет сообщение с описанием проблемы и предлагает решение. Это улучшает пользовательский опыт.

Регулярно обновляйте команды и добавляйте новые функции. Это делает бота более полезным и актуальным для пользователей.

Обработка текстовых сообщений

Для обработки текстовых сообщений в Telegram-боте на PHP используйте метод getMessage() объекта Update. Это позволяет получить текст, отправленный пользователем. Например:

$message = $update->getMessage();
$text = $message->getText();

Чтобы реагировать на конкретные команды или слова, примените условные конструкции. Например, если пользователь отправил «Привет», бот может ответить «Здравствуйте!»:

if ($text === 'Привет') {
$chatId = $message->getChat()->getId();
sendMessage($chatId, 'Здравствуйте!');
}

Для обработки более сложных запросов, таких как поиск или фильтрация, используйте регулярные выражения. Например, чтобы извлечь номер телефона из текста:

if (preg_match('/+7d{10}/', $text, $matches)) {
$phone = $matches[0];
sendMessage($chatId, "Ваш номер телефона: $phone");
}

Если нужно обрабатывать длинные тексты, разбейте их на части или используйте машинное обучение для анализа. Например, для определения настроения сообщения можно подключить библиотеку для анализа тональности текста.

Не забывайте о безопасности: очищайте входящие данные с помощью функций htmlspecialchars() или strip_tags(), чтобы избежать XSS-атак.

Для удобства пользователей добавьте подсказки или автодополнение команд. Это можно реализовать через метод setMyCommands() Telegram API, чтобы бот предлагал доступные команды при вводе.

Настройка кнопок и взаимодействие с пользователями

Используйте метод sendMessage с параметром reply_markup для создания кнопок. Например, для отправки клавиатуры с двумя кнопками:


$keyboard = [
['Кнопка 1', 'Кнопка 2'],
['Кнопка 3']
];
$replyMarkup = json_encode(['keyboard' => $keyboard, 'resize_keyboard' => true]);
$chatId = 123456789;
$message = "Выберите действие:";
file_get_contents("https://api.telegram.org/bot{TOKEN}/sendMessage?chat_id=$chatId&text=$message&reply_markup=$replyMarkup");

Для создания inline-кнопок, которые не скрывают клавиатуру, используйте параметр inline_keyboard:


$inlineKeyboard = [
[['text' => 'Действие 1', 'callback_data' => 'action1']],
[['text' => 'Действие 2', 'callback_data' => 'action2']]
];
$replyMarkup = json_encode(['inline_keyboard' => $inlineKeyboard]);
file_get_contents("https://api.telegram.org/bot{TOKEN}/sendMessage?chat_id=$chatId&text=$message&reply_markup=$replyMarkup");

Обрабатывайте нажатия inline-кнопок через метод callback_query. Например:


$update = json_decode(file_get_contents('php://input'), true);
if (isset($update['callback_query'])) {
$callbackData = $update['callback_query']['data'];
$chatId = $update['callback_query']['message']['chat']['id'];
$messageId = $update['callback_query']['message']['message_id'];
if ($callbackData === 'action1') {
$response = "Вы выбрали Действие 1";
} elseif ($callbackData === 'action2') {
$response = "Вы выбрали Действие 2";
}
file_get_contents("https://api.telegram.org/bot{TOKEN}/sendMessage?chat_id=$chatId&text=$response");
}

Добавляйте подсказки к кнопкам с помощью параметра switch_inline_query_current_chat или url для перенаправления на внешние ресурсы. Например:


$inlineKeyboard = [
[['text' => 'Поиск', 'switch_inline_query_current_chat' => 'запрос']],
[['text' => 'Сайт', 'url' => 'https://example.com']]
];

Регулярно тестируйте кнопки, чтобы убедиться, что они работают корректно. Убедитесь, что текст на кнопках понятен, а их расположение логично. Это улучшит взаимодействие с пользователями и повысит удобство использования бота.

Отправка медиафайлов и документов

Для отправки медиафайлов и документов через Telegram Bot на PHP используйте метод sendPhoto, sendAudio, sendDocument или sendVideo. Укажите путь к файлу или его URL в параметре file или url. Например, чтобы отправить фото, вызовите:

$bot->sendPhoto([
'chat_id' => $chat_id,
'photo' => 'path/to/photo.jpg',
]);

Если файл хранится в интернете, используйте его URL:

$bot->sendDocument([
'chat_id' => $chat_id,
'document' => 'https://example.com/file.pdf',
]);

Для загрузки файлов с локального сервера воспользуйтесь классом CURLFile. Убедитесь, что файл доступен для чтения:

$file = new CURLFile('path/to/file.pdf');
$bot->sendDocument([
'chat_id' => $chat_id,
'document' => $file,
]);

Методы поддерживают дополнительные параметры, такие как подпись к файлу или настройка превью. Например, добавьте описание к фото:

$bot->sendPhoto([
'chat_id' => $chat_id,
'photo' => 'path/to/photo.jpg',
'caption' => 'Это пример фото',
]);

В таблице ниже приведены основные методы для отправки медиафайлов:

Метод	Тип файла	Пример
`sendPhoto`	Фото	`$bot->sendPhoto(['chat_id' => $chat_id, 'photo' => 'photo.jpg']);`
`sendAudio`	Аудио	`$bot->sendAudio(['chat_id' => $chat_id, 'audio' => 'audio.mp3']);`
`sendDocument`	Документ	`$bot->sendDocument(['chat_id' => $chat_id, 'document' => 'file.pdf']);`
`sendVideo`	Видео	`$bot->sendVideo(['chat_id' => $chat_id, 'video' => 'video.mp4']);`

Проверяйте размер файлов перед отправкой. Telegram ограничивает размер фото до 10 МБ, видео – до 50 МБ, а документов – до 200 МБ. Если файл превышает лимит, используйте сторонние сервисы для хранения и отправляйте ссылку.

Создание команд для быстрого доступа к функциям бота

Создайте команды для выполнения часто используемых действий. Например, /weather может возвращать текущую погоду, а /reminder – устанавливать напоминания. Убедитесь, что каждая команда выполняет одну конкретную задачу, чтобы избежать путаницы.

Используйте параметры для расширения функциональности команд. Например, команда /translate может принимать текст для перевода: /translate Привет. Это позволяет пользователям быстро получать нужные результаты без дополнительных шагов.

Организуйте команды в логические группы. Например, команды для работы с финансами (/balance, /expenses) можно объединить в один раздел. Это упрощает навигацию и делает бота более интуитивно понятным.

Добавьте подсказки для команд, чтобы пользователи могли видеть их описание при вводе. Например, при вводе /start отобразите текст «Начать работу с ботом». Это улучшает пользовательский опыт и помогает быстрее освоить функционал.

Тестируйте команды на разных устройствах и платформах, чтобы убедиться, что они работают корректно. Учитывайте ограничения Telegram, такие как максимальная длина команды (32 символа) и использование только латинских букв и цифр.