Пакет предоставляет удобный способ выполнения запросов к API социальной сети Vk.Сom.

Запросы выполняются в фоновом режиме, используя систему очередей Laravel. На каждый ответ от API генерируется событие, на которое можно подписаться, обработать/сохранить полученные данные и, при необходимости, добавить новые запросы.

Благодаря такому подходу можно гибко выстраивать цепочки из нескольких взаимосвязанных запросов.

// Получить группы по списку ID - groups.getByIds // Для каждой группы получить участников - groups.getMembers // Каждого участника добавить себе в друзья - friends.add // Для каждой группы получить посты - wall.get //Для каждого поста получить комментарии - wall.getComments 

А благодаря автоматическому оборачиванию запросов в "execute-запросы" (по 25 в каждом), выполнение происходит в разы быстрее и понижается вероятность превышения лимитов Vk.Com на кол-во и частоту запросов.

composer require atehnix/laravel-vk-requester 

ATehnix\LaravelVkRequester\VkRequesterServiceProvider::class,

php artisan vendor:publish --provider=ATehnix\LaravelVkRequester\VkRequesterServiceProvider 

php artisan migrate 

Внимание! Предполагается, что в вашем Laravel проекте уже настроены очереди и планировщик задач (Cron).

Перед тем как начать отправлять запросы, необходимо получить API Token. Добавьте в config/services.php:

<?php return [ // ... 'vkontakte' => [ 'client_id' => env('VKONTAKTE_KEY'), 'client_secret' => env('VKONTAKTE_SECRET'), 'redirect' => env('VKONTAKTE_REDIRECT_URI'), ], ]; 

В файле .env укажите соответствующие параметры авторизации вашего VK-приложения.

Route::get('/vkauth', function (ATehnix\VkClient\Auth $auth) { echo "<a href='{$auth->getUrl()}'> Войти через VK.Com </a><hr>"; if (\Request::exists('code')) { echo 'Token: '.$auth->getToken(\Request::get('code')); } }); 

Пример демонстрирует лишь сам принцип получения токена. Как и где вы будете его получать и хранить вы решаете сами.

<?php use ATehnix\LaravelVkRequester\Models\VkRequest; VkRequest::create([ 'method' => 'wall.get', 'parameters' => ['owner_id' => 1], 'token' => 'some_token', ]);

Раз в минуту (по Cron'у) из таблицы временного хранения все новые запросы переносятся в основную очередь Laravel.

Для уменьшения кол-ва реальных обращений к API, все запросы будут автоматически обернуты в "execute-запросы" по 25 в каждом.

В качестве удобного способа подписки на ответы API рекомендуется использовать классы, наследованные от ATehnix\LaravelVkRequester\Contracts\Subscriber.

Метод onSuccess($request, $response) будет вызываться при успешном выполнении запроса, а метод onFail($request, $error) при неудачном.

<?php use ATehnix\LaravelVkRequester\Contracts\Subscriber; use ATehnix\LaravelVkRequester\Models\VkRequest; class WallGetSubscriber extends Subscriber { protected $apiMethod = 'wall.get'; public function onSuccess(VkRequest $request, array $response) { foreach ($response['items'] as $item) { // do something... } } public function onFail(VkRequest $request, array $error) { \Log::alert('Request failed!'); } }

Все Subscriber'ы необходимо добавить в массив $subscribe провайдера EventServiceProvider.

<?php class EventServiceProvider extends ServiceProvider { protected $subscribe = [ WallGetSubscriber::class, ]; // ... }

Конечно же, слушать ответы API можно и без создания Subscriber'а. Все запросы генерируют события определенного формата, которые вы можете "слушать" как описано в разделе "Events" документации Laravel.

VkRequester.success: wall.get #default 

VkRequester.fail: wall.get #default 

По-умолчанию, в имени события присутствует тэг #default. При добавлении запроса вы можете в аттрибуте tag указать любое другое значение тега. Тэг позволяет добавить запросам дополнительный "признак", когда требуется отличать их от других запросов с тем же методом.

MIT