{"id":15134251,"url":"https://github.com/dan1lov/php-vkhp","last_synced_at":"2026-02-04T15:39:43.221Z","repository":{"id":56961636,"uuid":"263599259","full_name":"dan1lov/php-vkhp","owner":"dan1lov","description":"VK Helper is library simplifies work with some functions VK API","archived":false,"fork":false,"pushed_at":"2020-07-21T11:19:51.000Z","size":91,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-01T12:51:34.836Z","etag":null,"topics":["helper","php","vk","vk-api","vkapi"],"latest_commit_sha":null,"homepage":null,"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/dan1lov.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}},"created_at":"2020-05-13T10:35:23.000Z","updated_at":"2020-07-12T09:44:45.000Z","dependencies_parsed_at":"2022-08-21T05:40:24.828Z","dependency_job_id":null,"html_url":"https://github.com/dan1lov/php-vkhp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dan1lov/php-vkhp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan1lov%2Fphp-vkhp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan1lov%2Fphp-vkhp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan1lov%2Fphp-vkhp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan1lov%2Fphp-vkhp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dan1lov","download_url":"https://codeload.github.com/dan1lov/php-vkhp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dan1lov%2Fphp-vkhp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29088630,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T03:31:03.593Z","status":"ssl_error","status_checked_at":"2026-02-04T03:29:50.742Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["helper","php","vk","vk-api","vkapi"],"created_at":"2024-09-26T05:04:04.337Z","updated_at":"2026-02-04T15:39:43.190Z","avatar_url":"https://github.com/dan1lov.png","language":"PHP","readme":"# php-vkhp\n\nVK Helper — библиотека, упрощающая работу с некоторыми функциями VK API.\nС её помощью вы можете легко создавать кнопки/клавиатуру без лишних движений, для дальнейшего прикрепления их к отправляемому сообщению.\n\nТакже, не маловажной функцией является возможность за один раз отправить сообщение более чем 100 получателям. Не нужно создавать какие-либо циклы, чтобы по-этапно отправить нужное сообщение каждому пользователю. Просто укажите всех пользователей, которым нужно отправить сообщение, а VKHP это сделает за вас.\n\nТекущая версия VK API — `5.120`, испольуемая по умолчанию в каждом запросе, в котором явно не указана версия.\n\n## Требования\n* PHP \u003e= 7.2\n\n## Установка\nВариант установки через composer:\n```\ncomposer require dan1lov/php-vkhp\n```\n\nВторым, более простым, вариантом является просто перенос файла `src/VKHP_onefile.php` в папку с вашим проектом и последующим его подключением:\n```php\nrequire 'path/to/vkhp/VKHP_onefile.php';\n```\n\n## Примеры использования\n### Готовые шаблоны\nПримеры ботов, построенных с использованием `VKHP`, можно найти в [dan1lov/vk-boilerplate-bot](https://github.com/dan1lov/vk-boilerplate-bot)\n\n### Отправка сообщения\n```php\nuse VKHP\\Method as VKHPM;\n\n$access_token = 'your_access_token_string';\n$user_id = 807533;\n$message = 'Привет, дружище!';\n\nVKHPM::messagesSend($access_token, [\n    'user_ids' =\u003e $user_id,\n    'message' =\u003e $message,\n    'random_id' =\u003e 0\n]);\n```\n\n### Сообщение с клавиатурой\n```php\nuse VKHP\\Method as VKHPM;\nuse VKHP\\Generator as VKHPG;\n\n// для установки типа клавиатуры используется второй аргумент\n// KM_ONETIME - одноразовая, KM_INLINE - инлайн\n$keyboard = VKHPG::keyboard([[\n    //            текст              цвет          payload (полезная нагрузка)\n    VKHPG::button('Название кнопки', VKHPG::BLUE,  [ 'command' =\u003e 'start' ]),\n    VKHPG::button('Вторая кнопка',   VKHPG::GREEN, [ 'second_btn' =\u003e true ]),\n]], VKHPG::KM_ONETIME);\n\nVKHPM::messagesSend($access_token, [\n    'user_ids' =\u003e $user_id,\n    'message' =\u003e $message,\n    'keyboard' =\u003e $keyboard\n    'random_id' =\u003e 0\n]);\n```\n\n### Типы кнопок\n```php\nuse VKHP\\Generator as VKHPG;\n\n// обычная кнопка\nVKHPG::button(label, color, payload);\n\n// кнопка-ссылка\nVKHPG::buttonLink(label, link);\n\n// кнопка, отправляющая текущее местоположение\nVKHPG::buttonLocation(payload);\n\n// кнопка для оплаты через VK Pay\nVKHPG::buttonVKPay(hash);\n\n// кнопка, открывающая приложение VK Mini Apps\nVKHPG::buttonVKApps(label, app_id, owner_id, hash);\n\n// callback-кнопка\nVKHPG::buttonCallback(label, color, payload);\n```\n\n### Загрузка медиа\n```php\nuse VKHP\\Method as VKHPM;\n\n$files1 = [ 'path/to/image.png' ];\n$files2 = [ 'path/to/document1.txt', 'path/to/doc2.pdf' ];\n\n$media1 = VKHPM::uploadMessagesPhoto($access_token, $files1, [ 'peer_id' =\u003e 807533 ]);\n// array('photo123_321')\n\n$media2 = VKHPM::uploadMessagesDoc($access_token, $files2, [ 'peer_id' =\u003e 807533, 'type' =\u003e 'doc' ]);\n// array('doc123_321', 'doc123_322')\n```\n\n### Запрос к VK API\n```php\nuse VKHP\\Method as VKHPM;\n\n$query = VKHPM::make($access_token, 'users.get', [\n    'user_ids' =\u003e 807533,\n    'fields' =\u003e 'screen_name'\n]);\n```\n\n### Временные файлы\n```php\nuse VKHP\\Scenarios as VKHPTemp;\n\n$user_id = 807533;\n$temp_folder = 'path/to/tmp/folder';\n\n// проверка на существование файла\n$exist = VKHPTemp::check($temp_folder, $user_id);\n// true, false\n\nif ($exist) {\n    $temp = new VKHPTemp($temp_folder, $user_id);\n    // или $temp = VKHPTemp::check($temp_folder, $user_id, true);\n\n    $temp-\u003ecommand = 'buy_chickens';\n    $temp-\u003eamount  = 100500;\n\n    // сохранение в файл \"{$temp_folder}/file_id{$user_id}.json\"\n    $temp-\u003esave();\n\n    echo \"Command: {$temp-\u003ecommand}, Amount: {$temp-\u003eamount}\";\n    // Command: buy_chickens, Amount: 100500\n}\n\n// удаление временного файла\n$temp-\u003eclear();\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdan1lov%2Fphp-vkhp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdan1lov%2Fphp-vkhp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdan1lov%2Fphp-vkhp/lists"}