library fullvk

jorrygo/fullvk

VK-api by object oriented way and with the most complete functionality

Russian

English

Russian

Внимание, пакет находится в активной стадии разработки. Примерное время релиза 27.09.17

Целью данной библиотеки стоит как можно больший охват возможностей vk api, _(*1)

Библиотека поддерживает большую часть доступных методов., _(*2)

Установка

composer, _(*3)

composer require jorrygo/fullvk

Авторизация

Поддерживается авторизация с помощью OAuth и с помощью логина/пароля, _(*4)

OAuth, _(*5)

$vk = new \JorryGo\FullVk\Vk($client_id, $client_secret);
$link = $vk->getAuthLink('http://yourRedirectUri.com/');

Или с настройками доступа приложения и некой строкой, которая вернется на rediret uri, _(*6)

$link = $vk->getAuthLink('http://yourRedirectUri.com/', 'friends,wall,groups', 'my data for return in redirect uri');

Получение access token, _(*7)

Для получения access token требуется передать redirect_uri который вы использовали при формировании ссылке а так же временный код полученный при авторизации пользователя, _(*8)

$vk = new \JorryGo\FullVk\Vk($client_id, $client_secret);

$result = $vk->getAuthToken('http://yourRedirectUri.com/', $code);

В ответе вы получите обьект с вашим access token и id пользователя, _(*9)

Авторизация по access token, _(*10)

$user = $vk->getUser($access_token, $user_id);

Кроме того, вы можете пропустить этот шаг и получить обьект пользователя сразу при получении токена, _(*11)

$user = $vk->getAuthToken('http://yourRedirectUri.com/', $code, true);

Авторизация по логину/паролю, _(*12)

Для авторизации этим способом используются данные официального приложения vk под windows., _(*13)

При использовании этого способа авторизации доступны обсолютно все методы vk-api, в том числе методы для работы с личными сообщениями, _(*14)

$vk = new \JorryGo\FullVk\Vk();
$user = $vk->password_authorization('username', 'password');
print_r($user->getProfileInfo());

Вызов какого-либо метода

$user->execute('method.name', ['param'=> 'value']);

Методы для работы с пользователем

$user->getProfileInfo(); //Возвращает информацию о текущем профиле
$user->getCounters(); //Возвращает ненулевые значения счетчиков пользователя. 
$user->banUser($user_id); //Добавляет пользователя в черный список. 
$user->unbanUser($user_id); //Удаляет пользователя из черного списка. 
$user->getBanned(); //Возвращает список пользователей, находящихся в черном списке.
$user->getBanned($offset = 0, $count = 20); //Возвращает список пользователей, находящихся в черном списке.

Работа со стенами

$user->wall()->get();
$user->wall()->get(['offset' => 10]); //Список параметров - https://vk.com/dev/wall.get

//Чужие стены
$user->wall(1)->get(); //Id пользователя или группы
$user->wall('jorrygo')->get(); //Короткое имя пользователя или группы

Постинг на стену, _(*15)

$user->wall('jorrygo')->post([
    'message' => 'hello world'
]);

$user->wall(-12345)->post([
    'message' => 'hello world in group',
]);

В качестве id стены вы можете указать как сам id, так и доменное имя пользователя/группы., _(*16)

Список передаваемых параметров вы можете увидеть здесь, _(*17)

Так же имеется умный функционал для прикрепления различных обьектов к записи, _(*18)

$user->wall('jorrygo')->post([
    'message' => 'hello world',
    'smart_attachments' => [
        'https://somehost.com/image.jpg',
        'img.jpg',
        'song.mp3',
        'http://someserver.com/another.mp3',
    ],
]);

Независимо от того, находятся ли файлы на удаленном сервере или в вашей файловой системе они будут загружены и прикреплены к записи., _(*19)

Ошибки

В случае, если vk api вернет какую-либо ошибку сработает VkException. Все ошибки логируются. По умолчанию логи собираются в директории пакета., _(*20)

Установка директории для логирования, _(*21)

\JorryGo\FullVk\Vk::setLogDirectory('/logs');

In English

sd, _(*22)