Подключение

Используя composer

1. Установить

composer require zhenyagr/tgz:dev-main

2. Подключить autoload.php

require_once '/vendor/autoload.php';

Вручную

Скачать последний релиз c github
Подключить autoload.php.

Вот так будет происходить подключение, если ваш бот находится в той же папке, что и папка TGZ

require_once "TGZ/autoload.php";

Первоначальная настройка, создание бота и получение токена

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

Инициализация переменных (WEBHOOK)

<?php
require 'TGZ/autoload.php';  // Подключаем библиотеку
use ZhenyaGR\TGZ\TGZ as tg;  // Используем основной класс

$tg = tg::create(BOT_TOKEN); // Создаем объект бота

$tg->initUserID($user_id)
    ->initChatID($chat_id)
    ->initText($text)
    ->initMsgID($msg_id)
    ->initType($type);
// Некоторые переменные можно инициализировать по отдельности

$tg->initVars($chat_id, $user_id, $text, $type, $callback_data, $query_id, $msg_id, $is_bot, $is_command);
// Все переменные сразу одним методом

Инициализация переменных (LONGPOLL)

<?php
require 'TGZ/autoload.php';  // Подключаем библиотеку
use ZhenyaGR\TGZ\LongPoll as tg;  // Используем класс LongPoll

$tg = tg::create(BOT_TOKEN, 10); 
// Создаем объект бота 
// Указываем задержку между запросами (По умолчанию 10 секунд)

$tg->listen(function() use ($tg) {
        
    $tg->initUserID($user_id)
        ->initChatID($chat_id)
        ->initText($text)
        ->initMsgID($msg_id)
        ->initType($type);
    // Некоторые переменные можно инициализировать по отдельности
    
    $tg->initVars($chat_id, $user_id, $text, $type, $callback_data, $query_id, $msg_id, $is_bot, $is_command);
    // Все переменные сразу одним методом
});

Вызов любых методов BOT API. Например copyMessage (WEBHOOK)

<?php
require 'TGZ/autoload.php';  
use ZhenyaGR\TGZ\TGZ as tg;  

$tg = tg::create(BOT_TOKEN); 
$tg->initVars($chat_id, $user_id, $text, $type, msg_id: $msg_id); 
// Инициализируем переменные

if ($type == 'text' || $type == 'bot_command') {
    $tg->copyMessage([
        'chat_id' => $chat_id, 
        'from_chat_id' => $chat_id,
        'message_id' => $msg_id
    ]); 
    // Используем метод телеграма, в который передаем 3 параметра:
    // chat_id, from_chat_id и message_id
}

Эхо-бот с конструктором сообщений (WEBHOOK)

<?php
require 'TGZ/autoload.php'; 
use ZhenyaGR\TGZ\TGZ as tg; 

$tg = tg::create(BOT_TOKEN);
$tg->initVars($chat_id, $user_id, $text, $type);

if ($type == 'text' || $type == 'bot_command') {
    $tg->msg($text)->send(); 
    // Отправляем сообщение с таким-же текстом
}

Вызов любых методов BOT API. Например copyMessage (LONGPOLL)

<?php
require 'TGZ/autoload.php';  
use ZhenyaGR\TGZ\LongPoll as tg;  // Меняем класс

$tg = tg::create(BOT_TOKEN); 

$tg->listen(function() use ($tg) {
    // Ждём новый update
    
    $tg->initVars($chat_id, $user_id, $text, $type, msg_id: $msg_id); 
    // Инициализируем переменные
    
    if ($type == 'text' || $type == 'bot_command') {
        $tg->copyMessage([
            'chat_id' => $chat_id, 
            'from_chat_id' => $chat_id,
            'message_id' => $msg_id,
        ]); 
        // Используем метод телеграма, в который передаем 3 параметра:
        // chat_id, from_chat и message_id
    }

});

Эхо-бот с конструктором сообщений (LONGPOLL)

<?php
require 'TGZ/autoload.php'; 
use ZhenyaGR\TGZ\LongPoll as tg; 

