PHPackages zhenyagr/tgz - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. zhenyagr/tgz Abandoned → [zenithgram/zenithgram](/?search=zenithgram%2Fzenithgram)Library[Utility & Helpers](/categories/utility) zhenyagr/tgz ============ Библиотека для разработки ботов в Telegram v0.13.2(2mo ago)51251MITPHPPHP >=8.2CI passing Since Dec 9Pushed 2mo agoCompare [ Source](https://github.com/ZenithGram/php-telegram-bot-library)[ Packagist](https://packagist.org/packages/zhenyagr/tgz)[ RSS](/packages/zhenyagr-tgz/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (15)Versions (25)Used By (0) ZenithGram ========== [](#zenithgram) **Простая, но мощная PHP библиотека для Telegram Bot API!** [![Latest Stable Version](https://camo.githubusercontent.com/37a0b3dc80d21976da153ab3b5937e5cd333134b0fc22b0b736ca2646b2e7f58/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7a656e6974686772616d2f7a656e6974686772616d3f7374796c653d666c61742d73717561726526636f6c6f723d383939326262)](https://packagist.org/packages/zenithgram/zenithgram)[![PHP Version](https://camo.githubusercontent.com/6090740db491962cf9a5b91dbdd5c4e9edc78240beb93ae9cdf93510408acdc7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7a656e6974686772616d2f7a656e6974686772616d3f7374796c653d666c61742d73717561726526636f6c6f723d626c7565)](https://packagist.org/packages/zenithgram/zenithgram)[![Total Downloads](https://camo.githubusercontent.com/29cafae2ad4c7b8aa2351beb4f1f2b4befbb8d9d788105efd1dfe4337654411b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7a656e6974686772616d2f7a656e6974686772616d3f7374796c653d666c61742d73717561726526636f6c6f723d6f72616e6765)](https://packagist.org/packages/zenithgram/zenithgram)[![License](https://camo.githubusercontent.com/e5319413ae94cecbbfc0fa547d832cde748bbed978627c61bc37c6cb0c56339b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7a656e6974686772616d2f7a656e6974686772616d3f7374796c653d666c61742d73717561726526636f6c6f723d73756363657373)](https://packagist.org/packages/zenithgram/zenithgram) [![Документация](https://camo.githubusercontent.com/ee3d0190f31bd4f99a111d029989c62e91f5dd51f45537d1b047da0c8be563f9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d446f63756d656e746174696f6e2d3030376563363f7374796c653d666c61742d737175617265266c6f676f3d72656164746865646f6373266c6f676f436f6c6f723d7768697465)](https://zenithgram.github.io) **ZenithGram** — это библиотека нового поколения для создания Telegram-ботов. Она избавляет вас от бесконечных массивов и `if/else` конструкций, предлагая чистый, декларативный синтаксис, мощный роутер и удобные конструкторы. ### ⚡ Ключевые особенности [](#-ключевые-особенности) - **Fluent Interface:** Цепочки методов для создания сообщений (`msg()->img()->text()->send()`). - **Мощный Роутер:** Класс `Bot` для удобной обработки команд, текста, кнопок и регулярных выражений. - **FSM и Диалоги:** Встроенная машина состояний для создания пошаговых сценариев и анкет с сохранением контекста (step, onState). - **AI-Native:** Оптимизирована для работы с AI-ассистентами (Cursor, Windsurf). - **Универсальность:** Поддержка **Webhook** и **LongPoll** из коробки. - **Обработка ошибок:** Встроенный обработчик ошибок. - **Встроенная Пагинация:** Автоматическая генерация постраничной навигации для списков. --- 📦 Установка ----------- [](#-установка) Установите библиотеку через Composer: ``` composer require zenithgram/zenithgram ``` --- 🤖 AI-Native Development ----------------------- [](#-ai-native-development) Если вы используете **Cursor**, **Windsurf** или другие AI-IDE, добавьте ссылку на наш контекстный файл в документацию проекта. Нейросеть мгновенно изучит все методы библиотеки и будет писать идеальный код. 📄 **Ссылки для AI:** - `https://zenithgram.github.io/llms-full.txt` - `https://zenithgram.github.io/llms.txt` --- 📚 Документация -------------- [](#-документация) Полное описание всех методов, классов и возможностей доступно на официальном сайте: 👉 **[Читать полную документацию](https://zenithgram.github.io)** --- 🛠 Основные возможности ---------------------- [](#-основные-возможности) ### Конструктор сообщений [](#конструктор-сообщений) Забудьте о ручном сборе массивов параметров. Используйте цепочки методов: ``` $tg->msg("Посмотрите на это *фото*!") ->img('https://cataas.com/cat') // URL, ID файла или путь ->reply() // Ответить на сообщение пользователя ->parseMode('MarkdownV2') ->send(); ``` ### Роутинг и обработка событий [](#роутинг-и-обработка-событий) Класс `Bot` позволяет элегантно обрабатывать любые события: ``` // Команда с аргументами (!ban @user причина) $bot->onCommand('ban', '!ban %w %s') ->func(function(ZG $tg, $username, $reason) { $tg->reply("Пользователь $username забанен. Причина: $reason"); }); // Обработка кнопки "О нас" (текстовая клавиатура) $bot->onText('about', 'ℹ️ О нас') ->text('Мы — лучшая компания!'); // Регулярные выражения (поиск email) $bot->onTextPreg('email', '/[\w\.]+@[\w\.]+/') ->func(function(ZG $tg, $matches) { $tg->reply("Найден email: " . $matches[0]); }); ``` ### Умные клавиатуры [](#умные-клавиатуры) Создавайте меню и обрабатывайте нажатия (Callback) в одном месте: ``` // 1. Создаем кнопки и их действия $bot->btn('yes', '✅ Да') ->query('Вы согласились!') // Всплывающее уведомление ->editText('Отлично, вы нажали ДА.'); $bot->btn('no', '❌ Нет') ->editText('Вы отказались.'); // 2. Отправляем клавиатуру $bot->onBotCommand('vote', '/vote') ->text('Вам нравится ZenithGram?') ->inlineKbd([ ['yes', 'no'], // Используем ID кнопок [Button::url('Документация', 'https://zenithgram.github.io')] ]); $bot->run(); ``` ### Пагинация [](#пагинация) Автоматическое создание навигации для больших списков: ``` // Создаем 50 кнопок $items = []; for ($i = 0; $i < 50; $i++) $items[] = Button::cb("Товар $i", "item_$i"); // Генерируем клавиатуру для 1-й страницы $keyboard = $tg->pagination() ->setItems($items) ->setPerPage(5) ->setPage(1) ->create(); $tg->msg("Каталог товаров:")->inlineKbd($keyboard)->send(); ``` ### Health Score 42 — FairBetter than 90% of packages Maintenance87 Actively maintained with recent releases Popularity15 Limited adoption so far Community10 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 86.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 24 Last Release 64d ago PHP version history (2 changes)v0.4.1PHP >=8.1 v0.4.5PHP >=8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/73ba9535b68ba8355876ed9670183c8ea460d0eecd63fd7c19e7e75f33e753ac?d=identicon)[ZhenyaGR](/maintainers/ZhenyaGR) --- Top Contributors [![ZhenyaGR](https://avatars.githubusercontent.com/u/164520638?v=4)](https://github.com/ZhenyaGR "ZhenyaGR (512 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (75 commits)")[![Runnin4ik](https://avatars.githubusercontent.com/u/17353325?v=4)](https://github.com/Runnin4ik "Runnin4ik (2 commits)") --- Tags bot-apibot-telegramchatbotclean-codecomposereasy-to-useframeworklibrarylongpollphpphp8php84sdktelegramtelegram-apitelegram-bottelegram-bot-apitelegrambotwebhookwrapper ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/zhenyagr-tgz/health.svg) ``` [![Health](https://phpackages.com/badges/zhenyagr-tgz/health.svg)](https://phpackages.com/packages/zhenyagr-tgz) ``` ### Alternatives [danog/madelineproto Async PHP client API for the telegram MTProto protocol. 3.4k855.0k18](/packages/danog-madelineproto)[illuminate/contracts The Illuminate Contracts package. 704122.9M10.0k](/packages/illuminate-contracts)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 728272.9k17](/packages/civicrm-civicrm-core)[flow-php/etl PHP ETL - Extract Transform Load - Abstraction 374468.4k51](/packages/flow-php-etl)[gehrisandro/tailwind-merge-php TailwindMerge for PHP merges multiple Tailwind CSS classes by automatically resolving conflicts between them 1391.5M9](/packages/gehrisandro-tailwind-merge-php)[symfony/object-mapper Provides a way to map an object to another object 34885.7k18](/packages/symfony-object-mapper) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)