Download the PHP package geekcodev/laravel-max-client without Composer

On this page you can find all versions of the php package geekcodev/laravel-max-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-max-client

geekcodev/laravel-max-client

Тонкий Laravel-адаптер для MAX Messenger Bot API поверх framework-agnostic ядра geekcodev/max-php-client.

Пакет отвечает только за «Laravel-клей»: конфиг, DI, фасад, вебхук-роутинг, очередь. Вся бизнес-логика API (DTO, эндпоинты, ретраи, rate limit, безопасность, загрузка медиа) живёт в ядре — см. его документацию и OpenAPI-спецификацию max-openapi.

Требования

Установка

Сервис-провайдер GeekCo\LaravelMaxClient\MaxServiceProvider и alias Max подхватываются автоматически (package discovery). Затем опубликуйте конфиг:

Конфигурация

Минимально необходима одна переменная — токен бота:

Все доступные переменные (имена см. в .env.example):

Переменная По умолчанию Описание
MAX_API_TOKEN — Токен бота (заголовок Authorization)
MAX_BASE_URI https://platform-api2.max.ru Базовый URI API (домен platform-api2)
MAX_WEBHOOK_ENABLED false Регистрировать вебхук-роут
MAX_WEBHOOK_SECRET — Секрет вебхука (без него роут не включается)
MAX_WEBHOOK_QUEUE default Очередь для джобов обработки Update
MAX_WEBHOOK_PATH /max/webhook Путь вебхук-роута
MAX_RETRY_* 3 / 1 / 30 / 2 / false Ретраи (попытки/базовая/макс. задержка/фактор/не-идемпотентные)
MAX_RATE_LIMIT_* 2.0 / 2.0 Token bucket на диалог/чат/канал: токенов в секунду / максимум
MAX_GLOBAL_RATE_LIMIT_* 30.0 / 30.0 Глобальный token bucket на весь API (ожидание, не ошибка)
MAX_WEBAPP_MAX_AGE 86400 Срок жизни auth_date мини-приложения, сек (0 — не проверять)
MAX_WEBAPP_STRICT false max.webapp возвращает 403 без валидного WebAppData
MAX_WEBAPP_SESSION_USER_ID user_id Ключ сессии для user_id (middleware max.webapp)
MAX_WEBAPP_SESSION_CHAT_ID chat_id Ключ сессии для chat_id (middleware max.webapp)
MAX_WEBAPP_SESSION_CONTACT_CONFIRMED contact_confirmed Ключ флага подтверждённого контакта requestContact (WebAppSession)
MAX_WEBAPP_CSP_ENABLED true Добавлять frame-ancestors в CSP (middleware max.csp)
MAX_WEBAPP_FRAME_ANCESTORS https://max.ru,https://web.max.ru Хосты, которым разрешено встраивать мини-приложение (через запятую)
MAX_CHATS_ENABLED false Включает реестр чатов max_chats (слушатель PersistMaxChatListener)
MAX_CHATS_MODEL GeekCo\LaravelMaxClient\Models\MaxChat Модель реестра чатов (для переопределения)
MAX_CHAT_USERS_MODEL GeekCo\LaravelMaxClient\Models\MaxChatUser Модель связей чата с пользователями (для переопределения)
MAX_CHATS_FETCH_METADATA true Дозаполнять метаданные чата через getChat, пока название неизвестно
MAX_CHATS_CHAT_CHECK_INTERVAL 0 Периодичность перепроверки метаданных для max:chats:refresh, сек (0 — всегда); прежнее имя MAX_CHATS_TITLE_CHECK_INTERVAL учитывается, пока не задано новое
MAX_USERS_MODEL GeekCo\LaravelMaxClient\Models\MaxUser Модель реестра пользователей (для переопределения)
MAX_USERS_PROFILE_FROM_ACTIVE_CHATS true MaxUserProfileService: резолвить chat_id из активных max_chats
MAX_USERS_PROFILE_BATCH_SIZE 50 Лимит userIds на один вызов getChatMembers (батчинг)
MAX_USERS_PROFILE_CHECK_INTERVAL 86400 Периодичность перепроверки профиля в ensureAvatar, сек (0 — только при пустом аватаре)
MAX_LOGGING_ENABLED false Включает логирование (middleware max.log)
MAX_LOGGING_CHANNEL stack Канал Laravel для логов
MAX_LOGGING_FALLBACK_CHANNEL laravel-max-client Запасной канал, если основной не определён
MAX_LOGGING_LOG_REQUEST_BODY false Логировать тело запроса (секреты маскируются)
MAX_LOGGING_LOG_RESPONSE_BODY false Логировать тело ответа
MAX_LOGGING_LOG_RESPONSE_BODY_MAX_LENGTH 1000 Макс. длина не-JSON тела ответа в логе

