{"id":20072200,"url":"https://github.com/digitalstars/simplevk-php","last_synced_at":"2025-04-12T14:20:05.972Z","repository":{"id":42654208,"uuid":"166597416","full_name":"digitalstars/simpleVK-php","owner":"digitalstars","description":"SimpleVK это PHP библиотека для быстрой разработки ботов для VK","archived":false,"fork":false,"pushed_at":"2025-03-27T18:41:56.000Z","size":3477,"stargazers_count":88,"open_issues_count":0,"forks_count":25,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-12T14:20:04.557Z","etag":null,"topics":["api","php","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,"zenodo":null}},"created_at":"2019-01-19T21:53:25.000Z","updated_at":"2025-03-19T19:20:01.000Z","dependencies_parsed_at":"2024-12-20T03:15:29.491Z","dependency_job_id":"8cd5202d-5474-4dc9-85b6-b7c0082fb960","html_url":"https://github.com/digitalstars/simpleVK-php","commit_stats":{"total_commits":350,"total_committers":9,"mean_commits":"38.888888888888886","dds":"0.42000000000000004","last_synced_commit":"0d872aca44f922b2bc5c3408189778da4de821be"},"previous_names":["digitalstars/simplevk-php","digitalstars/simplevk"],"tags_count":75,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalstars%2FsimpleVK-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalstars%2FsimpleVK-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalstars%2FsimpleVK-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalstars%2FsimpleVK-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitalstars","download_url":"https://codeload.github.com/digitalstars/simpleVK-php/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248578875,"owners_count":21127714,"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","php","vk"],"created_at":"2024-11-13T14:38:54.687Z","updated_at":"2025-04-12T14:20:05.947Z","avatar_url":"https://github.com/digitalstars.png","language":"PHP","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","funding_links":[],"categories":[],"sub_categories":[],"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"}