$tg = tg::create(BOT_TOKEN);

$tg->listen(function() use ($tg) {

    $tg->initVars($chat_id, $user_id, $text, $type);
    
    if ($type == 'text' || $type == 'bot_command') {
        $tg->msg($text)->send(); // Отправляем сообщение с таким-же текстом
    }
});

`Все остальные примеры будут показаны на Webhook`

Все доступные типы

<?php
require 'TGZ/autoload.php'; 
use ZhenyaGR\TGZ\TGZ as tg; 

$tg = tg::create(BOT_TOKEN);
$tg->initVars(type: $type);

if ($type == 'text') {
    // Текстовое сообщение    
} else if ($type == 'bot_command') {
    // Команда бота (/start, /help и т.д.)
} else if ($type == 'edited_message') {
    // Редактирование сообщения
} else if ($type == 'callback_query') {
    // Callback-запрос
} else if ($type == 'inline_query') {
    // Inline-запрос
}

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

<?php
require 'TGZ/autoload.php'; 
use ZhenyaGR\TGZ\TGZ as tg; 

$tg = tg::create(BOT_TOKEN);
$tg->initVars($chat_id, $user_id, $text, $type);

if ($type == 'text' || $type == 'bot_command') {
    switch ($text) {
    
        case '/fileid':
            $id = $tg->getFileID('file url', $chat_id, 'file type');
            // Получаем ID медиа-файла, загружая его на сервер телеграма
            $tg->msg($id)->send();
            // Этот File_id можно использовать для повторной отправки файла
            break;
    
        case '/img':
            $tg->msg()
                ->img('img.jpg') // Отправка Изображений
                ->send();
            break;
            
        case '/img_url':
            $tg->msg("Текст сообщения")
                ->urlImg($img_url)
                ->send();
            // Добавляет ссылку в текст сообщения, используя пробел нулевой ширины
            break;
            
        case '/gif':
            $tg->msg()
                ->gif('gif.gif') // Отправка Гиф
                ->send();
            break;
            
        case '/video':
            $tg->msg()
                ->video('video.mp4') // Отправка Видео
                ->send();
            break;
            
        case '/audio':
            $tg->msg()
                ->audio('audio.mp3') // Отправка Аудио
                ->send();
            break;
            
        case '/voice':
            $tg->msg()
                ->voice('voice.mp3') // Отправка Голосового сообщения
                ->send();
            break;
            
        case '/dice':
            $emoji = ["🎲", "🎯", "🏀", "⚽", "🎳", "🎰"];
            $tg->msg()
                ->dice($emoji[array_rand($emoji)]) // Отправка Интерактивного сообщения
                ->send();
            break;
            
        case '/doc':
            $tg->msg()
                ->doc('doc.txt') // Отправка Документа
                ->send();
            break;
            
        case '/sticker':
            $tg->msg()
                ->sticker('sticker_id')
                ->send(); // Отправка стикеров
            break;
            
        case '/combine':
            $tg->msg()
                ->img('img.jpg')
                ->video('video.mp4')
                ->send(); // Отправка нескольких файлов
            break;
    }
}

Отправка клавиатуры и Кнопок

<?php    
require 'TGZ/autoload.php'; 
use ZhenyaGR\TGZ\TGZ as tg; 

$tg = tg::create(BOT_TOKEN);
$tg->initVars($chat_id, $user_id, $text, $type, $callback_data, $query_id, $msg_id);