Токен и секрет никогда не должны попадать в код, логи или коммиты — только env.

Использование

Фасад Max резолвит единый экземпляр ApiClient из контейнера:

Список доступных методов — в PHPDoc фасада GeekCo\LaravelMaxClient\Facades\Max и в ядре GeekCo\MaxPhpClient\ApiClient (актуальные сигнатуры — v1.0.6).

Полные рабочие примеры — в каталоге examples/: basic-usage.php (фасад), webhook-listener.php (обработка апдейтов), custom-http-client.php (подмена PSR-18 клиента), webapp.php (верификация WebAppData мини-приложения), long-polling-local-dev.md (настройка и запуск Long Polling локально и в Docker, а также тест настоящего вебхука через туннель + max:subscribe/max:unsubscribe).

Свой PSR-18 клиент

По умолчанию используется Guzzle с опциями http.options. Чтобы подменить транспорт, зарегистрируйте свою реализацию Psr\Http\Client\ClientInterface в контейнере:

WebAppData (мини-приложение)

Сервис WebAppContext верифицирует стартовые данные мини-приложения MAX (HMAC-SHA256, ядро WebAppDataValidator) и извлекает из них идентификацию пользователя и диалога. Верификация обязательна — без неё любой может подделать user_id/chat_id:

Свежесть auth_date проверяется по MAX_WEBAPP_MAX_AGE (по умолчанию 86400 сек; 0 — не проверять). Сырой WebAppDataValidator доступен из контейнера для случаев, когда данные получены не из Request.

Важно. MAX открывает мини-приложение по URL https://<domain>/webapp#WebAppData=... — стартовые параметры лежат в URL-фрагменте и до сервера не доходят. В вебхуке/на странице брать их из ?WebAppData= нельзя: в реальном MAX его нет. Поэтому фронт должен передать строку WebAppData (из фрагмента или window.WebApp.initData) в запросе — например, заголовком X-Max-WebApp-Data — а сервер верифицировать её через WebAppContext::verifyData() / resolveData():

verify(Request)/resolve(Request) остаются для пути ?WebAppData= (фолбэк/dev).

Middleware max.webapp (сессия + strict)

Готовый middleware верифицирует WebAppData и кладёт user_id/chat_id в сессию, при MAX_WEBAPP_STRICT=true отвечает 403 без валидных данных (иначе — пропускает в демо-режиме):

Ключи сессии настраиваются (MAX_WEBAPP_SESSION_USER_ID / MAX_WEBAPP_SESSION_CHAT_ID). Верифицированная идентичность также доступна в атрибуте запроса ResolveWebAppIdentity::REQUEST_ATTRIBUTE.

Чтение ключей сессии и работа с флагом подтверждённого контакта — через WebAppSession (read-сторона тех же ключей, которые пишет middleware):

confirm($request, $userId) регенерирует session id (защита от session fixation) и ставит флаг; forget($request) снимает флаг (выход / смена аккаунта). Ключ флага — MAX_WEBAPP_SESSION_CONTACT_CONFIRMED.

Контакт из мини-приложения (window.WebApp.requestContact)

