[PHP] Создание простого Telegram-бота на простой библиотеке.

Статьи / PHP

Здравствуйте, жители KotOFF.NET!
Как-то меня заинтересовала тема ботов на Телеграм и я удивился, насколько это можно просто сделать даже тому, кто мало разбирается в PHP. Соответственно, я принялся за это дело и готов поделится с вами этой вещью, чтобы вы точно знали, как такое делается.

Создание бота у BotFather.
Исток истоков — это регистрация бота у BotFather.
Ничего страшного нет. Просто следуйте простой инструкции.

1. Начинаем диалог с t.me/botfather.

2. Пишем /newbot, а следом имя боту.

3. Пишем айди боту. Заметьте, он должен обязательно оканчиваться на bot.

Всё. Регистрация окончена!
По желанию можно добавить аватарку боту через /setuserpic, описание через /setdescription или/и краткое «О боте» через /setabouttext. Совершенно сложного тут нет, поддерживается кириллица, кстати, как и у имени бота.

Главное «но» при создании бота на Телеграм.
Читаешь себе документацию, всё тебе ясно, пытаешься сам вебхук установить и видишь, что вебхуки-то проходят лишь с SSL-сертификатами! Что делать-то? Без паники. Тут есть два пути, или даже больше решению этого вопроса.
Можно взять да просто платить за хостинг, а к любому современному хостингу сейчас идёт SSL-сертификат. Но платить не хочется, верно?
Тогда можно подключиться к CloudFlare, если получится, однако я вам дам спойлер: мало где это получится. Так что и этот вариант не наш.
Значит, надо искать бесплатные хостинги с SSL, и таких я знаю два: darkhost.pro и 000webhost.com. Последний вариант я терпеть не могу — медленный, что жуть, хотя SSL есть, и домен тоже бесплатный… Но из-за медленности второго варианта буду использовать первый. И нет, это не реклама — я никак не управляю ни тем, ни тем хостом. 

Настройка хостинга, его получение.
Делается всё элементарно и просто. Выполняйте понятную инструкцию, ничего не пропуская, желательно, и всё будет отлично.


1. Заходим на darkhost.pro, регистрируем себе аккаунт и подтверждаем его через подтверждение e-mail. Данные можно указывать не свои, но старайтесь вводить их похожими на правду, ладно? Чтобы вопросов никаких не было уже тут.


2. После регистрации и входа в кабинет личный, нажимаем на «Услуги"->«Заказать новую услугу», а на появившейся странице заказываем тариф «Light-MINI».

3. Выбираем «субдомен darkhost.pro» и вводим в свободное поле что угодно на латинице, после чего на следующей странцие просто жмём «Оформить», а далее уж жмём «Завершить заказ».
После этого вам на почту придут данные для входа в панель управления и FTP-сервер.
4. Нажимаем на «Услуги» и выбираем «Продукты/услуги». Там ищем свой сайт, что вы только что создали и нажимаете по нему. На открывшейся странице выбираем «Вход в панель управления» и ждём, пока нас перекинет и авторизирует в ISPmanager-е.

5. Слева есть панель. Там выбираем «SSL-сертификаты». В открывшейся странице нажимаем «Let’s Encrypt» и просто нажимаем далее. 

6. Пока ставится сертификат Let’s Encrypt, который работает, кстати, три месяца, настроим PHP. Просто заходим в «WWW-домены», находим свой сайт там, двойным кликом открываем его (или нажимаем на «Изменить») и выбираем версию PHP, промотав ниже. Желательно ставить PHP или 7.0, или выше.
Если сайт ваш выдаёт ошибку после того, как поменяли версию PHP — подождите. Заработает само.

Вот и всё. Мы настроили хостинг для работы с ним.

А теперь как бота написать-то?!
Всё просто. Скачайте архив и просто перекиньте через FTP или на через ISPmanager файлы на ваш хостинг.
telelibon-master.zip
Нам же там надо файлик "tgLib.php" и именно его вкладывать в ваш основной файл бота.
А вот как загружать файлы через ISPmanager:
(1 — перейти в Менеджер файлов; 2 — пройти по этому пути (последняя папка будет вашим доменом); 3 — нажать на закачать (далее надо будет просто выбрать файлы. также можно сделать папку через «Создать», если вам надо))

Разбор самого кода главного файла: bot.php.

<?
include 'tgLib.php'; //загружаем библиотеку

const TOKEN = 'ТУТ ВАШ ТОКЕН';
$bot = new tgBot(TOKEN);
$data = json_decode(file_get_contents('php://input'),true);

//переменные, что тут надо будут, ладно?
$text = $data['message']['text'];
$chat = $data['message']['chat']['id'];
$id = $data['message']['from']['id'];
$first_name = $data['message']['from']['first_name'];
$reply_author = $data['message']['reply_to_message']['from']['id'];
$reply_message_id = $data['message']['reply_to_message']['message_id'];

