PHPackages                             ostiwe/vksaver - 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. ostiwe/vksaver

AbandonedArchivedLibrary

ostiwe/vksaver
==============

2.2.3(6y ago)051BSD-3-ClausePHPPHP >=7.1

Since Feb 14Pushed 6y agoCompare

[ Source](https://github.com/ostiwe/vksaver)[ Packagist](https://packagist.org/packages/ostiwe/vksaver)[ Docs](https://github.com/ostiwe/vksaver)[ RSS](/packages/ostiwe-vksaver/feed)WikiDiscussions master Synced 5d ago

READMEChangelog (5)Dependencies (2)Versions (6)Used By (0)

Ostiwe Saver
------------

[](#ostiwe-saver)

[![Packagist Version](https://camo.githubusercontent.com/8ac0745e4c8f4cb4b117176d4b952a9267d1b3e6c40d6fbe20541ac323cad154/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f73746977652f766b73617665723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ostiwe/vksaver)[![GitHub release (latest by date)](https://camo.githubusercontent.com/5e22082f47ebfb9692ac97aa43666567effcc3ad80cb963ac4b5a1f32b1ed425/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6f73746977652f766b73617665723f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/5e22082f47ebfb9692ac97aa43666567effcc3ad80cb963ac4b5a1f32b1ed425/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6f73746977652f766b73617665723f7374796c653d666c61742d737175617265)

### Описание

[](#описание)

Данный пакет предназначен для владельцев или редакторов сообществ в социальной сети ВКонтакте. Благодаря данному пакету, вы сможете добавлять контент в ваше сообщество без лишних действий.

В данный момент поддерживается добавление в отложку картинок.

#### Как это работает?

[](#как-это-работает)

##### Если вы ищите контент внутри ВКонтакте

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

Если вам понравилась какая-нибудь картинка из новостной ленты/группы, то вам нужно всего лишь отправить пост с этой картинкой вашему боту, либо же просто картинку.

Если в посте больше одной картинки, то вы можете лайкнуть ту, которая вам понравилась, и которую вы хотели бы добавить в отложку. Либо, вы можете отослать этот пост с картинками боту, и он добавит в отложку все картинки которые были в посте.

##### Если вы ищите контент в интернете

[](#если-вы-ищите-контент-в-интернете)

Если вам понравилась картинка в интернете, то для отправки её в сообщество вы можете использовать расширение (о нём позже).

Просто нажмите правой кнопкой мыши на картинку, и в контекстном меню выберите сообщество, в которое вы хотите отправить выбранное изображение.

#### Что нужно для работы?

[](#что-нужно-для-работы)

Для работы необходимо будет дополнительно установить официальную библиотеку от ВКонтатке.

Так же необходимо будет установить в свой браузер расширение, ссылка на него будет в конце.

#### Использование

[](#использование)

Для начала получите токен пользователя со следующими правами:

- Доступ к фотографиям
- Доступ к стене
- Доступ в любое время
- Доступ к группам

Теперь устанавливаем пакет следующей командой:

```
composer require ostiwe/vksaver
```

Далее создаем объект UserClient используя следующий код:

`$ostiwe = new \Ostiwe\Client\UserClient('User id', 'User access Token',[]');`

Первым параметром идет ID пользователя, который является администратором/редактором сообщества.

Вторым параметром идет API токен пользователя с необходимыми правами, которые были описаны выше.

Последним параметром является ассоциативным массивом, в котором описываются настройки для сообществ. Данный массив может выглядить следующим способом:

```
[
    162768498 => [ // В качестве ключа используется ID сообщества
        'post_interval' => 2, // Интервал между постами (в часах)
        'liked_only' => true, // Если в посте несколько картинок, брать те, что с лайком
        'confirmation_code' => '91sj188x', // Код подтверждения сервера
        'secret' => 'super_puper1secret0code', // Секретный ключ Callback сервера
        'access_token' => '31xz6bb054765b2c4d52472c5dc615ea7b2ds88e9', // API токен сообщества (подробнее ниже)
        'name' => 'Pubj' // Короткое имя для класса-обработчика
    ],
    //...
];
```

Для работы необходим API ключ сообщества со следующими правами:

- Сообщения сообщества
- Фотографии
- Стена

Так же убедитесь, что в вашем сообществе включены сообщения (т.е можно писать сообществу).

Далее вызываем метод `callbackHandler` у объекта `$ostiwe` и в качестве параметра указываем декодированный JSON объект, который нам присылает Callback API:

```
$data = json_decode(file_get_contents('php://input'), true);
$ostiwe->callbackHandler($data);
```

### Добавление обработчиков для сообществ

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

Создайте каталог, в котором вы будете хранить классы-обработчики для сообществ. Например Classes.

Далее, перед вызовом метода `callbackHandler()` вызовите метод `setHandlersPatch()`. В параметре передайте путь до папки, например:

```
$ostiwe->setHandlersPatch(__DIR__ . '/Classes');
```

В данной папке создайте новый класс с именем, которое вы придумали, когда описывали массив с параметрами сообщества. `'name' => 'Pubj' // Короткое имя для класса-обработчика`

После этого имени добавьте `Handler`. Должно получить на подобии этого: `NameHandler.php`.

Теперь просто создайте класс с унаследованием от класса `PubHandler`

```
class NameHandler extends \Ostiwe\Handlers\PubHandler {}
```

или

```
use Ostiwe\Handlers\PubHandler;
class NameHandler extends PubHandler {}
```

Теперь осталось указать адрес сервера, который будет принимать и обрабатывать все события. Делается это в настройках сообщества.

### Расширение для браузера

[](#расширение-для-браузера)

В дополнение к данному пакету есть расширение ссылка на него будет в конце этого раздела.

Для того, чтобы использовать расширение, необходимо добавить в массив с группами следующий элемент:

```
 'plugin' => [
        'secret' => 'super_puper1secret0code',
    ]
```

В место `super_puper1secret0code` придумайте или сгенерируйте ключ состоящий из случайных цифр и букв (на англ.).

[Далее смотрите в репозитории с расширением.](https://github.com/ostiwe/vksaver-chrome)

### Пример

[](#пример)

Для index.php

```
$requestData = json_decode(file_get_contents('php://input'), true);
$groups = [
    153626005 => [
        'post_interval' => 2, // hours
        'liked_only' => true,
        'confirmation_code' => 'confirmation code for server',
        'secret' => 'superSecret918s_ds',
        'access_token' => 'group access token',
        'name' => 'AnyName'
    ],
    'plugin' => [
        'secret' => 'superSecret918s_ds',
    ],
];
$ostiwe = new \Ostiwe\Client\UserClient('you vk id', 'you profile token', $groups);

$ostiwe->setHandlersPatch(__DIR__ . '/Classes');

try {
    $ostiwe->callbackHandler($requestData);
} catch (Exception $e) {
    // do something...
}
```

Для /path/to/Classes/AnyNameHandler.php

```
use Ostiwe\Handlers\PubHandler;

class AnyNameHandler extends PubHandler
{
    public function __construct($userToken, $userId, $pubToken, $pubId)
    {
        parent::__construct($userToken, $userId, $pubToken, $pubId);
    }

    /**
     * @param array $attachmentsList
     * @param array $pubParams
     * @param string $postText
     * @throws Exception
     */
    public function handle(array $attachmentsList, array $pubParams, string $postText = '')
    {
        parent::handle($attachmentsList, $pubParams, $postText); // TODO: Change the autogenerated stub
    }

    /**
     * @param array $pubParams
     * @param array $attachmentsList
     * @param string $postText
     * @return array
     * @throws Exception
     */
    public function post(array $pubParams, array $attachmentsList, $postText = '')
    {
        return parent::post($pubParams, $attachmentsList, $postText); // TODO: Change the autogenerated stub
    }

    /**
     * @param string $message
     * @param array $attachments
     * @throws Exception
     */
    public function sendNotificationMessage(string $message, array $attachments = [])
    {
        parent::sendNotificationMessage($message, $attachments); // TODO: Change the autogenerated stub
    }

}
```

По умолчанию, вам в личное сообщение присылается только сообщение об успешном добавлении поста в отложку:

```
public function handle(array $attachmentsList, array $pubParams, string $postText = '')
    {
        try {
            $postInfo = $this->post($pubParams, $attachmentsList,$postText);
        } catch (Exception $e) {
            throw new Exception($e->getMessage(), null, $e);
        }
        $postDate = date('d.m.Y в H:i', $postInfo['date']);
        $textMessage = "Пост будет опубликован $postDate ";
        $textMessage .= "vk.com/wall-{$this->pubId}_{$postInfo['post_id']}";

        try {
            $this->sendNotificationMessage($textMessage);
        } catch (Exception $e) {
            throw new Exception($e->getMessage(), null, $e);
        }
    }
```

Если вы хотите отправить сообщение перед добавлением поста в отложку, то вы можете поступить следующим образом:

```
// Пример из рабочего скрипта
 public function handle(array $attachmentsList, array $pubParams, string $postText = '')
    {
        parent::sendNotificationMessage("Начинаю закидывать выбранные вами картинки в отложку", $attachmentsList);
        parent::handle($attachmentsList, $pubParams, $postText); // TODO: Change the autogenerated stub
    }
```

Если вы хотите выполнить другие действия, то вы можете переписать данный метод

```
 public function handle(array $attachmentsList, array $pubParams, string $postText = '')
    {
        // Ваш код...
    }
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~19 days

Total

5

Last Release

2206d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/60335090?v=4)[Ostiwe](/maintainers/Ostiwe)[@ostiwe](https://github.com/ostiwe)

---

Top Contributors

[![ostiwe](https://avatars.githubusercontent.com/u/60335090?v=4)](https://github.com/ostiwe "ostiwe (16 commits)")

---

Tags

botcomposer-packagepackagephpphp7rurussianrussian-languagevkvkontaktephpbotPHP7vkvkontakteru

### Embed Badge

![Health badge](/badges/ostiwe-vksaver/health.svg)

```
[![Health](https://phpackages.com/badges/ostiwe-vksaver/health.svg)](https://phpackages.com/packages/ostiwe-vksaver)
```

###  Alternatives

[getjump/vk

Library for work with API Vk.com

19948.5k](/packages/getjump-vk)[digitalstars/simplevk

Powerful PHP library/framework for VK API bots, supporting LongPoll & Callback & OAuth

883.9k3](/packages/digitalstars-simplevk)[bocharsky-bw/vkontakte-php-sdk

Vkontakte PHP SDK

3259.2k1](/packages/bocharsky-bw-vkontakte-php-sdk)[yageorgiy/botman-vk-community-callback-driver

A VK community callback driver for botman.io framework

111.3k](/packages/yageorgiy-botman-vk-community-callback-driver)

PHPackages © 2026

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