Download the PHP package max-messenger-bot/max-bot-api-php without Composer
On this page you can find all versions of the php package max-messenger-bot/max-bot-api-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download max-messenger-bot/max-bot-api-php
More information about max-messenger-bot/max-bot-api-php
Files in max-messenger-bot/max-bot-api-php
Package max-bot-api-php
Short Description PHP SDK for the Max Messenger Bot API
License MIT
Informations about the package max-bot-api-php
Max Messenger Bot API — PHP SDK
Этот SDK предназначен для работы с Max API в полностью объектно-ориентированном формате. Все запросы, ответы и события сервера представлены в строго типизированном объектном виде, никаких array shapes (object-like arrays).
Весь задокументированный функционал реализован, включая возможность возобновления загрузки файлов.
Представление данных в виде объектов делает этот пакет предпочтительным для новичков: не нужно разбираться в документации и изучать структуру данных API Max — IDE сама подскажет доступные поля и методы.
Актуальность: 4 июня 2026 г.
Версия схемы API: 0.0.32
[!WARNING] По поводу ошибок в клиенте, пожалуйста обращайтесь ко мне напрямую:
[!NOTE] Вы можете заметить некоторые отличия реализации от официальной документации. На самом деле, официальная документация может содержать неточности или иметь дублирующиеся способы получения данных.
[!WARNING] При написании бота, используйте инструменты отладки, они сильно упростят разработку.
Некоторые недокументированные в официальном API функции могут быть отключены на стороне Max. Когда они писались и тестировались, они работали.
Если вы думаете, что этот пакет слишком сложный
- Если Вам нужно просто отправить сообщение, то никакие пакеты Вам не нужны, просто прочитайте главу Отправка сообщений используя curl в разделе Отправка сообщений.
- Если Вам нужно что-то ещё, прочитайте раздел Очень простой бот.
Основные особенности
- Это полностью объектно-ориентированный клиент без array shapes (object-like arrays).
- Для работы с клиентом не требуется изучение официального API.
- В большинстве случаев для понимания работы, Вам достаточно будет посмотреть примеры кода.
- Есть валидация данных в моделях запросов (можно отключить).
- Реализована загрузка файлов на сервера обоими поддерживаемыми способами.
- Имеются утилиты (скрипты) для тестирования и отладки обработки событий сервера.
- Весь функционал разбит на слои (бот, API Max клиент, HTTP клиент для API Max, Curl HTTP клиент), каждый слой может быть частично или полностью заменён Вашей реализацией (используются интерфейсы и многие внутренние методы объявлены как публичные).
- Код реализован с возможностью написания тестов для любой части Вашего кода.
- API Max клиент реализован на основе официальной документации API Max в формате
yaml.- Объектная модель, имена моделей, имена параметров сохранены. Документирование откорректировано и дополнено.
- Дополнительно добавлено множество методов, упрощающих работу с API.
Документация в коде
I believe that in-code documentation should be in English. However, due to a lack of resources to translate the documentation into English, the in-code documentation is presented in Russian.
Я считаю, что документация в публичном коде должна быть на английском языке. Однако из-за нехватки ресурсов для перевода документации на английский язык, документация в коде представлена на русском языке.
Установка
Требования
- PHP 8.2+
- Расширение
ext-mbstring
Зависимости
mj4444/simple-http-client^0.2 — HTTP-клиент для выполнения запросов
Примеры
Больше примеров смотрите в документации в разделе примеры.
Обработка событий сервера через Webhook (основной метод)
Обработка событий сервера через Long Polling
Отправка сообщений
Отправка простого сообщения
Отправка сообщения с кнопкой
Отправка сообщения с файлом
Загрузка файлов на сервера Max
Для загрузки файлов на сервера Max установите и используйте пакет max-messenger-bot/max-bot-uploader-php.
Документация
- Начало работы
- Инструменты разработчика
- Список документации