//чтобы мощность зря не тратилась
if ($text){
    if (strtolower($text) == "/start") $bot->reply($chat, "*Привет.* Я - обычный бот Телеграма. Можешь посмотреть команды, нажав на кнопку ''рамка со слэшем в центре''."); //reply - это просто отсылка сообщения
    if (strtolower(mb_substr($text,0,5)) == "/kick") {
        if ($reply_author){
            $bot->kick($chat,$reply_author); //kick тут работает именно так, да. если что, он выдаст ошибку и закончит скрипт.
            $bot->reply($chat,"[Предатель](tg://user?id={$reply_author}) выгнан, [{$first_name}](tg://user?id={$id})."); // [{$first_name}](tg://user?id={$id}) есть упоминание того, кто выполнил команду.
        } else { //получить айди пользователя сложно, так что работаем с ответом на сообщение. 
            $bot->reply($chat, "Ответь на сообщение предателя этой команды и выгони его.");
        }
    }
    if(strtolower($text) == "/picture") $bot->pictureReply($chat,"Держи *картин очку*, [{$first_name}](tg://user?id={$id}).", "http://pm1.narvii.com/7360/5109a4d976422ebdcdbfa23563d6b37a10a27966r1-736-1104v2_hq.jpg"); //а так отправляются картинки. url можно свой, но и file_id, кстати, не отменяли. если что, отпишитесь, как оно.
    if(strtolower($text) == "/video") $bot->videoReply($chat,"Держи *видяшку*, [{$first_name}](tg://user?id={$id}).", "http://f0329289.xsph.ru/tg/videoplayback.mp4"); //такой же принцип как и с фото, только видео.
    if(strtolower($text) == "/gif") $bot->gifReply($chat,"Держи *гифку*, [{$first_name}](tg://user?id={$id}).", "https://media.giphy.com/media/ifAxq0ON2i5fcjeOdR/giphy.gif"); //аналогично...
    if(strtolower($text) == "/audio") $bot->audioReply($chat,"Держи *песенку*, [{$first_name}](tg://user?id={$id}).",  "https://mp3star.ru/mp3/Ly9tb29zaWMubXkubWFpbC5ydS9maWxlLzA0YjQ5NDBiNzg5ZDRmNjVhMzVkM2MwMDE5NjU2ZGUyLm1wMw==/МАЛЬЧУГЕНГ%20-%20Том%20и%20Джерри.mp3"); //аналогично.. кстати, так только mp3 читаются
    if(strtolower($text) == "/voice") $bot->voiceReply($chat,"Держи *голосовуху*, [{$first_name}](tg://user?id={$id}).", "http://f0329289.xsph.ru/tg/МАЛЬЧУГЕНГ+-+ТУДА-СЮДА.ogg"); //это отсылка аудиосообщений. у меня не сработало, хотя всё верно, НО ЧТОБЫ ЗАРАБОТАЛО НУЖЕН .ogg В КОДЕКЕ OPUS И ТОЛЬКО!!!! 
    if(strtolower($text) == "/videonote") $bot->videoNoteReply($chat, "https://cs564500.vkuservideo.net/8/e03PD46MT80MTU-/videos/a000a322a2.360.mp4"); //это отсылка видеосообщений. так должно работать, но на время написания это пока не поддерживается. однако заработает file_id ;)
    if(strtolower(mb_substr($text,0,9)) == "/newtitle") {
        $bot->setChatTitle($chat,mb_substr($text,10)); //эта команда меняет название чата
        $bot->reply($chat,"*Имя чата поменялось.* Всё же верно, [{$first_name}](tg://user?id={$id})?");
    }
    if(strtolower($text) == "/invitelink" or strtolower($text) == "/chatlink") $bot->reply($chat,"*Ссылка на эту беседу:* {$bot->chatInviteLink($chat)['result']}"); //chatInviteLink даёт ссылку на беседу. зачем ['result']? мне лень исправлять там кое-что в библиотеке, но зато вы можете.
    if(strtolower($text) == "/pin") {
        if (!$reply_message_id) die($bot->reply($chat,"Ответьте на сообщение, что хотите закрепить, этой командой и оно будет закреплено.")); //это вам не вк, где боты не могут получить айди сообщений любых в беседах!
        $bot->pinMessage($chat,$reply_message_id); //прикрепление сообщений. ноу-хао будто
        $bot->reply($chat,"Сообщение успешно закреплено, [{$first_name}](tg://user?id={$id}).");
    }
    if(strtolower($text) == "/unpin") { 
        $bot->unpinMessage($chat); //ну открепление поняятно, даа
        $bot->reply($chat,"Всё, что было закреплено, я открепил, [{$first_name}](tg://user?id={$id}).");
    }
    if(strtolower(mb_substr($text,0,8)) == "/tempban") { 
        if ($reply_author){
            $tempban = $bot->tempban($chat,$reply_author,mb_substr($text,9));
            die($bot->reply($chat,"[Предатель](tg://user?id={$reply_author}) выгнан на {$bot->toUnix(mb_substr($text,9))} секунд, [{$first_name}](tg://user?id={$id}). Если он выгнан на <30 или >31622400 секунд, то он навеки выгнан.")); //toUnix конвертирует время типа 1m, 3w, 3y в unix-время. секунд нет, они сломались :) кстати, а вы знали, что в телеграме уже есть поддержка времени бана заранее? :D и да, это возможно не работает пока что.
        } else {
            die($bot->reply($chat, "Ответь на сообщение предателя этой команды и выгони его.")); //команда по итогу прст должна выглядеть так: /tempban 1m [ответ на сообщение]. и да, я использую die, чтобы сразу завершался скрипт. вы можете это не делать.
        }
    }
} 

А как вообще прикрепить вебхук-то к боту? Ты нам не сказал!
Да, я дико извиняюсь, что это пишу под конец, конечно, поста, но я просто хотел сперва показать, как это всё делается, чтобы вы определились, надо ли вам это.
А так, просто выполните запрос какой-то такой:

https://api.telegram.org/bot<ТОКЕН ВАШ>/setWebhook?url=https://<ССЫЛКА НА ФАЙЛ bot.php ИЛИ ДРУГОЙ, ГДЕ КОД БОТА САМ>

Удачного денька.
Пост подходит к концу. Если что — задавайте вопросы. Отвечу на них по возможности.
P. S. Если ответа нет довольно долго, значит либо не заметил, либо нет времени, но вероятен сценарий банальности ошибки вашей или вопроса.

Архив с библиотекой и исходным кодом:
telelibon-master.zip