composer.json

@@ -22,18 +22,15 @@
         "issues": "https://git.mirzaev.sexy/mirzaev/vk/issues"
     },
     "require": {
-        "php": "^8.1",
+        "php": "~8.1",
-        "psr/log": "^1.0",
+        "psr/log": "~1.0",
-        "mirzaev/accounts": "^1.2.0",
+        "mirzaev/accounts": "~1.2.0",
-        "monolog/monolog": "^1.6",
+        "monolog/monolog": "~1.6",
-        "jasny/error-handler": "^0.2",
+        "jasny/error-handler": "~0.2",
-        "guzzlehttp/guzzle": "^7.5"
+        "guzzlehttp/guzzle": "~7.5"
     },
     "require-dev": {
-        "phpunit/phpunit": "^9.5"
+        "phpunit/phpunit": "~9.5"
-    },
-    "suggest": {
-        "ext-sodium": "Can be selected in some conditions to increase security"
     },
     "autoload": {
         "psr-4": {

mirzaev/vk/system/api/methods/messages.php

@@ -5,7 +5,9 @@ declare(strict_types=1);
 namespace mirzaev\vk\api\methods;
 
 // Файлы проекта
-use mirzaev\vk\robots\robot,
+use mirzaev\accounts\vk,
+    mirzaev\vk\robots\robot,
+    mirzaev\vk\api\data,
     mirzaev\vk\robots\group;
 
 // Встроенные библиотеки
@@ -15,28 +17,13 @@ use stdClass,
 /**
  * Режимы отправки сообщений
  */
-enum message_send
+enum mode
 {
-    /** Обычная отправка */
+    /** Быстро - случайный идентификатор (умножение на rand()) */
-    case simple;
-
-    /** Проверка отправки */
-    case check;
-}
-
-/**
- * Режимы генерации идентификатора сессии доставки сообщения
- */
-enum random_id
-{
-    /** Генерация: time() (нельзя отправить более чем 1 сообщение в секунду) */
-    case date;
-
-    /** Генерация: rand() */
     case random;
 
-    /** Генерация: random_int(0, PHP_INT_MAX) */
+    /** Надёжно - проверка отправки (поиск сообщения через messages.getById) */
-    case crypto;
+    case search;
 }
 
 /**
@@ -55,64 +42,19 @@ enum random_id
 final class messages extends method
 {
     /**
-     * @var message_send $send_mode Режим отправки сообщений
+     * @var mode $mode Режим отправки сообщений
      */
-    protected message_send $send_mode = message_send::simple;
+    protected mode $mode = mode::random;
 
     /**
-     * @var random_id $generate_mode Режим генерации идентификатора сессии доставки сообщения
+     * @var array[int] Сообщения для пересылки
      */
-    protected random_id $generate_mode = random_id::crypto;
+    protected array $forward;
 
     /**
-     * @var ?int $lat Географическая ширина
+     * @var int Сообщение для ответа
      */
-    protected ?int $lat = null;
+    protected int $reply;
-
-    /**
-     * @var ?int $long Географическая долгота
-     */
-    protected ?int $long = null;
-
-    /**
-     * @var ?int $reply_to Идентификатор сообщения, на которое требуется ответить
-     */
-    protected ?int $reply_to = null;
-
-    /**
-     * @var ?array $forward_messages Идентификаторы пересылаемых сообщений
-     */
-    protected ?array $forward_messages = null;
-
-    /**
-     * @var ?string $sticker_id Идентификатор стикера
-     */
-    protected ?string $sticker_id = null;
-
-    /**
-     * @var ?string $payload Полезная нагрузка
-     */
-    protected ?string $payload = null;
-
-    /**
-     * @var bool $dont_parse_links Не создавать представление ссылки в сообщении?
-     */
-    protected bool $dont_parse_links = false;
-
-    /**
-     * @var bool $disable_mentions Отключить уведомление об упоминании в сообщении?
-     */
-    protected bool $disable_mentions = false;
-
-    /**
-     * @var ?string $intent Интент
-     */
-    protected ?string $intent = null;
-
-    /**
-     * @var ?string $subscribe_id Число, которое будет использоваться для работы с интентами
-     */
-    protected ?int $subscribe_id = null;
 
     /**
      * Конструктор
@@ -181,131 +123,79 @@ final class messages extends method
      *
      * @see https://vk.com/dev/messages.send
      *
-     * @param int|string|null $receiver Получатель
+     * @param int|string|array|null $receiver Получатель
-     * @param ?string $message Сообщение
-     * @param ?int $lat Географическая ширина
-     * @param ?int $long Географическая долгота
-     * @param ?array $attachments Вложения
-     * @param ?int $reply_to Идентификатор сообщения, на которое требуется ответить
-     * @param ?array $forward_messages Идентификаторы пересылаемых сообщений
-     * @param ?forward $forward Пересылаемые сообщения (в другой чат)
-     * @param ?string $sticker_id Идентификатор стикера
-     * @param ?keyboard $keyboard Инстанция клавиатуры
-     * @param ?template $template Инстанция шаблона сообщения
-     * @param ?string $payload Полезная нагрузка
-     * @param bool $dont_parse_links Не создавать представление ссылки в сообщении?
-     * @param bool $disable_mentions Отключить уведомление об упоминании в сообщении?
-     * @param ?string $intent Интент
-     * @param ?int $subscribe_id Число, которое будет использоваться для работы с интентами
-     * @param ?int $random_id Идентификатор сессии доставки сообщения (защита от повторных отправок)
      *
      * @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
      *
-     * @todo
+     * @todo Написать обработчик ошибок возвращаемых ВКонтакте
-     * 1. Написать обработчик ошибок возвращаемых ВКонтакте
-     * 2. Добавить параметр forward (не путать с forward_messages)
-     * 3. Добавить клавиатуру
-     * 4. Добавить шаблоны сообщений
-     * 5. Добавить content_source
      */
-    public function send(
+    public function send(int|string|array|null $receiver): int|array
-        int|string|null $receiver,
+    {
-        ?string $message = null,
+        // Идентификатор
-        ?int $lat = null,
+        $random_id = time();
-        ?int $long = null,
+
-        ?array $attachments = null,
+        if ($this->mode === mode::random) {
-        ?int $reply_to = null,
+            // Быстрая отправка сообщения
-        ?array $forward_messages = null,
+
-        // ?forward $forward = null,
+            $random_id *= rand();
-        ?string $sticker_id = null,
+        }
-        // ?keyboard $keyboard = null,
+
-        // ?template $template = null,
+        // Реиницилазиция
-        ?string $payload = null,
-        bool $dont_parse_links = false,
-        bool $disable_mentions = false,
-        ?string $intent = null,
-        ?int $subscribe_id = null,
-        ?int $random_id = null,
-    ): int|array {
-        // Реинициализация настроек
         $this->robot->api->reinit();
 
-        // Инициализация получателя
+        if (is_int($receiver)) {
-        if (is_int($receiver)) ($id = $receiver - 2000000000) > 0 ? $this->robot->api['peer_id'] = $receiver : $this->robot->api['chat_id'] = $id;
+            // Идентификатор
-        else if (is_array($receiver)) $this->robot->api['peer_ids'] = implode(',', $receiver);
-        else if (is_string($receiver)) $this->robot->api['domain'] = $receiver;
 
-        // Инициализация идентификатора сессии доставки сообщения (защита от повторных отправок)
+            // Инициализация получателя
-        $this->robot->api['random_id'] = $random_id ?? match ($this->generate_mode) {
+            $this->robot->api['peer_id'] = $receiver;
-            random_id::date => time(),
+        } else if (is_array($receiver)) {
-            random_id::random => rand(),
+            // Идентификаторы
-            random_id::crypto => random_int(0, PHP_INT_MAX),
+
-            default => random_int(0, PHP_INT_MAX)
+            // Инициализация получателя
-        };
+            $this->robot->api['user_ids'] = $receiver;
+        } else if (is_string($receiver)) {
+            // Домен
+
+            // Инициализация получателя
+            $this->robot->api['domain'] = $receiver;
+        }
+
+        // Инициализация идентификатора сообщения (защита от повторных отправок) в настройках API
+        $this->robot->api['random_id'] = $random_id;
 
         // Инициализация текста в настройках API
-        if (isset($message)) $this->robot->api['message'] = $message;
+        $this->robot->api['message'] = $this->text;
-        else if (isset($this->text)) $this->robot->api['message'] = $this->text;
 
-        // Инициализация широты
+        // Пересылаемые сообщения
-        if (isset($lat)) $this->robot->api['lat'] = $lat;
+        if (!empty($this->forwardMessages)) {
-        else if (isset($this->lat)) $this->robot->api['lat'] = $this->lat;
 
-        // Инициализация долготы
+            // Инициализация пересылаемых сообщений в настройках API
-        if (isset($long)) $this->robot->api['long'] = $long;
+            $this->robot->api['forward_messages'] = implode(',', $this->forwardMessages);
-        else if (isset($this->long)) $this->robot->api['long'] = $this->tlongext;
+        }
 
-        // Инициализация вложений
+        // Ответные сообщения
-        if (isset($attachments)) $this->robot->api['attachment'] = implode(',', $attachments);
+        if (isset($this->ReplyMessage)) {
-        else if (isset($this->robot->api->data) && $this->robot->api->__get('data') !== []) $this->robot->api['attachment'] = implode(',', $this->robot->api->__get('data'));
 
-        // Инициализация сообщения, на которое требуется ответить
+            // Инициализация идентификатора сообщения на которое обрабатывается ответ в настройках API
-        if (isset($reply_to)) $this->robot->api['reply_to'] = $reply_to;
+            $this->robot->api['reply_to'] = $this->ReplyMessage;
-        else if (isset($this->reply)) $this->robot->api['reply_to'] = $this->reply;
+        }
 
-        // Инициализация пересылаемых сообщений
+        // Вложения
-        if (isset($forward_messages)) $this->robot->api['forward_messages'] = implode(',', $forward_messages);
+        if (isset($this->data) && $this->__get('data') !== []) { // !empty($this->data->data) почемуто не работает
-        else if (isset($this->forward_messages)) $this->robot->api['forward_messages'] = implode(',', $this->forward_messages);
 
-        // Инициализация стикера
+            // Инициализация вложений в настройках API
-        if (isset($sticker_id)) $this->robot->api['sticker_id'] = $sticker_id;
+            $this->robot->api['attachment'] = implode(',', $this->__get('data'));
-        else if (isset($this->sticker_id)) $this->robot->api['sticker_id'] = $this->sticker_id;
+        }
-
-        // Инициализация полезной нагрузки
-        if (isset($payload)) $this->robot->api['payload'] = $payload;
-        else if (isset($this->payload)) $this->robot->api['payload'] = $this->payload;
-
-        // Инициализация пользовательского соглашения
-        // $this->robot->api['content_source'] = $this->robot->content_source;
-
-        // Инициализация "не создавать представление ссылки в сообщении?"
-        if ($dont_parse_links) $this->robot->api['dont_parse_links'] = 1;
-        else if ($this->dont_parse_links) $this->robot->api['dont_parse_links'] = 1;
-
-        // Инициализация "отключить уведомление об упоминании в сообщении?"
-        if ($disable_mentions) $this->robot->api['disable_mentions'] = 1;
-        else if ($this->disable_mentions) $this->robot->api['disable_mentions'] = 1;
-
-        // Инициализация интентов
-        if (isset($intent)) $this->robot->api['intent'] = $intent;
-        else if (isset($this->intent)) $this->robot->api['intent'] = $this->intent;
-
-        // Инициализация числа, которое будет использоваться для работы с интентами
-        if (isset($subscribe_id)) $this->robot->api['subscribe_id'] = $subscribe_id;
-        else if (isset($this->subscribe_id)) $this->robot->api['subscribe_id'] = $this->subscribe_id;
-
-        // Проверка сформированного сообщения
-        if (!$this->robot->api->offsetExists('message') && !$this->robot->api->offsetExists('attachment')) throw new Exception('Сообщение должно содержать текст, либо вложение');
 
         // Запрос
         $request = json_decode($this->robot->browser->request('POST', 'messages.send', ['form_params' => $this->robot->api->settings])->getBody()->getContents());
 
         // Если в ответе ошибка
         if (isset($request->error)) {
-            throw new Exception('ВКонтакте: ' . $request->error->error_msg, $request->error->error_code);
+            throw new Exception('Вконтакте: ' . $request->error->error_msg, $request->error->error_code);
         }
 
-        if ($this->send_mode === message_send::check) {
+        if ($this->mode === mode::search) {
             // Надёжная доставка сообщения
 
             if (!empty($request["response"])) {

mirzaev/vk/system/api/methods/photos.php

@@ -4,12 +4,12 @@ declare(strict_types=1);
 
 namespace mirzaev\vk\api\methods;
 
-// Файлы проекта
+use Exception;
+
 use mirzaev\vk\robots\robot,
     mirzaev\vk\robots\group;
 
-// Встроенные библиотеки
+use mirzaev\accounts\vk as account;
-use Exception;
 
 /**
  * Фотографии (изображения)
@@ -22,7 +22,7 @@ use Exception;
  * @package mirzaev\vk\api\methods
  * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  *
- * @todo Добавить обработку ошибок ($request['errors])
+ * @todo Добавить обработку ошибок ($request['errors];)
  */
 final class photos extends method
 {

mirzaev/vk/system/api/methods/users.php

@@ -5,11 +5,10 @@ declare(strict_types=1);
 namespace mirzaev\vk\api\methods;
 
 // Файлы проекта
-use mirzaev\vk\robots\robot;
+use mirzaev\vk\robots\user;
 
 // Встроенные библиотеки
-use Exception,
+use Exception;
-    stdClass;
 
 /**
  * Пользователь
@@ -25,10 +24,10 @@ final class users extends method
     /**
      * Конструктор
      *
-     * @param robot $user Робот
+     * @param user $user Робот
      */
     public function __construct(
-        protected robot $robot
+        protected user $robot
     ) {
     }
 
@@ -37,69 +36,51 @@ final class users extends method
      *
      * @see https://dev.vk.com/method/users.get
      *
-     * @param array $receiver Выбор пользователей для запроса информации (user_ids)
+     * @param array $user_ids Выбор пользователей для запроса информации
      * @param array $fields Выбор дополнительных запрашиваемых полей
      * @param string $name_case Падеж
      *
-     * @return stdClass|array|null Информация об аккаунте или массив с информацией об аккаунтах, если найдена
+     * @return ?array Информация об аккаунте, если получена
      *
      * @todo
      * 1. Доделать
      * 2. Написать обработчик ошибок возвращаемых ВКонтакте
      */
-    public function get(int|string|array $receiver = [], array $fields = [], ?string $name_case = null): stdClass|array|null
+    public function get(array $user_ids = [], array $fields = [], string $name_case = ''): array
     {
         // Реиницилазиция
         $this->robot->api->reinit();
 
-        if (is_int($receiver)) {
+        // Инициализация пользователей для запроса информации
-            // Идентификатор
+        if (!empty($user_ids)) $this->robot->api['user_ids'] = '';
 
-            // Инициализация пользователя
+        foreach ($user_ids as $key => $user_id) {
-            $this->robot->api['user_ids'] = $receiver;
+            // Перебор пользователей для получения информации
-        } else if (is_array($receiver)) {
-            // Идентификаторы
 
-            // Инициализация пользователей
+            // Запись пользователя
-            $this->robot->api['user_ids'] = '';
+            $this->robot->api['user_ids'] .= $user_id;
 
-            foreach ($receiver as $key => $user_id) {
+            // Запись разделителя
-                // Перебор пользователей для получения информации
+            if ($key === array_key_last($user_ids)) break;
-
+            else $this->robot->api['user_ids'] .= ', ';
-                // Запись пользователя
-                $this->robot->api['user_ids'] .= $user_id;
-
-                // Запись разделителя
-                if ($key === array_key_last($receiver)) break;
-                else $this->robot->api['user_ids'] .= ', ';
-            }
-        } else if (is_string($receiver)) {
-            // Домен
-
-            // Инициализация пользователя
-            $this->robot->api['user_ids'] = $receiver;
         }
 
-        if (isset($fields)) {
+        // Инициализация дополнительных запрашиваемых полей
-            // Запрошены дополнительные запрашиваемые поля
+        if (!empty($fields)) $this->robot->api['fields'] = '';
 
-            // Инициализация дополнительных запрашиваемых полей
+        foreach ($fields as $key => $field) {
-            $this->robot->api['fields'] = '';
+            // Перебор дополнительных запрашиваемых полей
 
-            foreach ($fields as $key => $field) {
+            // Запись запрашиваемого дополнительного поля
-                // Перебор дополнительных запрашиваемых полей
+            $this->robot->api['fields'] .= $field;
 
-                // Запись запрашиваемого дополнительного поля
+            // Запись разделителя
-                $this->robot->api['fields'] .= $field;
+            if ($key === array_key_last($fields)) break;
-
+            else $this->robot->api['fields'] .= ', ';
-                // Запись разделителя
-                if ($key === array_key_last($fields)) break;
-                else $this->robot->api['fields'] .= ', ';
-            }
         }
 
         // Инициализация падежа
-        if (isset($name_case)) $this->robot->api['name_case'] = $name_case;
+        if (!empty($name_case)) $this->robot->api['name_case'] = $name_case;
 
         // Запрос
         $request = json_decode($this->robot->browser->request('POST', 'users.get', ['form_params' => $this->robot->api->settings])->getBody()->getContents());
@@ -109,6 +90,6 @@ final class users extends method
             throw new Exception('ВКонтакте: ' . $request->error->error_msg, $request->error->error_code);
         }
 
-        return is_array($receiver) ? $request->response : (isset($request->response[0]) ? $request->response[0] : null);
+        return $request->response;
     }
 }

mirzaev/vk/system/api/settings.php

@@ -17,6 +17,9 @@ use mirzaev\vk\robots\robot;
  * @var array $settings Настройки
  * @var float $version Версия API
  *
+ * @todo
+ * 1. Создать __isset(), __unset()
+ *
  * @package mirzaev\vk\api
  * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
@@ -27,7 +30,7 @@ class settings implements ArrayAccess
      *
      * Должна иметь тип string потому, что PHP при стандартных настройках удаляет нули у float
      */
-    protected const VK_API_VERSION_DEFAULT = '5.131';
+    protected const VK_API_VERSION_DEFAULT = '5.130';
 
     /**
      * Конструктор
@@ -173,39 +176,15 @@ class settings implements ArrayAccess
         };
     }
 
-    /**
+    // public function __unset(string $name): void
-     * Проверить инициализированность свойства
+    // {
-     *
+    //     match ($name) {
-     * @param string $name Название
+    //         'settings' => throw new Exception('Запрещено удалять настройки', 500),
-     *
+    //         'robot' =>  throw new Exception('Запрещено удалять робота', 500),
-     * @return bool Свойство инициализировано?
+    //         'data', 'attachments' => $this->offsetUnset('attachments'),
-     */
+    //         default => $this->offsetUnset($name)
-    public function __isset(string $name): bool
+    //     };
-    {
+    // }
-        return match ($name) {
-            'settings' => isset($this->settings),
-            'robot' =>  isset($this->robot),
-            'data', 'attachments' => $this->offsetExists('attachments'),
-            default => $this->offsetExists($name)
-        };
-    }
-
-    /**
-     * Деинициализированность свойство
-     *
-     * @param string $name Название
-     *
-     * @return void
-     */
-    public function __unset(string $name): void
-    {
-        match ($name) {
-            'settings' => throw new Exception('Запрещено деинициализировать настройки', 500),
-            'robot' =>  throw new Exception('Запрещено деинициализировать робота', 500),
-            'data', 'attachments' => $this->offsetUnset('attachments'),
-            default => $this->offsetUnset($name)
-        };
-    }
 
     /**
      * Записать по смещению
@@ -257,7 +236,7 @@ class settings implements ArrayAccess
     /**
      * Прочитать по смещению
      */
-    public function offsetGet(mixed $offset): mixed
+    public function &offsetGet(mixed $offset): mixed
     {
         if (isset($this->settings)) {
             if (strcasecmp($offset, 'settings') === 0) {
@@ -281,11 +260,7 @@ class settings implements ArrayAccess
     }
 
     /**
-     * Проверить существование смещения
+     * Проверка существования смещения
-     *
-     * @param mixed $offset Сдвиг
-     *
-     * @return bool Смещение существует?
      */
     public function offsetExists(mixed $offset): bool
     {