PHPackages                             grayhoax/phpmaxbot - 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. [Framework](/categories/framework)
4. /
5. grayhoax/phpmaxbot

ActiveFramework[Framework](/categories/framework)

grayhoax/phpmaxbot
==================

MAX messenger bot framework written in PHP with full Bot API support.

v0.21(5d ago)7451↑66.7%7[1 issues](https://github.com/GrayHoax/php-max-bot/issues)GPL-3.0PHPPHP >=7.4

Since Dec 13Pushed 2w ago1 watchersCompare

[ Source](https://github.com/GrayHoax/php-max-bot)[ Packagist](https://packagist.org/packages/grayhoax/phpmaxbot)[ RSS](/packages/grayhoax-phpmaxbot/feed)WikiDiscussions master Synced today

READMEChangelog (9)Dependencies (4)Versions (13)Used By (0)

PHPMaxBot
=========

[](#phpmaxbot)

[![Привлекательное изображение для репозитория](https://github.com/GrayHoax/php-max-bot/raw/master/assets/repo-preview-image.png)](https://github.com/GrayHoax/php-max-bot/raw/master/assets/repo-preview-image.png)

PHP библиотека для создания ботов в мессенджере MAX. Поддерживает полное API MAX messenger и предоставляет удобный интерфейс для разработки ботов.

Особенности
-----------

[](#особенности)

- Простой и интуитивно понятный API
- Поддержка webhook и long polling режимов
- Полная поддержка MAX Bot API
- Встроенные помощники для создания клавиатур и кнопок
- Обработка команд, событий, callback-действий и входящих вложений
- Поддержка регулярных выражений для обработчиков
- Обработка исключений и ошибок API
- PSR-4 автозагрузка

⚠️ Важно: требования к webhook и режиму работы
----------------------------------------------

[](#️-важно-требования-к-webhook-и-режиму-работы)

> **С 25 мая 2026 года MAX прекращает поддержку приёма вебхуков по HTTP и самоподписных сертификатов.**Все продакшн-боты должны принимать обновления по **HTTPS** с сертификатом от **доверенного центра сертификации** (Let's Encrypt, коммерческие CA и т.д.). Подписки с HTTP-URL или невалидным сертификатом перестанут работать.
>
> Чтобы переключиться на новый URL или обновить подписку, используйте текущий метод [`Bot::createSubscription()`](#%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D0%BA%D0%B8-webhook) — повторный вызов с тем же URL заменит её настройки.

> **Long Polling не подходит для production.**Получение обновлений через `getUpdates` (long polling) ограничено по скорости запросов и сроку хранения событий на сервере MAX. Используйте его только при локальной разработке и отладке — в продакшене переключайтесь на **Webhook**.

Кратко:

ОкружениеРекомендуемый режимТребованияРазработка / отладкаLong Polling (CLI)—Staging / ProductionWebhookHTTPS + доверенный сертификатТребования
----------

[](#требования)

- PHP >= 7.4
- ext-curl
- ext-json

Установка
---------

[](#установка)

### Через Composer

[](#через-composer)

```
composer require grayhoax/phpmaxbot
```

### Вручную

[](#вручную)

1. Клонируйте репозиторий:

```
git clone https://github.com/grayhoax/phpmaxbot.git
```

2. Подключите автозагрузку:

```
require_once 'phpmaxbot/vendor/autoload.php';
```

Быстрый старт
-------------

[](#быстрый-старт)

```