{"id":15017600,"url":"https://github.com/digitalstars/simpleVK-php","last_synced_at":"2026-04-15T08:30:18.005Z","repository":{"id":42654208,"uuid":"166597416","full_name":"digitalstars/simplevk","owner":"digitalstars","description":"SimpleVK это PHP библиотека для быстрой разработки ботов для VK | vk api php class bot sdk library client framework longpoll callback streaming auth","archived":false,"fork":false,"pushed_at":"2024-08-30T18:38:24.000Z","size":3323,"stargazers_count":89,"open_issues_count":0,"forks_count":26,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-10-01T10:02:24.527Z","etag":null,"topics":["api","auth","bot","callback","class","client","framework","library","longpoll","php","sdk","streaming","vk"],"latest_commit_sha":null,"homepage":"https://simplevk.scripthub.ru/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/digitalstars.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-19T21:53:25.000Z","updated_at":"2024-08-26T09:03:40.000Z","dependencies_parsed_at":"2024-08-06T21:25:21.404Z","dependency_job_id":null,"html_url":"https://github.com/digitalstars/simplevk","commit_stats":{"total_commits":350,"total_committers":10,"mean_commits":35.0,"dds":0.5342857142857143,"last_synced_commit":"0d872aca44f922b2bc5c3408189778da4de821be"},"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalstars%2Fsimplevk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalstars%2Fsimplevk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalstars%2Fsimplevk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalstars%2Fsimplevk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitalstars","download_url":"https://codeload.github.com/digitalstars/simplevk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219847663,"owners_count":16556349,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","auth","bot","callback","class","client","framework","library","longpoll","php","sdk","streaming","vk"],"created_at":"2024-09-24T19:50:44.083Z","updated_at":"2026-04-15T08:30:17.957Z","avatar_url":"https://github.com/digitalstars.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"SimpleVK logo\" title=\"SimpleVK это PHP библиотека быстрой разработки ботов для VK.COM\" src=\"http://images.vfl.ru/ii/1563283715/1c6a23fb/27226348.png\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/packagist/php-v/digitalstars/vk_api.svg?color=FF6F61\" alt=\"php version\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/VK_API-%3E=%205.103-8992bb.svg\" alt=\"VK api version\"\u003e\n\u003cimg src=\"https://img.shields.io/github/release/digitalstars/vk_api.svg?color=green\" alt=\"Latest Stable Version\"\u003e\n\u003ca href=\"https://packagist.org/packages/digitalstars/vk_api/\"\u003e\u003cimg src=\"https://img.shields.io/packagist/dt/digitalstars/vk_api.svg\" alt=\"VK api version\"\u003e\u003c/a\u003e\n\u003cimg src=\"https://poser.pugx.org/laravel/framework/license.svg\" alt=\"License\"\u003e\n\u003c/p\u003e \n\n# SimpleVK 2\n[Документация SimpleVK 2](https://simplevk.scripthub.ru/v2/guide/guide.html) | [Документация SimpleVK 3](https://simplevk.scripthub.ru/v3/install/who_simplevk.html) | \n--- |  --- |  \n\n[Беседа VK](https://vk.me/join/AJQ1dzQRUQxtfd7zSm4STOmt) | [Telegram](https://t.me/vk_api_chat) | [Discord](https://discord.gg/RFqAWRj)\n--- | --- | --- |\n\n[Блог со статьями](https://scripthub.ru) | [Разработка ботов на заказ](https://vk.me/scripthub)\n--- | --- |\n### Оглавление\n- [Обзор SimpleVK](#SimpleVK)\n- [Подключение](#Подключение)\n- [Примеры использования](#Примеры-использования)\n- [План развития проекта](#План-развития-проекта)\n- [Помощь проекту](#Помощь-проекту)\n### Почему SimpleVK?  \n\nДля создания бота потребуется минимум кода, за счёт реализации большинства методов vk api в виде удобных функций.  \nТакже есть готовые модули, которые облегчают разработку: \n * Рассылка сообщений\n * Обработка команд\n * Работа с кнопками\n### Функционал\nВ библиотеке поддерживается:\n * Callback API\n * User Long Poll API\n * Bots Long Poll API\n * Execute\n * VKCoin API\n * Создание ботов на пользовательских аккаунтах\n * Работа с голосовыми сообщениями и документами\n\n## Подключение\n### Используя composer\n```\ncomposer require digitalstars/simplevk\n```\n```php\nrequire_once \"vendor/autoload.php\"; //Подключаем библиотеку\n```\n### Вручную\n1. Скачать последний релиз\n2. Подключить autoload.php. Вот так будет происходить подключение, если ваш скрипт находится в той же папке, что и папка simplevk-master\n```php\nrequire_once \"simplevk-master/autoload.php\"; //Подключаем библиотеку\n```\n\n## Проверка готовности сервера\nЧтобы убедится, что ваш сервер готов к работе с simplevk, необходимо создать и запустить следующий скрипт:\n```php\nrequire_once 'vendor/autoload.php';\n\\DigitalStar\\vk_api\\Diagnostics::run();\n```\n\u003e Если вы делаете longpoll бота, то запускайте диагностику через консоль  \n\u003e Если вы делаете callback бота, то запускайте диагностику через браузер\n\n### Примерный вывод диагностики:\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"http://images.vfl.ru/ii/1608248228/eea9ef11/32696142.jpg\"/\u003e\n\u003c/p\u003e\n\n## Примеры использования\nБольше примеров есть на [сайте с документацией](https://simplevk.scripthub.ru)  \nДля удобства в каждого бота можно добавлять следущие константы:\n```php\nconst VK_KEY = ''; //токен сообщества или пользователя\nconst CONFIRM_STR = ''; //ключ авторизации сообщества, который вы получили\nconst VERSION = '5.101'; //ваша версия используемого api\n```\n#### Минимальный Callback бот для бесед и сообщества\n```php\nrequire_once('vendor/autoload.php');\nuse DigitalStar\\vk_api\\vk_api;\n$vk = vk_api::create(VK_KEY, VERSION)-\u003esetConfirm(CONFIRM_STR);\n$data = $vk-\u003einitVars($id, $message, $payload, $user_id, $type); //инициализация переменных\nif($type == 'message_new')\n  $vk-\u003ereply($message);\n```\n#### Простой Callback бот для бесед и сообщества\n```php\nrequire_once('vendor/autoload.php');\nuse DigitalStar\\vk_api\\vk_api;\n$vk = vk_api::create(VK_KEY, VERSION)-\u003esetConfirm(CONFIRM_STR);\n$vk-\u003edebug();\n$data = $vk-\u003einitVars($id, $message, $payload, $user_id, $type); //инициализация переменных\n$info_btn = $vk-\u003ebuttonText('Информация', 'blue', ['command' =\u003e 'info']); //создание кнопки\nif ($payload) {\n    if($payload['command'] == 'info')\n        $vk-\u003ereply('Тебя зовут %a_full%'); //отвечает пользователю или в беседу\n} else\n    $vk-\u003esendButton($id, 'Видишь кнопку? Нажми на нее!', [[$info_btn]]); //отправляем клавиатуру с сообщением\n```\n#### Простой LongPoll бот для юзера \n```php\nrequire_once('vendor/autoload.php');\nuse DigitalStar\\vk_api\\vk_api;\nuse DigitalStar\\vk_api\\LongPoll;\n$vk = vk_api::create('login', 'password', VERSION);//или используйте токен вместо лог/пас\n$vk = new LongPoll($vk);\n$vk-\u003elisten(function()use($vk){ //longpoll для пользователя\n    $vk-\u003eon('message_new', function($data)use($vk) { //обработка входящих сообщений\n        $vk-\u003einitVars($id, $message, $payload, $user_id, $type);\n        $vk-\u003ereply($message);\n    });\n});\n```\n#### Простой LongPoll бот для сообщества\n```php\nrequire_once('vendor/autoload.php');\nuse DigitalStar\\vk_api\\vk_api;\nuse DigitalStar\\vk_api\\LongPoll;\n$vk = vk_api::create(VK_KEY, '5.101');\n$vk = new LongPoll($vk);\n$vk-\u003elisten(function($data)use($vk){ //в $data содержится все данные\n    $vk-\u003einitVars($id, $message, $payload, $user_id, $type);\n    $vk-\u003ereply($message);\n});\n```\n#### Callback + Execute\nИспользуется, когда callback скрипт во время выполнения много раз обращается к api, а вам нужно экономить запросы, чтобы не привышать лимит(высоконагруженные боты)\n```php\nrequire_once('vendor/autoload.php');\nuse DigitalStar\\vk_api\\vk_api;\nuse DigitalStar\\vk_api\\Execute;\n$vk = vk_api::create(VK_KEY, VERSION)-\u003esetConfirm(CONFIRM_STR);\n$vk = new Execute($vk);\n$vk-\u003edebug();\n$data = $vk-\u003einitVars($id, $message, $payload, $user_id, $type); //инициализация переменных\n$vk-\u003ereply($message); //отвечает пользователю или в беседу\n```\n#### LongPoll + Execute\nЛучшая связка для высоконагруженных ботов. Но если вы делаете высоконагруженного бота, лучше посмотрите в сторону NodeJS, он справляется с этим намного лучше за счет асинхронности и многопоточности из коробки.\n```php\nrequire_once('vendor/autoload.php');\nuse DigitalStar\\vk_api\\vk_api;\nuse DigitalStar\\vk_api\\LongPoll;\nuse DigitalStar\\vk_api\\Execute;\n$vk = vk_api::create(VK_KEY, '5.95');\n$vk = new Execute($vk);\n$vk = new LongPoll($vk);\n$vk-\u003elisten(function($data)use($vk){ //в $data содержится все данные события, можно убрать, если не нужен\n    $vk-\u003einitVars($id, $message, $payload, $user_id, $type); //инициализация переменных\n    $vk-\u003ereply($message);\n});\n```\n## План развития проекта\n- метод для проверки секретного слова\n- streaming api\n- модуль для удобной обработки комманд в боте\n- модуль для удобного написания многоуровневых ботов с кнопками\n- возможность в sendImage отдавать ссылку на картинку в интернете для отправки\n- метод проверки секретного слова\n- более удобная документация на сайте\n- Полностью переписать библиотеку на 3.0\n- Мобильное приложение с копией сайта, для оффлайн просмота\n\n#### Далекое будущее (до 1 года)\n- работа с audio\n- работа с историями\n- модуль работы с основными платежными системами\n- динамические обложки для сообщества(возможно)\n\n## Помощь проекту\n- Яндекс.Деньги - [money.yandex.ru/to/410014638432302]()\n- Дебетовая карта - 2202201272652211\n- Также вы можете помочь проекту `Pull Request`'ом\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalstars%2FsimpleVK-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalstars%2FsimpleVK-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalstars%2FsimpleVK-php/lists"}