if ($type == 'text' || $type == 'bot_command') {
    switch ($text) {
        case '/inline':
            // Создаем массив с кнопками
            $kbd = [
                [   // Создаем callback-кнопки
                    $tg->buttonCallback('Кнопка 1', 'call1'),
                    $tg->buttonCallback('Кнопка 2', 'call2')
                ],
                [
                    $tg->buttonCallback('Кнопка-Редактирование', 'edit')
                ],
                [   // Создаем url-кнопку
                    $tg->buttonUrl('GitHub Библиотеки', "https://github.com/ZhenyaGR/TGZ")
                ]
            ];
            $tg->msg("Текст сообщения")
                ->kbd($kbd, inline: true)
                ->send();
            // Отправляем с параметром inline: true
            break;

        case '/keyboard':
            // Создаем массив с кнопками
            $kbd = [ // Создаем текстовые кнопки
                [$tg->buttonText('Текстовая кнопка')],
                [$tg->buttonText('Удалить клавиатуру')]
            ];
            $tg->msg("Текст сообщения")
                ->kbd($kbd, inline: false, resize_keyboard: true, one_time_keyboard: false)
                ->send();
            // Отправляем с параметрами inline: false, resize_keyboard: true, one_time_keyboard: false
            break;
            
        case 'Текстовая кнопка':
            // Приходит как обычное сообщение
            $tg->msg("Вы нажали текстовую кнопку")->send();        
            break;
            
        case 'Удалить клавиатуру':
            $tg->msg("Клавиатура удалена")
                ->kbd(remove_keyboard: true)
                ->send();
            // Удаляем клавиатуру
            break;
    }
} else if ($type == 'callback_query') {
    $tg->answerCallbackQuery($query_id, ['text' => "Вы нажали кнопку!"]);    
    // Отправляем уведомление об нажатии
    switch ($callback_data) {
        case 'call1':
            $tg->msg("Вы нажали кнопку №1")->send();
            break;
            
        case 'call2':
            $tg->msg("Вы нажали кнопку №2")->send();
            break;
        
        case 'edit':
            $tg->msg("Сообщение отредактировано")->sendEdit();
            // Редактируем сообщение
            break;
    }
}

Отправка Опросов

<?php    
require 'TGZ/autoload.php'; 
use ZhenyaGR\TGZ\TGZ as tg; 

$tg = tg::create(BOT_TOKEN);
$tg->initVars($chat_id, $user_id, $text, $type);

if ($type == 'text' || $type == 'bot_command') {
    switch ($text) {
        case '/poll':
            $tg->msg()
                ->poll('Вопрос опроса') // Отображаемый вопрос
                ->addAnswer('Ответ 1')  // Добавляем ответы
                ->addAnswer('Ответ 2')  
                ->addAnswer('Ответ 3')
                ->isAnonymous(true)     // Анонимный опрос
                ->pollType('regular')   // Тип опроса
                ->send();
            break;
    }
}

Дополнительные функции конструктора сообщений

<?php    
require 'TGZ/autoload.php'; 
use ZhenyaGR\TGZ\TGZ as tg; 

$tg = tg::create(BOT_TOKEN);
$tg->initVars($chat_id, $user_id, $text, $type);

if ($type == 'text' || $type == 'bot_command') {
    switch ($text) {
        case '/reply':
            $tg->msg('Ответ на сообщение')
                ->reply()
                ->send();
            break;
            
        case '/action':
            $send = $tg->msg('Отображение действий бота с помощью sendChatAction')
                ->action('typing');
                // Пока бот не отправит сообщение, будет отображаться "Печатает..."
            sleep(3);
            $send->send();
            break;
        
        case '/params':
            $tg->msg("Дополнительные параметры сообщения")
                ->params(['disable_web_page_preview' => true]) // Отключаем предпросмотр ссылок
                ->send();
            break;
    }
}

Inline-Mode

Подробнее об inline-режиме

Подробный разбор каждого типа описан по ссылке выше

<?php
require 'TGZ/autoload.php';
use ZhenyaGR\TGZ\TGZ as tg;

$tg = tg::create(BOT_TOKEN);
$tg->initVars($chat_id, $user_id, $text, $type, $callback_data, $query_id);

