PHPackages                             dan1lov/php-vkhp - 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. [API Development](/categories/api)
4. /
5. dan1lov/php-vkhp

ActiveLibrary[API Development](/categories/api)

dan1lov/php-vkhp
================

VK Helper is library simplifies work with some functions VK API

03PHP

Since Jul 12Pushed 5y ago1 watchersCompare

[ Source](https://github.com/dan1lov/php-vkhp)[ Packagist](https://packagist.org/packages/dan1lov/php-vkhp)[ RSS](/packages/dan1lov-php-vkhp/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependenciesVersions (2)Used By (0)

php-vkhp
========

[](#php-vkhp)

VK Helper — библиотека, упрощающая работу с некоторыми функциями VK API. С её помощью вы можете легко создавать кнопки/клавиатуру без лишних движений, для дальнейшего прикрепления их к отправляемому сообщению.

Также, не маловажной функцией является возможность за один раз отправить сообщение более чем 100 получателям. Не нужно создавать какие-либо циклы, чтобы по-этапно отправить нужное сообщение каждому пользователю. Просто укажите всех пользователей, которым нужно отправить сообщение, а VKHP это сделает за вас.

Текущая версия VK API — `5.120`, испольуемая по умолчанию в каждом запросе, в котором явно не указана версия.

Требования
----------

[](#требования)

- PHP >= 7.2

Установка
---------

[](#установка)

Вариант установки через composer:

```
composer require dan1lov/php-vkhp

```

Вторым, более простым, вариантом является просто перенос файла `src/VKHP_onefile.php` в папку с вашим проектом и последующим его подключением:

```
require 'path/to/vkhp/VKHP_onefile.php';
```

Примеры использования
---------------------

[](#примеры-использования)

### Готовые шаблоны

[](#готовые-шаблоны)

Примеры ботов, построенных с использованием `VKHP`, можно найти в [dan1lov/vk-boilerplate-bot](https://github.com/dan1lov/vk-boilerplate-bot)

### Отправка сообщения

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

```
use VKHP\Method as VKHPM;

$access_token = 'your_access_token_string';
$user_id = 807533;
$message = 'Привет, дружище!';

VKHPM::messagesSend($access_token, [
    'user_ids' => $user_id,
    'message' => $message,
    'random_id' => 0
]);
```

### Сообщение с клавиатурой

[](#сообщение-с-клавиатурой)

```
use VKHP\Method as VKHPM;
use VKHP\Generator as VKHPG;

// для установки типа клавиатуры используется второй аргумент
// KM_ONETIME - одноразовая, KM_INLINE - инлайн
$keyboard = VKHPG::keyboard([[
    //            текст              цвет          payload (полезная нагрузка)
    VKHPG::button('Название кнопки', VKHPG::BLUE,  [ 'command' => 'start' ]),
    VKHPG::button('Вторая кнопка',   VKHPG::GREEN, [ 'second_btn' => true ]),
]], VKHPG::KM_ONETIME);

VKHPM::messagesSend($access_token, [
    'user_ids' => $user_id,
    'message' => $message,
    'keyboard' => $keyboard
    'random_id' => 0
]);
```

### Типы кнопок

[](#типы-кнопок)

```
use VKHP\Generator as VKHPG;

// обычная кнопка
VKHPG::button(label, color, payload);

// кнопка-ссылка
VKHPG::buttonLink(label, link);

// кнопка, отправляющая текущее местоположение
VKHPG::buttonLocation(payload);

// кнопка для оплаты через VK Pay
VKHPG::buttonVKPay(hash);

// кнопка, открывающая приложение VK Mini Apps
VKHPG::buttonVKApps(label, app_id, owner_id, hash);

// callback-кнопка
VKHPG::buttonCallback(label, color, payload);
```

### Загрузка медиа

[](#загрузка-медиа)

```
use VKHP\Method as VKHPM;

$files1 = [ 'path/to/image.png' ];
$files2 = [ 'path/to/document1.txt', 'path/to/doc2.pdf' ];

$media1 = VKHPM::uploadMessagesPhoto($access_token, $files1, [ 'peer_id' => 807533 ]);
// array('photo123_321')

$media2 = VKHPM::uploadMessagesDoc($access_token, $files2, [ 'peer_id' => 807533, 'type' => 'doc' ]);
// array('doc123_321', 'doc123_322')
```

### Запрос к VK API

[](#запрос-к-vk-api)

```
use VKHP\Method as VKHPM;

$query = VKHPM::make($access_token, 'users.get', [
    'user_ids' => 807533,
    'fields' => 'screen_name'
]);
```

### Временные файлы

[](#временные-файлы)

```
use VKHP\Scenarios as VKHPTemp;

$user_id = 807533;
$temp_folder = 'path/to/tmp/folder';

// проверка на существование файла
$exist = VKHPTemp::check($temp_folder, $user_id);
// true, false

if ($exist) {
    $temp = new VKHPTemp($temp_folder, $user_id);
    // или $temp = VKHPTemp::check($temp_folder, $user_id, true);

    $temp->command = 'buy_chickens';
    $temp->amount  = 100500;

    // сохранение в файл "{$temp_folder}/file_id{$user_id}.json"
    $temp->save();

    echo "Command: {$temp->command}, Amount: {$temp->amount}";
    // Command: buy_chickens, Amount: 100500
}

// удаление временного файла
$temp->clear();
```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/29196250?v=4)[Vladimir Danilov](/maintainers/dan1lov)[@dan1lov](https://github.com/dan1lov)

---

Top Contributors

[![dan1lov](https://avatars.githubusercontent.com/u/29196250?v=4)](https://github.com/dan1lov "dan1lov (38 commits)")

---

Tags

helperphpvkvk-apivkapi

### Embed Badge

![Health badge](/badges/dan1lov-php-vkhp/health.svg)

```
[![Health](https://phpackages.com/badges/dan1lov-php-vkhp/health.svg)](https://phpackages.com/packages/dan1lov-php-vkhp)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)