onText
Метод onText
создает маршрут, который срабатывает при точном совпадении текста входящего сообщения. Сравнение чувствительно к регистру.
Этот метод идеально подходит для обработки нажатий на кнопки стандартной (reply) клавиатуры или для простых текстовых команд.
Параметры
# | Название | Тип | Описание |
---|---|---|---|
1 | id | string | Уникальный идентификатор для этого маршрута. |
2 | text | string |array | Текст или массив текстов, на которые должен реагировать маршрут. Если не указан, используется id . |
Возвращает
Action
— экземпляр класса Action
(Вспомогательный класс), на который можно навешивать дальнейшие действия (text
, func
и т.д.).
Пример использования
php
<?php
require_once __DIR__ . 'vendor/autoload.php';
use ZhenyaGR\TGZ\TGZ;
use ZhenyaGR\TGZ\Bot;
$tg = TGZ::create('ТОКЕН');
$bot = new Bot($tg);
// Создаем кнопки для стандартной клавиатуры
$bot->btn('btn_price', 'Узнать цену');
$bot->btn('btn_contacts', 'Контакты');
// По команде /start отправляем клавиатуру
$bot->onBotCommand('start', '/start')
->text('Выберите один из пунктов:')
->kbd([['btn_price', 'btn_contacts']]);
// Обрабатываем нажатие на кнопку "Узнать цену"
// Нажатие на эту кнопку пришлет сообщение с текстом "Узнать цену"
$bot->onText('handle_price', 'Узнать цену')
->text('Цена составляет 1000 рублей.');
// Обрабатываем нажатие на кнопку "Контакты"
$bot->onText('handle_contacts', 'Контакты')
->text('Наш адрес: ...');
// Также можно обрабатывать несколько вариантов текста одним маршрутом
$bot->onText('handle_greetings', ['Привет', 'Здравствуйте', 'Добрый день'])
->text('И вам не хворать!');
$bot->run();