Мини-приложение MAX может запросить контакт пользователя через window.WebApp.requestContact() — это другой механизм, чем кнопка request_contact в чате: сервер MAX подписывает три поля payload (authDate, phone, userId; phone — без +), сравнение константное, свежесть auth_date — по MAX_WEBAPP_MAX_AGE (replay-защита). Проверку делает WebAppContactService (обёртка над ядром WebAppContactVerifier):

verify(...) — та же проверка без возврата контакта. Номер и hash в логи не попадают (A09); нормализация номера (удаление + и разделителей) — на стороне ядра. Оба класса доступны из контейнера.

Middleware max.csp (встраивание в MAX)

Добавляет в Content-Security-Policy директиву frame-ancestors 'self' <hosts> (по умолчанию https://max.ru https://web.max.ru) — необходимо каждому мини-приложению, встраиваемому в MAX. Если CSP-заголовок уже задан приложением — директива дописывается:

Отключение — MAX_WEBAPP_CSP_ENABLED=false, хосты — MAX_WEBAPP_FRAME_ANCESTORS=https://a.ru,https://b.ru.

Реестр чатов (max_chats)

Реализация документированной практики MAX: getChats deprecated, chat_id хранить через подписку на bot_added/bot_started. Пакет даёт готовые модели, миграции и слушателя, обновляющего реестр по апдейтам bot_added/bot_started/bot_stopped/bot_removed.

Схема реестра (начиная с v1.2.0):

Таблица Одна строка на Содержит
max_chats чат status, chat_type, метаданные из getChat, last_activity_at
max_chat_users пару «чат + пользователь» status и last_activity_at взаимодействия пользователя с ботом
max_users пользователя профиль, телефон, аватар

max_chat_users — это реестр зафиксированных взаимодействий с ботом, а не полный состав группы или канала: строки появляются только из апдейтов, в которых пришёл конкретный user_id.

Первичный ключ строки max_chats — сам chat_id из MAX: строка реестра одна на чат, суррогатного счётчика нет. Колонки идентификаторов (chat_id, user_id) объявлены знаковым BIGINT: в MAX это int64, и у групп и каналов chat_id отрицательный (например, -79032376695376). unsigned-колонка такой идентификатор не сохранила бы. У max_chat_users и max_users первичные ключи натуральные (chat_id + user_id в паре против user_id), а собственный суррогатный id есть только у строки связи max_chat_users — uuid (uuid7, значение выдаёт модель через HasUuids), потому что идентификаторов от MAX у неё нет. Обращаться к реестрам стоит через модели MaxChat и MaxChatUser; голый DB::table('max_chat_users')->insert() без id не сработает — колонка не имеет значения по умолчанию на стороне базы.

События bot_* — это события о боте в чате, а не о пользователе, поэтому user в них может не прийти. Состояние чата при этом известно: слушатель обновляет строку чата по chat_id — status, last_activity_at, chat_type — даже если пользователя в апдейте не было. Благодаря этому bot_removed без пользователя больше не теряется и чат не остаётся active навсегда. Связь с пользователем при этом не создаётся: без user_id неизвестно, о ком речь.

  1. Выполните миграцию:

    Миграции пакета подгружаются провайдером из каталога database/migrations — публиковать их не нужно. Чистая установка на этом шаге и заканчивается: таблицы создаются в нужной форме. При обновлении проекта, который стоял на v1.1.x, дополнительно выполните php artisan max:upgrade (см. ниже).

  2. Включите реестр:

Пакет регистрирует PersistMaxChatListener на событие MaxUpdateReceived (таблицы max_chats и max_chat_users, статусы active/stopped/removed). Модели можно переопределить через MAX_CHATS_MODEL и MAX_CHAT_USERS_MODEL (классы-наследники GeekCo\LaravelMaxClient\Models\MaxChat и GeekCo\LaravelMaxClient\Models\MaxChatUser).

Связи и подсказка имени чата:

В выборках по связям указывайте таблицу явно: колонка user_id есть и в max_users, и в max_chat_users.

Связи нет у пользователя, если апдейт пришёл без объекта user — только с идентификатором.

Метаданные чата (название, описание, иконка)

Название группы или канала приходит только из getChat(): апдейты bot_added/bot_started содержат лишь chat_id, user и is_channel, а само название приходит отдельным событием chat_title_changed. MaxChatProfileService (singleton) дозаполняет метаданные при регистрации чата, а слушатель пишет title из chat_title_changed в строку чата — без запроса к API.

Пустой ответ не затирает уже известное значение: публичный канал без названия — обычное дело. В реестре строка чата одна, поэтому getChat вызывается один раз на чат независимо от числа участников: на 50 участников приходится один запрос, а не пятьдесят.

Дозаполнить записи, созданные до появления названия, и перепроверять его по расписанию:

При MAX_CHATS_CHAT_CHECK_INTERVAL чаты с более свежим chat_checked_at пропускаются — команда периодически переспрашивает только устаревшее. Команда печатает, сколько чатов к проверке и сколько пропущено, чтобы из расписания было видно, был ли запрос вообще. Прежние имена остаются рабочими, пока не задано новое: переменная MAX_CHATS_TITLE_CHECK_INTERVAL (действовала в v1.1.4) и ключ chats.title_check_interval в конфиге, опубликованном до v1.2.0, — заданный ранее интервал не теряется. Явный 0 в новом имени, наоборот, важнее прежнего: им переопределяют старый интервал (пустая переменная — это «не задано», а не ноль).

Для диалогов поведение не меняется: chat_type = dialog, название не запрашивается. Название для UI удобно брать через MaxChat::displayName() — это title, а при пустом title имя собеседника.

Обновление после обновления пакета

Изменения схемы приезжают отдельными аддитивными миграциями, поэтому после обновления пакета достаточно обычного php artisan migrate — он увидит ещё не выполненные миграции. Перенос данных на новую форму реестра чатов выполняется командой php artisan max:upgrade. Уже выполненные миграции пакета никогда не переписываются: если бы create_max_chats_table изменили на месте, у установленных проектов он числился бы выполненным, и migrate молча ничего не сделал бы.

Переход на структуру «одна строка на чат» (v1.2.0)

До v1.2.0 в max_chats лежала строка на пару «пользователь + чат» с уникальным ключом (user_id, chat_id). В v1.2.0 max_chats хранит одну строку на чат, а связи вынесены в max_chat_users.

Обновление установленного проекта — два шага:

Перенос данных сделан консольной командой, а не миграцией: перед изменением схемы можно посмотреть объём (php artisan max:upgrade --dry-run), а результат — вернуть обратно (--rollback). Команда идемпотентна, на уже новой структуре ничего не делает.

Что делает команда:

Переносится только то, что есть в текущей форме таблицы, поэтому посторонние колонки прежней схемы пересборка отбрасывает. Установка v1.1.3 и старше аддитивных миграций метаданных не получала: там нет ни колонок метаданных, ни отметки проверки, и после обновления такие чаты один раз попадут в очередь max:chats:refresh.

Обновление заодно исправляет знаковость идентификаторов: до v1.2.0 chat_id и user_id объявлялись как unsigned, и на MySQL отрицательный идентификатор в реестры не попадал. chat_id становится знаковым вместе с пересборкой, а max_users расширяется тем же запуском — отдельной миграции ради смены типа нет. При откате колонка сужается обратно только если в базе нет отрицательных значений.

Пока команда не выполнена, схема неполна. Между migrate и max:upgrade таблица max_chats ещё в прежней форме, а модель MaxChat уже ждёт новую — до завершения обновления бот работать не должен.

Смена первичного ключа выполняется пересборкой таблицы (новая временная таблица в целевой форме, копирование строк одним insert … select, переименование), а не alter: сменить первичный ключ на месте нельзя ни на одной поддерживаемой СУБД — SQLite отклоняет удаление колонки ключа, MySQL требует отдельных команд. Индексы пересобранной таблицы переименовываются в канонические имена.

Откат (php artisan max:upgrade --rollback) возвращает прежнюю форму целиком: user_id, строку на каждую пару и суррогатный счётчик id. Пересборка работает в обе стороны, поэтому значения прежних ключей не восстанавливаются как числа (они не сохранялись), но сама форма таблицы возвращается, и повторный запуск команды снова приводит реестр к новой форме. user_id при откате становится nullable: чат без зафиксированных пар получает одну строку с NULL, терять сам факт чата хуже, чем падать на откате.

Если миграции пакета публиковались раньше

До v1.1.4 миграции нужно было копировать вручную: php artisan vendor:publish --tag=laravel-max-client-migrations. Публикация убрана, миграции подгружаются провайдером, но копии, уже лежащие в приложении, никуда не делись и продолжают перекрывать файлы пакета. Причина: Migrator::getMigrationFiles() собирает файлы через keyBy() по имени миграции, а пути пакета идут раньше пути приложения, поэтому последнее вхождение имени — это файл из database/migrations. Правка пакета до такого потребителя не доходит молча.

Проверьте наличие копий:

Если файлы есть, удалите их:

Строки в таблице migrations удалять не нужно. Файлы пакета сейчас называются 0000_00_000001_create_max_users_table и 0000_00_000002_create_max_chats_table, поэтому после удаления копий они числятся невыполненными и отработают повторно при уже существующих таблицах. Это безопасно: в up() каждой create-миграции стоит Schema::hasTable() с выходом по return. Строки со старыми именами останутся в таблице migrations как неиспользуемые — на работу они не влияют, но при желании их можно удалить вручную.

Если копии не только первых двух, но и последующих миграций (add_phone_verified_at, add_chat_id_index, add_chat_metadata), удалите их тоже: они больше не поставляются пакетом и остались бы навсегда в базе проекта. Отсутствие файла при уже выполненной миграции не мешает — повторно она не запустится.

Полоса миграций и порядок установки

Laravel сортирует миграции приложения и всех пакетов по имени файла и применяет сверху вниз, поэтому внешний ключ допустим только на таблицу, чья миграция имеет меньшее имя. Полоса в имени миграции — это позиция пакета в общем порядке, а не отдельный именованный диапазон. Раскладка полос стека i2tech:

Пакет занимает начало порядка из-за users.max_user_id → max_users.user_id: FK в users указывает на таблицу этого пакета, поэтому users обязана применяться позже max_users. Полоса зафиксирована тестом tests/Feature/MaxMigrationsTest.php; сквозную проверку по миграциям приложения и всех пакетов выполняет MigrationOrderTest в приложении — на SQLite нарушение порядка не воспроизводится, поэтому php artisan migrate его не покажет.

max:upgrade и ручные правки схемы

Команда php artisan max:upgrade в v1.2.0 делает перенос реестров на новую структуру (ранее она только дописывала отсутствующие колонки). Схему, правившую руками, она всё равно не закроет: приведите её к форме пакета вручную либо откатитесь на v1.1.4.

Телефон из контакта (request_contact)

Апдейт с вложением-контактом (request_contact) содержит телефон пользователя, но в max_users он не попадает. Слушатель PersistMaxUserPhoneListener сохраняет его в max_users.phone и проставляет phone_verified_at. Если записи пользователя ещё нет — она создаётся.

Телефон принимается только из подписанного вложения: подпись проверяет MaxContactService (ContactVerifier ядра). Контакт без hash или с hash: null (поле nullable в спеке MAX) больше не роняет апдейт — с ядром v1.1.11 такой payload разбирается, но подпись не проходит, и номер считается неподтверждённым: он не сохраняется, а в лог уходит только предупреждение без значений. До v1.1.11 такой апдейт отклонялся целиком с ответом 400.

Отдельной настройки не требуется: контакт приходит только через кнопку request_contact и формируется платформой из номера аккаунта отправителя. Регистрация в MAX возможна на один номер, поэтому это номер самого пользователя, а не произвольное значение из пересланной карточки — пересланный контакт приходит файлом, а не вложением типа contact, и в этот путь не попадает.

Проверка подписи и разбор vCard делаются ядром (ContactVerifier, ContactPhoneExtractor) — телефон и vcf_info не логируются. Если пришёл номер, отличный от сохранённого, значит пользователь сменил номер аккаунта: новое значение сохраняется, а сам факт смены пишется в лог без значений. Уже сохранённый номер, пришедший повторно, обновляет только отметку phone_verified_at.

Значение сохраняется как есть — ядро его не нормализует. Если номер используется как ключ (сверка с CRM, поиск дублей), канонизацию под свой формат сделайте в своём слое, одним местом: vcf_info даёт номер без + (79250000000), импорт или форма могут дать тот же номер с +, и значения разойдутся.

Профиль пользователя (MaxUserProfileService)

В апдейтах MAX аватар не приходит — источник истины полноценного профиля (имя, описание, аватар) участники чата (getChatMembers). Пакет предоставляет MaxUserProfileService (singleton из контейнера) для заполнения полей max_users: avatar_url, full_avatar_url, description и др. «Когда вызывать» — решает приложение.

Подписки (webhook)

Пакет регистрирует команды max:subscribe и max:unsubscribe для управления webhook-подписками:

Вебхук

  1. Включите вебхук и задайте секрет:

    Роут POST /max/webhook (имя max.webhook) регистрируется только при включённом флаге и заданном секрете (fail-closed). Роут вне CSRF, с throttle:60,1 (настраивается в webhook.middleware конфига). Приёмка проверяет X-Max-Bot-Api-Secret через hash_equals (иначе 401).

  2. Подпишитесь на событие доставки MaxUpdateReceived:

    Обработчик:

  3. Пакет ставит HandleMaxUpdateJob в очередь webhook.queue на каждый Update и сразу отвечает 200 (API требует ответ в течение 30 секунд). Если на событие нет слушателей — работа в очередь не ставится.

Long Polling (локальная разработка)

Вебхук требует публичного домена с HTTPS и доверенным CA, поэтому для локальной разработки используйте Long Polling:

Команда опрашивает GET /updates через ядро (LongPollingRunner) и ставит HandleMaxUpdateJob в ту же очередь (webhook.queue) — апдейты обрабатывает тот же слушатель MaxUpdateReceived. Остановка — Ctrl+C.

Опции:

Поведение по умолчанию — в секции long_polling конфига (env MAX_POLLING_*): limit (100), timeout (30 сек), break_on_failure (true — завершаться при ошибке API; для долгой работы в dev задайте MAX_POLLING_BREAK_ON_FAILURE=false).

Активная webhook-подписка отключает Long Polling — не используйте оба механизма одновременно. Фильтр webhook.update_types действует только на доставку подписки: max:listen присылает все типы апдейтов.

Логирование (middleware max.log)

Опциональное логирование входящих запросов/ответов и обработки апдейтов. По умолчанию выключено (fail-safe). При MAX_LOGGING_ENABLED=true middleware автоматически подключается к роуту вебхука перед VerifyMaxWebhookSecret — в лог попадают и ответы 401/400.

Что пишется:

Для остальных роутов (например мини-приложения) подключайте alias вручную:

Пути из logging.exclude_paths полностью пропускаются, из exclude_request_body_paths / exclude_response_body_paths — логируются без тела. Заголовок X-Request-ID из запроса проксируется в ответ. Если канал из MAX_LOGGING_CHANNEL не определён — используется MAX_LOGGING_FALLBACK_CHANNEL, затем stack.

Тестирование

Интеграционные смоук-тесты против реального API (read-only, нужен MAX_API_TOKEN, TLS из Docker-сети блокируется — только --network host):

История изменений

Актуальную версию смотрите по тегу (git tag --sort=-v:refname | head -1) и в GitHub Releases; полные описания — в .agents/release/RELEASE_NOTES_*.md репозитория. Версия берётся из git-тегов, в composer.json поле version не указывается.

Версия Дата Основное
v1.2.3 2026-10-20 Синхронизация с ядром ^1.1.11: апдейт с контактом без hash (поле nullable в спеке MAX) больше не теряется — до v1.1.11 ядро роняло разбор и вебхук отвечал 400 invalid_payload, теперь апдейт доходит до слушателей, а телефон из неподписанного контакта по-прежнему не подтверждается (fail-closed без изменений); правок логики адаптера не потребовалось, добавлены регрессионные тесты; в PHPDoc фасада снята устаревшая пометка deprecated у addChatMembers(); потребителям ядра: новое значение ChatStatus::Suspended требует ветки default в исчерпывающем match
v1.2.2 2026-10-16 WebAppContactService — подтверждение контакта из моста window.WebApp.requestContact() (верификатор ядра WebAppContactVerifier, ядро ^1.1.10), WebAppSession — read-сторона WebApp-сессии с флагом подтверждённого контакта (confirm() регенерирует session id), ключ webapp.session.contact_confirmed (MAX_WEBAPP_SESSION_CONTACT_CONFIRMED); дефолтный список типов webhook-подписки расширен с 6 до 13 (webhook.update_types, env MAX_WEBHOOK_UPDATE_TYPES; фильтр доставки подписки, Long Polling не фильтрует) — после обновления выполнить max:subscribe заново
v1.2.0 2026-09-30 max_chats хранит одну строку на чат с первичным ключом chat_id, связи с пользователями вынесены в max_chat_users (MaxChatUser, MAX_CHAT_USERS_MODEL) с суррогатным id типа uuid; удалён MaxChat::maxUser(); перенос данных с установки v1.1.x выполняет команда max:upgrade (--dry-run, --force, --rollback); колонки идентификаторов объявлены знаковым BIGINT — идентификаторы групп и каналов в MAX отрицательные; title_checked_at → chat_checked_at (значение переносит max:upgrade), chats.title_check_interval → chats.chat_check_interval (прежние имена читаются); метаданные чата запрашиваются один раз на чат независимо от числа участников
v1.1.4 2026-09-30 Метаданные чатов (title, description, link, icon_url) одним запросом getChat на чат, телефон из подтверждённого request_contact, max:chats:refresh и max:upgrade, аддитивные миграции вместо правки create-миграций; исправлены потеря bot_removed и незаполненные метаданные у поздних участников чата
v1.1.2 2026-09-17 Профили в диалогах через dialog_with_user (getChatMembers для диалогов недоступен), резолв типа чата, кэш чатов, ядро ^1.1.0
v1.1.1 2026-09-04 Поле chat_type в max_chats (dialog/chat/channel) и его дозаполнение из lifecycle- и message/callback-апдейтов
v1.1.0 2026-08-28 MaxUserProfileService (аватар и профиль через getChatMembers), реестр чатов переименован в MaxChat / max_chats
v1.0.9 2026-08-19 Реестр пользователей max_users, поле last_activity_at, переименование bot_chats → max_bot_chats
v1.0.7 2026-08-15 Ядро ^1.0.6: глобальный rate limit 30 req/s (global_rate_limit), алиас middleware max_bot.log → max.log, доработка max.csp
v1.0.6 2026-08-14 Верификация WebAppData из строки (фрагмент URL #WebAppData) через WebAppContext
v1.0.5 2026-08-13 Настраиваемое логирование запросов и апдейтов (middleware max.log), синхронизация с ядром v1.0.3
v1.0.3 2026-08-12 Поддержка мини-приложений, middleware max.webapp, реестр чатов, команды max:subscribe / max:unsubscribe
v1.0.0 2026-08-08 Первая версия адаптера: провайдер, publishable-конфиг, фасад, вебхук POST /max/webhook с очередью, Long Polling (max:listen)

Промежуточные патч-версии (v1.0.1, v1.0.2, v1.0.4, v1.0.8, v1.1.3) — см. GitHub Releases.

Лицензия

MIT (c) 2026 Evgeny Semenov. См. LICENSE.


All versions of laravel-max-client with dependencies

PHP Build Version
Package Version
Requires php Version ^8.4
geekcodev/max-php-client Version ^1.1.11
guzzlehttp/guzzle Version ^7.15
laravel/framework Version ^12.0|^13.0
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^1.1|^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package geekcodev/laravel-max-client contains the following files

Loading the files please wait ...