PHPackages                             digitalstars/vk\_api - 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. digitalstars/vk\_api

Abandoned → [https://github.com/digitalstars/simplevk](/?search=https%3A%2F%2Fgithub.com%2Fdigitalstars%2Fsimplevk)Library[Framework](/categories/framework)

digitalstars/vk\_api
====================

Powerful PHP library/framework for VK API bots, supporting LongPoll & Callback & OAuth

v3.9.3(8mo ago)9110.6k↓50%24[1 issues](https://github.com/digitalstars/simpleVK-php/issues)MITPHPPHP >=8.2

Since Jan 23Pushed 7mo ago11 watchersCompare

[ Source](https://github.com/digitalstars/simpleVK-php)[ Packagist](https://packagist.org/packages/digitalstars/vk_api)[ Docs](https://simplevk.scripthub.ru/)[ RSS](/packages/digitalstars-vk-api/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (99)Used By (0)

 [    ![Логотип SimpleVK](https://raw.githubusercontent.com/digitalstars/simpleVK-php/master/.github/assets/logo-light.png)  ](https://simplevk.scripthub.ru/)

PHP фреймворк для ботов VK
==========================

[](#php-фреймворк-для-ботов-vk)

 **Мощная PHP библиотека для создания ботов ВКонтакте.
Поддержка VK API, LongPoll, Callback, OAuth2, клавиатур и медиа.**

[![Последний релиз](https://camo.githubusercontent.com/07cfdc5c253defea1faf5056125c0ce0956658043437703c1ade75c88b7f98e3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6469676974616c73746172732f73696d706c65766b3f636f6c6f723d383939326262)](https://packagist.org/packages/digitalstars/simplevk)[![Поддержка версий VK API](https://camo.githubusercontent.com/0a9a6d791cb05f0e711123275ada2c36ae78cc4613adb126373be41980f7ab27/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f564b5f4150492d352e3133392b2d3839393262622e737667)](https://vk.com/dev/versions)[![Всего установок](https://camo.githubusercontent.com/ff2324bb310a8b8c4f49ee6b0eb3f2fd98b7722833eb0417d1e3dd03d54599e2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6469676974616c73746172732f73696d706c65766b2e737667)](https://packagist.org/packages/digitalstars/simplevk)[![Лицензия](https://camo.githubusercontent.com/ff18d69b07a7095ad7fc26b76cf986c91bf15cf02b5b2c38a3bf0522f2d7f35f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6469676974616c73746172732f73696d706c65766b)](https://github.com/digitalstars/simpleVK-php/blob/master/LICENSE)
[![Документация](https://camo.githubusercontent.com/4baf39a7aee385cc8ff06a827b7063e5ec0002434a5721bb5cb8689c5ae39e07/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2dd094d0bed0bad183d0bcd0b5d0bdd182d0b0d186d0b8d18f2d626c75653f7374796c653d666c6174266c6f676f3d676974626f6f6b266c6f676f436f6c6f723d7768697465)](https://simplevk.scripthub.ru/)[![Чат в VK](https://camo.githubusercontent.com/8e296d569938bc94160cb62efe7ce1b2e8b2a6c4c1bbb55d93e0661328e5dac0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2dd0a7d0b0d1825fd0b25f564b2d3436383043323f7374796c653d666c6174266c6f676f3d766b266c6f676f436f6c6f723d7768697465)](https://vk.me/join/AJQ1dzQRUQxtfd7zSm4STOmt)[![Чат в Telegram](https://camo.githubusercontent.com/727b0e25c270623e7be0717e9997b1f5d15deca9bba89d2f5491c6989090b814/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2dd0a7d0b0d1825fd0b25f54656c656772616d2d3236413545343f7374796c653d666c6174266c6f676f3d74656c656772616d266c6f676f436f6c6f723d7768697465)](https://t.me/+98OeLz7uZowwYjYy)

Important

SimpleVK уже переведен с endpoint'a [vk.com](vk.com) на [vk.ru](vk.ru) начиная с версий **v3.9.3** и **v2.14.3**
Не забудьте обновиться, чтобы ваши боты продолжили работать после 30 сентября. [\[Новость\]](https://habr.com/ru/news/943232/).

Ключевые особенности
--------------------

[](#ключевые-особенности)

Помимо полной поддержки VK API, **SimpleVK** предоставляет высокоуровневые инструменты и архитектурные решения, которые кардинально ускоряют и упрощают разработку.

- **PSR-{4,11,16} совместимость**
- **Современная архитектура на Атрибутах:** Организуйте код декларативно с помощью PHP 8 Атрибутов. Назначайте обработчики команд, кнопок и middleware так же, как в больших фреймворках (Laravel/Symfony).
- **Конструктор ботов:** Создавайте сложные сценарии, команды и многоуровневые клавиатуры в читабельном цепочном стиле.
- **Продвинутая система отладки:** Получайте подробные отчеты об ошибках с отформатированным трейсом и проблемным участком кода прямо в личные сообщения ВКонтакте.
- **Модуль массовых рассылок:** Отправляйте сообщения с вложениями по всем диалогам или чатам в несколько строк кода.
- **Умные упоминания (placeholder’ы):** Вставляйте теги в сообщения и библиотека сама заменит их на красивые кликабельные упоминания.
- **Обработка команд:** Настраивайте триггеры на текст или регулярные выражения и легко извлекайте параметры из сообщений.

Полная поддержка VK API
-----------------------

[](#полная-поддержка-vk-api)

**SimpleVK** предоставляет удобный доступ ко всем стандартным элементам VK API

- **Long Poll API** (для User и Bots)
- **Callback API**
- **Streaming API**
- **Загрузка медиа:** Фото, видео, документы, голосовые сообщения
- **Клавиатуры:** Inline, прикрепленные, карусели
- **Кнопки:** Текстовые, callback, URL, оплата, геолокация
- **Авторизация (OAuth):** Упрощенная работа с токенами

Надежность и автоматизация из коробки
-------------------------------------

[](#надежность-и-автоматизация-из-коробки)

Вам не нужно думать о типичных проблемах VK API — **SimpleVK** решает их автоматически.

- **Защита от дублей:** Игнорирование дублирующихся событий и повторных событий при долгой обработке.
- **Стабильность соединения:** Повторные запросы к API при ошибках сети и сбоях/лимитах API.
- **Корректность данных:** Встроенная обработка невалидных JSON и других ошибок API.
- **Разбитие длинных сообщений:** Красиво разбивает сообщения выше 4096 символов на несколько частей.

Установка через Composer (Рекомендуемый)
----------------------------------------

[](#установка-через-composer-рекомендуемый)

```
composer require digitalstars/simplevk
```

Установка из архива
-------------------

[](#установка-из-архива)

Для окружений, где невозможно использовать Composer.

1. Скачайте ZIP-архив `SimpleVK-vX.Y.Z.zip` из раздела Assets [последнего релиза](https://github.com/digitalstars/simpleVK-php/releases)
2. Распакуйте его в ваш проект. Папка `vendor` уже содержит всё необходимое.

Проверка готовности сервера
---------------------------

[](#проверка-готовности-сервера)

Чтобы убедиться, что ваше серверное окружение настроено правильно, SimpleVK предоставляет диагностический скрипт. Создайте файл со следующим кодом и запустите его:

```