if ($type === 'inline_query') {

    // Приходит запрос с параметром query. Его содержимое находится в переменной $text
    if ($text === '') {
    
        // Начало ввода
        $inline_params = [ 
        
            // Создаём параметры для вывода информации с помощью конструктора
            $tg->inline('article')          // Тип сообщения
            ->id('inline')                  // Уникальный идентификатор
            ->title('Title')                // Заголовок
            ->description('Description')    // Описание
            ->text('Hello, World!')         // Текст, который отправит бот
            ->create(),                     // Создаём сообщение
           
        ]; 
        
        // Отправляем запрос Телеграму
        $tg->answerInlineQuery($query_id, $inline_params);
        
    }
} else if ($type === 'callback_query') {
    
    // Запрос приходит как и при обычной inline клавиатуры
    if ($callback_data === 'call') {
        $tg->msg('Вы нажали кнопку')
            ->sendEdit();
        // send() в данном случае использовать нельзя
    }
    
}

Форматирование сообщений

<?php
require 'TGZ/autoload.php';
use ZhenyaGR\TGZ\TGZ as tg;

$tg = tg::create(BOT_TOKEN);
$tg->initVars($chat_id, $user_id, $text, $type);

if ($type == 'text' || $type == 'bot_command') {    
    switch ($text) {
        case '/html':
            $tg->msg("<b>Отправка сообщений с форматированием HTML</b>")
                ->parseMode('HTML')
                ->send();
            break;
            
        case '/markdown':
            $tg->msg("*Отправка сообщений с форматированием Markdown*")
                ->parseMode('MarkdownV2')
                ->send();
            break;
    }
}

MarkdownV2

*Жирный*  
_Курсив_  
~Зачёркнутый~
__Подчёркнутый__  
`Моноширинный`
```Блок кода```
[Ссылка](https://github.com/ZhenyaGR/TGZ)  
||Спойлер||

HTML

<b>Жирный</b>
<i>Курсив</i>
<s>Зачёркнутый</s>
<u>Подчёркнутый</u>
<code>Моноширинный</code>
<pre>Блок кода</pre>
<a href="https://github.com/ZhenyaGR/TGZ">Ссылка</a>
<span class="tg-spoiler">Спойлер</span>

Примечания:

Для MarkdownV2 экранируйте символы _*[]()~>#+-=|{}.! с помощью \, например: \_некурсив\_

Name		Name	Last commit message	Last commit date
src		src
.gitignore		.gitignore
README.md		README.md
TokenCreate.md		TokenCreate.md
autoload.php		autoload.php
composer.json		composer.json
inline.md		inline.md

Navigation Menu

Repository files navigation

Подключение

Используя composer

Вручную

Первоначальная настройка, создание бота и получение токена

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

Инициализация переменных (WEBHOOK)

Инициализация переменных (LONGPOLL)

Вызов любых методов BOT API. Например copyMessage (WEBHOOK)

Эхо-бот с конструктором сообщений (WEBHOOK)

Вызов любых методов BOT API. Например copyMessage (LONGPOLL)

Эхо-бот с конструктором сообщений (LONGPOLL)

`Все остальные примеры будут показаны на Webhook`

Все доступные типы

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

Отправка клавиатуры и Кнопок

Отправка Опросов

Дополнительные функции конструктора сообщений

Inline-Mode

Подробнее об inline-режиме

Подробный разбор каждого типа описан по ссылке выше

Форматирование сообщений

MarkdownV2

HTML

Примечания:

Ссылка на демонстрационного бота: https://t.me/DemTGZ_bot

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Подключение

Используя composer

Вручную

Первоначальная настройка, создание бота и получение токена

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

Инициализация переменных (WEBHOOK)

Инициализация переменных (LONGPOLL)

Вызов любых методов BOT API. Например copyMessage (WEBHOOK)

Эхо-бот с конструктором сообщений (WEBHOOK)

Вызов любых методов BOT API. Например copyMessage (LONGPOLL)

Эхо-бот с конструктором сообщений (LONGPOLL)

Все остальные примеры будут показаны на Webhook

Все доступные типы

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

Отправка клавиатуры и Кнопок

Отправка Опросов

Дополнительные функции конструктора сообщений

Inline-Mode

Подробнее об inline-режиме

Подробный разбор каждого типа описан по ссылке выше

Форматирование сообщений

MarkdownV2

HTML

Примечания:

Ссылка на демонстрационного бота: https://t.me/DemTGZ_bot

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

`Все остальные примеры будут показаны на Webhook`