Добавлен messages.getHistory и полностью переработаны остальные методы

.gitignore

@@ -1 +1,3 @@
-/vendor
+!.gitignore
+composer.phar
+vendor

README.md

@@ -1,5 +1,5 @@
-# Колпачный фреймворк для ВКонтакте
+# PHP-фреймворк ВКонтакте
-Развивается как многопоточный фреймворк с поддержкой всех возможностей API ВКонтакте, а так же не добавленных, но необходимых функций, работу с большим количеством роботов под разными сессиями, поддерживающий PSR-спецификацию и полностью покрытый тестами
+Многопоточный фреймворк с поддержкой всех возможностей API ВКонтакте
 
 ### Установка:
 ```sh

composer.json

@@ -1,35 +1,39 @@
 {
     "name": "mirzaev/vk",
     "type": "framework",
-    "description": "Фреймворк VK API",
+    "description": "Framework for vk.com API",
+    "readme": "README.md",
     "keywords": [
         "vk",
         "api"
     ],
-    "homepage": "https://git.hood.su/mirzaev/vk",
+    "homepage": "https://git.mirzaev.sexy/mirzaev/vk",
     "license": "WTFPL",
     "authors": [
         {
             "name": "Arsen Mirzaev Tatyano-Muradovich",
-            "email": "red@hood.su",
+            "email": "arsen@mirzaev.sexy",
-            "homepage": "https://hood.su/mirzaev",
+            "homepage": "https://mirzaev.sexy/mirzaev",
             "role": "Programmer"
         }
     ],
     "support": {
-        "docs": "https://git.hood.su/mirzaev/vk/manual",
+        "docs": "https://git.mirzaev.sexy/mirzaev/vk/wiki",
-        "issues": "https://git.hood.su/mirzaev/vk/issues"
+        "issues": "https://git.mirzaev.sexy/mirzaev/vk/issues"
     },
     "require": {
-        "php": "~8.0",
+        "php": "^8.1",
-        "psr/log": "~1.0",
+        "psr/log": "^1.0",
-        "mirzaev/accounts": "~0.1.x-dev",
+        "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.2"
+        "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/callback.php

@@ -2,7 +2,7 @@
 
 // declare(strict_types=1);
 
-// namespace Hood\VK\API;
+// namespace mirzaev\vk\API;
 
 // class CallBack extends CallBackAbstract
 // {

mirzaev/vk/system/api/longpoll.php

@@ -7,7 +7,8 @@ namespace mirzaev\vk\api;
 use Exception;
 
 use mirzaev\vk\core,
-    mirzaev\vk\robots\robot;
+    mirzaev\vk\robots\robot,
+    mirzaev\vk\robots\group;
 
 /**
  * LongPoll
@@ -25,7 +26,7 @@ use mirzaev\vk\core,
  * @see https://vk.com/dev/groups.setLongPollSettings
  *
  * @package mirzaev\vk\api
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  *
  * @todo Добавить обработку ошибок ($request['errors];)
  */
@@ -36,14 +37,14 @@ final class longpoll
      *
      * @see $this->get()
      */
-    private string $key;
+    private readonly string $key;
 
     /**
      * Сервер (URL)
      *
      * @see $this->get()
      */
-    private string $server;
+    private readonly string $server;
 
     /**
      * Идентификатор последнего события
@@ -59,7 +60,7 @@ final class longpoll
      *
      * $robot Робот
      */
-    public function __construct(private robot $robot)
+    public function __construct(private robot&group $robot)
     {
         // Инициализация
         if (empty($robot->id)) throw new Exception('Необходимо указать идентификатор ВКонтакте');

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

@@ -0,0 +1,115 @@
+<?php
+
+declare(strict_types=1);
+
+namespace mirzaev\vk\api\methods;
+
+// Файлы проекта
+use mirzaev\vk\robots\user;
+
+// Встроенные библиотеки
+use Exception;
+
+/**
+ * Аккаунт
+ *
+ * @method public getInfo(?array $fields = null) Запросить информацию об аккаунте
+ * @method public getProfileInfo(?array $fields = null) Запросить информацию о профиле
+ *
+ * @see https://dev.vk.com/method/account
+ *
+ * @package mirzaev\vk\api
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
+ */
+final class account extends method
+{
+    /**
+     * Конструктор
+     *
+     * @param user $user Робот
+     */
+    public function __construct(
+        protected user $robot
+    ) {
+    }
+
+    /**
+     * Запросить информацию об аккаунте
+     *
+     * @see https://dev.vk.com/method/account.getInfo
+     *
+     * @param array $fields Выбор полей с запрашиваемой информацией (оставить пустым, если нужны все)
+     *
+     * @return ?array Информация об аккаунте, если получена
+     *
+     * @todo
+     * 1. Доделать
+     * 2. Написать обработчик ошибок возвращаемых ВКонтакте
+     */
+    public function getInfo(array $fields = []): array
+    {
+        // Реиницилазиция
+        $this->robot->api->reinit();
+
+        foreach ($fields as $key => $field) {
+            // Перебор запрашиваемых полей с информацией
+
+            // Запись запрашиваемого поля
+            $this->robot->api['fields'] .= $field;
+
+            // Запись разделителя
+            if ($key === array_key_last($fields)) break;
+            else $this->robot->api['fields'] .= ', ';
+        }
+
+        // Запрос
+        $request = json_decode($this->robot->browser->request('POST', 'account.getInfo', ['form_params' => $this->robot->api->settings])->getBody()->getContents());
+
+        // Если в ответе ошибка
+        if (isset($request->error)) {
+            throw new Exception('ВКонтакте: ' . $request->error->error_msg, $request->error->error_code);
+        }
+
+        return $request->response;
+    }
+
+    /**
+     * Запросить информацию о профиле
+     *
+     * @see https://dev.vk.com/method/account.getProfileInfo
+     *
+     * @param array $fields Выбор полей с запрашиваемой информацией (оставить пустым, если нужны все)
+     *
+     * @return ?array Информация об аккаунте, если получена
+     *
+     * @todo
+     * 1. Доделать
+     * 2. Написать обработчик ошибок возвращаемых ВКонтакте
+     */
+    public function getProfileInfo(array $fields = []): array
+    {
+        // Реиницилазиция
+        $this->robot->api->reinit();
+
+        foreach ($fields as $key => $field) {
+            // Перебор запрашиваемых полей с информацией
+
+            // Запись запрашиваемого поля
+            $this->robot->api['fields'] .= $field;
+
+            // Запись разделителя
+            if ($key === array_key_last($fields)) break;
+            else $this->robot->api['fields'] .= ', ';
+        }
+
+        // Запрос
+        $request = json_decode($this->robot->browser->request('POST', 'account.getProfileInfo', ['form_params' => $this->robot->api->settings])->getBody()->getContents());
+
+        // Если в ответе ошибка
+        if (isset($request->error)) {
+            throw new Exception('ВКонтакте: ' . $request->error->error_msg, $request->error->error_code);
+        }
+
+        return $request->response;
+    }
+}

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

@@ -4,12 +4,40 @@ declare(strict_types=1);
 
 namespace mirzaev\vk\api\methods;
 
-use Exception;
+// Файлы проекта
+use mirzaev\vk\robots\robot,
+    mirzaev\vk\robots\group;
 
-use mirzaev\accounts\vk;
+// Встроенные библиотеки
-use mirzaev\vk\robots\robot;
+use stdClass,
-use mirzaev\vk\api\data;
+    Exception;
-use mirzaev\vk\robots\group;
+
+/**
+ * Режимы отправки сообщений
+ */
+enum message_send
+{
+    /** Обычная отправка */
+    case simple;
+
+    /** Проверка отправки */
+    case check;
+}
+
+/**
+ * Режимы генерации идентификатора сессии доставки сообщения
+ */
+enum random_id
+{
+    /** Генерация: time() (нельзя отправить более чем 1 сообщение в секунду) */
+    case date;
+
+    /** Генерация: rand() */
+    case random;
+
+    /** Генерация: random_int(0, PHP_INT_MAX) */
+    case crypto;
+}
 
 /**
  * Сообщение
@@ -20,153 +48,570 @@ use mirzaev\vk\robots\group;
  * @see https://vk.com/dev/messages.getById
  *
  * @package mirzaev\vk\api
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  *
  * @todo Доработать строгий режим отправки: проверку сообщения в беседе (не имеет ID сообщений)
  */
 final class messages extends method
 {
     /**
-     * @var int $mode Режим отправки
+     * @var message_send $send_mode Режим отправки сообщений
      */
-    protected int $mode = 1;
+    protected message_send $send_mode = message_send::simple;
 
     /**
-     * @var array[int] Сообщения для пересылки
+     * @var random_id $generate_mode Режим генерации идентификатора сессии доставки сообщения
      */
-    protected array $forward;
+    protected random_id $generate_mode = random_id::crypto;
 
     /**
-     * @var int Сообщение для ответа
+     * @var int|string|array|null $peer_id Получатель
      */
-    protected int $reply;
+    protected int|string|array|null $peer_id = null;
+
+    /**
+     * @var string|null $text Текст
+     */
+    protected string|null $text = null;
+
+    /**
+     * @var ?int $lat Географическая ширина
+     */
+    protected ?int $lat = null;
+
+    /**
+     * @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 ?int $subscribe_id Число, которое будет использоваться для работы с интентами
+     */
+    protected ?int $subscribe_id = null;
+
+    /**
+     * @var ?int $offset Смещение для выбора сообщений
+     */
+    protected ?int $offset = null;
+
+    /**
+     * @var ?int $count Количество выбираемых сообщений
+     */
+    protected ?int $count = null;
+
+    /**
+     * @var ?int $start_message_id Идентификатор сообщения от которого начнётся выборка
+     */
+    protected ?int $start_message_id = null;
+
+    /**
+     * @var bool $rev Получить сообщения в хронологичном порядке? (иначе в обратном)
+     */
+    protected bool $rev = false;
+
+    /**
+     * @var bool $extended Получить расширенную информацию об авторах сообщений?
+     */
+    protected bool $extended = false;
+
+    /**
+     * @var ?array $fields Дополнительные запрашиваемые поля (для $extended)
+     */
+    protected ?array $fields = null;
 
     /**
      * Конструктор
      *
      * @param robot $robot Робот
-     * @param int|string|array|null $destination Получатель
+     */
+    public function __construct(protected robot $robot, mixed ...$properties)
+    {
+        // Быстрая отправка
+        if (!empty($properties))  $this->send(...$properties);
+    }
+
+    /**
+     * Записать: режим отправки сообщений
+     *
+     * @param message_send $send_mode Режим отправки сообщений
+     *
+     * @return static
+     */
+    public function send_mode(message_send $send_mode): static
+    {
+        // Запись в свойство
+        $this->__set('send_mode', $send_mode);
+
+        return $this;
+    }
+
+    /**
+     * Записать: режим генерации идентификатора сессии доставки сообщения
+     *
+     * @param random_id $generate_mode Режим генерации идентификатора сессии доставки сообщения
+     *
+     * @return static
+     */
+    public function generate_mode(random_id $generate_mode): static
+    {
+        // Запись в свойство
+        $this->__set('generate_mode', $generate_mode);
+
+        return $this;
+    }
+
+    /**
+     * Записать: получатель
+     *
+     * @param int|string|array|null $peer_id Получатель
+     *
+     * @return static
+     */
+    public function peer_id(int|string|array|null $peer_id): static
+    {
+        // Запись в свойство
+        $this->__set('peer_id', $peer_id);
+
+        return $this;
+    }
+
+    /**
+     * Записать: текст
+     *
      * @param string|null $text Текст
-     */
-    public function __construct(
-        protected robot $robot,
-        int|string|array|null $destination = null,
-        protected string|null $text = null
-    ) {
-        if (isset($this->text, $destination)) {
-            // Быстрая отправка
-
-            $this->send($destination);
-        }
-    }
-
-    /**
-     * Записать текст
      *
-     * @param string $text Текст
+     * @return static
      */
-    public function text(string $text): self
+    public function text(string|null $text): static
     {
-        // Записать текст
+        // Запись в свойство
-        if (!isset($this->text)) {
+        $this->__set('text', $text);
-            $this->text = $text;
-        } else {
-            $this->text .= $text;
-        }
 
         return $this;
     }
 
     /**
-     * Записать сообщения для пересылки
+     * Записать: географическая ширина
      *
-     * @param $ids Идентификаторы сообщений
+     * @param ?int $lat Географическая ширина
+     *
+     * @return static
      */
-    public function forward(...$ids): self
+    public function lat(?int $lat): static
     {
-        // Запись
+        // Запись в свойство
-        $this->forward = array_merge($this->forward ?? [], $ids);
+        $this->__set('lat', $lat);
 
         return $this;
     }
 
     /**
-     * Записать сообщение для ответа
+     * Записать: географическая долгота
      *
-     * @param $id Идентификатор сообщения
+     * @param ?int $long Географическая долгота
+     *
+     * @return static
      */
-    public function reply(int $id): self
+    public function long(?int $long): static
     {
-        // Запись
+        // Запись в свойство
-        $this->reply = $id;
+        $this->__set('long', $long);
 
         return $this;
     }
 
+    /**
+     * Записать: идентификатор сообщения, на которое требуется ответить
+     *
+     * @param ?int $reply_to Идентификатор сообщения, на которое требуется ответить
+     *
+     * @return static
+     */
+    public function reply_to(?int $reply_to): static
+    {
+        // Запись в свойство
+        $this->__set('reply_to', $reply_to);
+
+        return $this;
+    }
+
+    /**
+     * Записать: идентификаторы пересылаемых сообщений
+     *
+     * @param ?array $forward_messages Идентификаторы пересылаемых сообщений
+     *
+     * @return static
+     */
+    public function forward_messages(?array $forward_messages): static
+    {
+        // Запись в свойство
+        $this->__set('forward_messages', $forward_messages);
+
+        return $this;
+    }
+
+    /**
+     * Записать: идентификаторы пересылаемых сообщений
+     *
+     * @param ?array $forward Идентификаторы пересылаемых сообщений
+     *
+     * @return static
+     */
+    public function forward(?array $forward): static
+    {
+        // Запись в свойство
+        $this->__set('forward_messages', $forward);
+
+        return $this;
+    }
+
+    /**
+     * Записать: идентификатор стикера
+     *
+     * @param ?string $sticker_id Идентификатор стикера
+     *
+     * @return static
+     */
+    public function sticker_id(?string $sticker_id): static
+    {
+        // Запись в свойство
+        $this->__set('sticker_id', $sticker_id);
+
+        return $this;
+    }
+
+    /**
+     * Записать: полезная нагрузка
+     *
+     * @param ?string $payload Полезная нагрузка
+     *
+     * @return static
+     */
+    public function payload(?string $payload): static
+    {
+        // Запись в свойство
+        $this->__set('payload', $payload);
+
+        return $this;
+    }
+
+    /**
+     * Записать: не создавать представление ссылки в сообщении?
+     *
+     * @param bool $dont_parse_links Не создавать представление ссылки в сообщении?
+     *
+     * @return static
+     */
+    public function dont_parse_links(bool $dont_parse_links): static
+    {
+        // Запись в свойство
+        $this->__set('dont_parse_links', $dont_parse_links);
+
+        return $this;
+    }
+
+    /**
+     * Записать: отключить уведомление об упоминании в сообщении?
+     *
+     * @param bool $disable_mentions Отключить уведомление об упоминании в сообщении?
+     *
+     * @return static
+     */
+    public function disable_mentions(bool $disable_mentions): static
+    {
+        // Запись в свойство
+        $this->__set('disable_mentions', $disable_mentions);
+
+        return $this;
+    }
+
+    /**
+     * Записать: интент
+     *
+     * @param ?string $intent Интент
+     *
+     * @return static
+     */
+    public function intent(?string $intent): static
+    {
+        // Запись в свойство
+        $this->__set('intent', $intent);
+
+        return $this;
+    }
+
+    /**
+     * Записать: число, которое будет использоваться для работы с интентами
+     *
+     * @param ?int $subscribe_id Число, которое будет использоваться для работы с интентами
+     *
+     * @return static
+     */
+    public function subscribe_id(?int $subscribe_id): static
+    {
+        // Запись в свойство
+        $this->__set('subscribe_id', $subscribe_id);
+
+        return $this;
+    }
+
+    /**
+     * Записать: смещение для выбора сообщений
+     *
+     * @param ?int $offset Смещение для выбора сообщений
+     *
+     * @return static
+     */
+    public function offset(?int $offset): static
+    {
+        // Запись в свойство
+        $this->__set('offset', $offset);
+
+        return $this;
+    }
+
+    /**
+     * Записать: количество выбираемых сообщений
+     *
+     * @param ?int $count Количество выбираемых сообщений
+     *
+     * @return static
+     */
+    public function count(?int $count): static
+    {
+        // Запись в свойство
+        $this->__set('count', $count);
+
+        return $this;
+    }
+
+    /**
+     * Записать: идентификатор сообщения от которого начнётся выборка
+     *
+     * @param ?int $start_message_id Идентификатор сообщения от которого начнётся выборка
+     *
+     * @return static
+     */
+    public function start_message_id(?int $start_message_id): static
+    {
+        // Запись в свойство
+        $this->__set('start_message_id', $start_message_id);
+
+        return $this;
+    }
+
+    /**
+     * Записать: получить сообщения в хронологичном порядке?
+     *
+     * @param bool $rev Получить сообщения в хронологичном порядке? (иначе в обратном)
+     *
+     * @return static
+     */
+    public function rev(bool $rev): static
+    {
+        // Запись в свойство
+        $this->__set('rev', $rev);
+
+        return $this;
+    }
+
+    /**
+     * Записать: получить расширенную информацию об авторах сообщений?
+     *
+     * @param bool $extended Получить расширенную информацию об авторах сообщений?
+     *
+     * @return static
+     */
+    public function extended(bool $extended): static
+    {
+        // Запись в свойство
+        $this->__set('extended', $extended);
+
+        return $this;
+    }
+
+    /**
+     * Записать: дополнительные запрашиваемые поля
+     *
+     * @param ?array $fields Дополнительные запрашиваемые поля (для static::$extended)
+     *
+     * @return static
+     */
+    public function fields(?array $fields): static
+    {
+        // Запись в свойство
+        $this->__set('fields', $fields);
+
+        return $this;
+    }
+
+    /**
+     * Инициализировать получателя
+     *
+     * Записывает получателя в буфер API робота
+     *
+     * @param int|string|array|null $peer_id Получатель (группа, чат, пользователь и пользователи)
+     *
+     * @return void
+     */
+    public function receiver(int|string|array|null $peer_id = null): void
+    {
+        if (isset($peer_id)) $this->peer_id = $peer_id;
+        if (is_int($this->peer_id)) ($id = $this->peer_id - 2000000000) > 0 ? $this->robot->api['peer_id'] = $this->peer_id : $this->robot->api['chat_id'] = $id;
+        else if (is_array($this->peer_id)) $this->robot->api['peer_ids'] = implode(',', $this->peer_id);
+        else if (is_string($this->peer_id)) $this->robot->api['domain'] = $this->peer_id;
+    }
+
     /**
      * Отправить сообщение
      *
-     * @see https://vk.com/dev/messages.send
+     * @see https://dev.vk.com/method/messages.send
      *
-     * @param int|string|array|null $destination Получатель
+     * @param int|string|null $peer_id Получатель (группа, чат, пользователь и пользователи)
+     * @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(int|string|array|null $destination): int|array
+    public function send(
-    {
+        int|string|null $peer_id = null,
-        // Идентификатор
+        ?string $message = null,
-        $random_id = time();
+        ?int $lat = null,
-
+        ?int $long = null,
-        if ($this->mode = 1) {
+        ?array $attachments = null,
-            // Перемножение (по умолчанию)
+        ?int $reply_to = null,
-            $random_id *= rand();
+        ?array $forward_messages = null,
-        }
+        // ?forward $forward = null,
-
+        ?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();
 
-        // Цель отправки
+        // Инициализация получателя
-        $this->robot->api->destination($destination);
+        $this->receiver($peer_id);
 
-        // Инициализация идентификатора (защита от повторных отправок) в настройках API
+        // Инициализация идентификатора сессии доставки сообщения (защита от повторных отправок)
-        $this->robot->api['random_id'] = $random_id;
+        $this->robot->api['random_id'] = $random_id ?? match ($this->generate_mode) {
+            random_id::date => time(),
+            random_id::random => rand(),
+            random_id::crypto => random_int(0, PHP_INT_MAX),
+            default => random_int(0, PHP_INT_MAX)
+        };
 
         // Инициализация текста в настройках API
-        $this->robot->api['message'] = $this->text;
+        if (!empty($message ??= $this->text)) $this->robot->api['message'] = $message;
 
-        // Пересылаемые сообщения
+        // Инициализация широты
-        if (!empty($this->forwardMessages)) {
+        if (!empty($lat ??= $this->lat)) $this->robot->api['lat'] = $lat;
 
-            // Инициализация пересылаемых сообщений в настройках API
+        // Инициализация долготы
-            $this->robot->api['forward_messages'] = implode(',', $this->forwardMessages);
+        if (!empty($long ??= $this->long)) $this->robot->api['long'] = $long;
-        }
 
-        // Ответные сообщения
+        // Инициализация вложений
-        if (isset($this->ReplyMessage)) {
+        if (!empty($attachments ??= $this->robot->api->data)) $this->robot->api['attachment'] = implode(',', $attachments);
 
-            // Инициализация идентификатора сообщения на которое обрабатывается ответ в настройках API
+        // Инициализация сообщения, на которое требуется ответить
-            $this->robot->api['reply_to'] = $this->ReplyMessage;
+        if (!empty($reply_to ??= $this->reply_to)) $this->robot->api['reply_to'] = $reply_to;
-        }
 
-        // Вложения
+        // Инициализация пересылаемых сообщений
-        if (isset($this->data) && $this->__get('data') !== []) { // !empty($this->data->data) почемуто не работает
+        if (!empty($forward_messages ??= $this->forward_messages)) $this->robot->api['forward_messages'] = implode(',', $forward_messages);
 
-            // Инициализация вложений в настройках API
+        // Инициализация стикера
-            $this->robot->api['attachment'] = implode(',', $this->__get('data'));
+        if (!empty($sticker_id ??= $this->sticker_id)) $this->robot->api['sticker_id'] = $sticker_id;
-        }
+
+        // Инициализация полезной нагрузки
+        if (!empty($payload ??= $this->payload)) $this->robot->api['payload'] = $payload;
+
+        // Инициализация пользовательского соглашения
+        // $this->robot->api['content_source'] = $this->robot->content_source;
+
+        // Инициализация "не создавать представление ссылки в сообщении?"
+        if ($dont_parse_links || $this->dont_parse_links) $this->robot->api['dont_parse_links'] = 1;
+
+        // Инициализация "отключить уведомление об упоминании в сообщении?"
+        if ($disable_mentions || $this->disable_mentions) $this->robot->api['disable_mentions'] = 1;
+
+        // Инициализация интентов
+        if (!empty($intent ??= $this->intent)) $this->robot->api['intent'] = $intent;
+
+        // Инициализация числа, которое будет использоваться для работы с интентами
+        if (!empty($subscribe_id ??= $this->subscribe_id)) $this->robot->api['subscribe_id'] = $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)) {
+        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->mode >= 2) {
+        if ($this->send_mode === message_send::check) {
-            // Если установлен режим 2 (усиленная проверка отправленного сообщения)
+            // Надёжная доставка сообщения
 
             if (!empty($request["response"])) {
                 // Ответ получен
@@ -177,7 +622,6 @@ final class messages extends method
                 // Запрашиваемые сообщения
                 $this->robot->api['message_ids'] = $request["response"];
 
-                // Запрос
                 if ($this->robot->browser->request('POST', 'messages.getById', ['form_params' => $this->robot->api->settings])['response']['count'] === 0) {
                     // Сообщения не существует
                     //!!!!!!!!!!!!!!!!!!!!!!!!!!!
@@ -185,7 +629,7 @@ final class messages extends method
                     //!!!!!!!!!!!!!!!!!!!!!!!!!
 
                     // Повторная отправка
-                    $this->send($destination);
+                    $this->send();
                 }
             } else {
             }
@@ -195,35 +639,58 @@ final class messages extends method
     }
 
     /**
-     * Записать свойство
+     * Удалить сообщение
      *
-     * @param string $name Название
+     * @see https://dev.vk.com/method/messages.delete
-     * @param mixed $value Значение
      *
-     * @return void
+     * @param int|string|array|null $messages Получатель (message_ids + cmids)
+     * @param int|string|null $peer_id Идентификатор беседы
+     * @param bool $spam Пометить как спам?
+     * @param bool $delete_for_all Удалить для всех?
+     *
+     * @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
+     *
+     * @todo
+     * 1. Переделать под новую версию
+     * 2. Написать обработчик ошибок возвращаемых ВКонтакте
      */
-    public function __set(string $name, mixed $value): void
+    public function delete(string|int|array|null $messages = null, int|string|null $peer_id = null, bool $spam = false, bool $delete_for_all = false): stdClass
     {
-        match ($name) {
+        // Реиницилазиция настроек
-            default => throw new Exception("Свойство $name не найдено", 404)
+        $this->robot->api->reinit();
-        };
-    }
 
-    /**
+        if (isset($peer_id)) {
-     * Прочитать свойство
+            // Получен идентификатор беседы
-     *
+
-     * @param string $name Название
+            // Инициализация идентификатора беседы
-     *
+            $this->robot->api['peer_id'] = $peer_id;
-     * @return mixed
+
-     */
+            // Инициализация идентификаторов сообщений
-    public function __get(string $name): mixed
+            $this->robot->api['cmids'] = $messages;
-    {
+
-        return match ($name) {
+            // Инициализация: "удалить для всех?"
-            'text' => $this->text ?? throw new Exception('Текст не инициализирован'),
+            $this->robot->api['delete_for_all'] = 1;
-            'forward' => empty($this->forward) ? throw new Exception('Сообщения для пересылки не инициализированы') : $this->forward,
+        } else {
-            'reply' => isset($this->reply) ? $this->reply : throw new Exception('Сообщение для ответа не инициализировано'),
+            // Не получен идентификатор беседы
-            default => throw new Exception("Свойство $name не найдено", 404)
+
-        };
+            // Инициализация идентификаторов сообщений
+            $this->robot->api['message_ids'] = $messages;
+
+            // Инициализация: "удалить для всех?"
+            if ($delete_for_all) $this->robot->api['delete_for_all'] = 1;
+        }
+
+        // Инициализация: "сообщить о спаме?"
+        if ($spam) $this->robot->api['spam'] = $spam;
+
+        // Запрос
+        $request = json_decode($this->robot->browser->request('POST', 'messages.delete', ['form_params' => $this->robot->api->settings])->getBody()->getContents());
+
+        // Проверка на наличие ошибок в ответе от ВКонтакте
+        if (isset($request->error)) throw new Exception('ВКонтакте: ' . $request->error->error_msg, $request->error->error_code);
+
+
+        return $request->response;
     }
 
     /**
@@ -232,11 +699,10 @@ final class messages extends method
      * @param string $message_ids Идентификатор сообщения
      *
      * @return object Информация о сообщении
+     *
+     * @todo
+     * 1. Доделать, а лучше полностью переделать
      */
-
-    //!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-    // доделать
-
     public function getById(int $message_ids): object
     {
         // Реиницилазиция
@@ -256,11 +722,153 @@ final class messages extends method
         // Запрос
         $request = json_decode(($this->robot->browser->request('POST', 'messages.getById', ['form_params' => $this->robot->api->settings])->getBody()->getContents()));
 
-        // Если в ответе ошибка
+        // Проверка на наличие ошибок в ответе от ВКонтакте
-        if (isset($request->error)) {
+        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);
-        }
 
         return $request->response;
     }
+
+    /**
+     * Получить историю сообщений
+     *
+     * @see https://dev.vk.com/method/messages.getHistory
+     *
+     * @param ?int $offset Смещение для выбора сообщений
+     * @param ?int $count Количество выбираемых сообщений
+     * @param int|string|null $peer_id Получатель (группа, чат, пользователь и пользователи)
+     * @param ?int $start_message_id Идентификатор сообщения от которого начнётся выборка
+     * @param bool $rev Получить сообщения в хронологичном порядке? (иначе в обратном)
+     * @param bool $extended Получить расширенную информацию об авторах сообщений?
+     * @param ?array $fields Дополнительные запрашиваемые поля (для $extended)
+     *
+     * @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
+     *
+     * @todo Написать обработчик ошибок возвращаемых ВКонтакте
+     */
+    public function getHistory(
+        ?int $offset = null,
+        ?int $count = null,
+        int|string|null $peer_id = null,
+        ?int $start_message_id = null,
+        bool $rev = false,
+        bool $extended = false,
+        ?array $fields = null
+    ): object {
+        // Реиницилазиция
+        $this->robot->api->reinit();
+
+        // Инициализация смещения для выбора сообщений
+        if (!empty($offset ??= $this->offset)) $this->robot->api['offset'] = $offset;
+
+        // Инициализация количества выбираемых сообщений
+        if (!empty($count ??= $this->count)) $this->robot->api['count'] = $count;
+
+        // Инициализация получателя
+        $this->receiver($peer_id);
+
+        // Инициализация идентификатора сообщения от которого начнётся выборка
+        if (!empty($start_message_id ??= $this->start_message_id)) $this->robot->api['start_message_id'] = $start_message_id;
+
+        // Инициализация "получить сообщения в хронологичном порядке?"
+        if ($rev || $this->rev) $this->robot->api['rev'] = 1;
+
+        // Инициализация "получить расширенную информацию об авторах сообщений?"
+        if ($extended || $this->extended) $this->robot->api['extended'] = 1;
+
+        if (!empty($fields ??= $this->fields)) {
+            // Инициализация дополнительных запрашиваемых полей
+
+            // Инициализация значения в буфере запроса к API
+            $this->robot->api['fields'] = '';
+
+            foreach ($fields as $key => $field) {
+                // Перебор дополнительных запрашиваемых полей
+
+                // Запись в буфер запроса к API
+                $this->robot->api['fields'] .= $field;
+
+                // Запись разделителя
+                if ($key !== array_key_last($fields)) $this->robot->api['fields'] .= ', ';
+            }
+        }
+
+        // Запрос
+        $request = json_decode(($this->robot->browser->request('POST', 'messages.getHistory', ['form_params' => $this->robot->api->settings])->getBody()->getContents()));
+
+        // Проверка на наличие ошибок в ответе от ВКонтакте
+        if (isset($request->error)) throw new Exception('ВКонтакте: ' . $request->error->error_msg, $request->error->error_code);
+
+        return $request->response;
+    }
+
+    /**
+     * Записать свойство
+     *
+     * @param string $name Название
+     * @param mixed $value Значение
+     *
+     * @return void
+     */
+    public function __set(string $name, mixed $value): void
+    {
+        match ($name) {
+            'send_mode' => $this->send_mode = $value,
+            'generate_mode' => $this->generate_mode = $value,
+            'peer_id', 'destination' => $this->peer_id = $value,
+            'text' => $this->text = $value,
+            'lat', 'latitude' => $this->lat = $value,
+            'long', 'longitude' => $this->long = $value,
+            'reply_to', 'reply', 'to' => $this->reply_to = $value,
+            'forward_messages' => $this->forward_messages = $value,
+            'sticker_id', 'sticker' => $this->sticker_id = $value,
+            'payload' => $this->payload = $value,
+            'dont_parse_links' => $this->dont_parse_links = $value,
+            'parse_links', 'parse' => $this->dont_parse_links = !$value,
+            'disable_mentions' => $this->disable_mentions = $value,
+            'mentions' => $this->disable_mentions = !$value,
+            'intent' => $this->intent = $value,
+            'subscribe_id' => $this->subscribe_id = $value,
+            'offset' => $this->offset = $value,
+            'count', 'amount' => $this->count = $value,
+            'start_message_id' => $this->start_message_id = $value,
+            'rev' => $this->rev = $value,
+            'extended' => $this->extended = $value,
+            'fields' => $this->fields = $value,
+            default => throw new Exception("Свойство $name не найдено", 404)
+        };
+    }
+
+    /**
+     * Прочитать свойство
+     *
+     * @param string $name Название
+     *
+     * @return mixed
+     */
+    public function __get(string $name): mixed
+    {
+        return match ($name) {
+            'send_mode' => $this->send_mode,
+            'generate_mode' => $this->generate_mode,
+            'peer_id', 'destination' => $this->peer_id,
+            'text' => $this->text,
+            'lat', 'latitude' => $this->lat,
+            'long', 'longitude' => $this->long,
+            'reply_to', 'reply', 'to' => $this->reply_to,
+            'forward_messages' => $this->forward_messages,
+            'sticker_id', 'sticker' => $this->sticker_id,
+            'payload' => $this->payload,
+            'dont_parse_links', 'parse_links', 'parse' => $this->dont_parse_links,
+            'disable_mentions', 'mentions' => $this->disable_mentions,
+            'intent' => $this->intent,
+            'subscribe_id' => $this->subscribe_id,
+            'offset' => $this->offset,
+            'count', 'amount' => $this->count,
+            'start_message_id' => $this->start_message_id,
+            'rev' => $this->rev,
+            'extended' => $this->extended,
+            'fields' => $this->fields,
+            default => throw new Exception("Свойство $name не найдено", 404)
+        };
+    }
 }

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

@@ -4,58 +4,12 @@ declare(strict_types=1);
 
 namespace mirzaev\vk\api\methods;
 
-use mirzaev\vk\robots\robot;
-
 /**
- * Абстракция метода API
+ * Абстракция метода API ВКонтакте
- *
- * @method protected static put(string $url, ...$params) Создать
- * @method protected static post(string $url, ...$params) Изменить
- * @method protected static get(string $url, ...$params) Получить
- * @method protected static delete(string $url, ...$params) Удалить
  *
  * @package mirzaev\vk\api\methods
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 abstract class method
 {
-    /**
-     * Создать
-     *
-     * @return array Ответ сервера
-     */
-    public static function put(): array
-    {
-        return ['error' => 'Метод не поддерживается'];
-    }
-
-    /**
-     * Изменить
-     *
-     * @return array Ответ сервера
-     */
-    public static function post(): array
-    {
-        return ['error' => 'Метод не поддерживается'];
-    }
-
-    /**
-     * Получить
-     *
-     * @return array Ответ сервера
-     */
-    public static function get(): array
-    {
-        return ['error' => 'Метод не поддерживается'];
-    }
-
-    /**
-     * Удалить
-     *
-     * @return array Ответ сервера
-     */
-    public static function delete(): array
-    {
-        return ['error' => 'Метод не поддерживается'];
-    }
 }

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;
 
 /**
  * Фотографии (изображения)
@@ -20,14 +20,14 @@ use mirzaev\accounts\vk as account;
  * @see https://vk.com/dev/messages.getById
  *
  * @package mirzaev\vk\api\methods
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  *
- * @todo Добавить обработку ошибок ($request['errors];)
+ * @todo Добавить обработку ошибок ($request['errors])
  */
 final class photos extends method
 {
     /**
-     * Создать сообщение
+     * Конструктор
      *
      * @param robot $robot Робот
      */

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

@@ -0,0 +1,113 @@
+<?php
+
+declare(strict_types=1);
+
+namespace mirzaev\vk\api\methods;
+
+// Файлы проекта
+use mirzaev\vk\robots\robot;
+
+// Встроенные библиотеки
+use Exception,
+    stdClass;
+
+/**
+ * Пользователь
+ *
+ *
+ * @see https://dev.vk.com/method/users
+ *
+ * @package mirzaev\vk\api
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
+ */
+final class users extends method
+{
+    /**
+     * Конструктор
+     *
+     * @param robot $user Робот
+     */
+    public function __construct(
+        protected robot $robot
+    ) {
+    }
+
+    /**
+     * Запросить информацию о пользователе
+     *
+     * @see https://dev.vk.com/method/users.get
+     *
+     * @param array $receiver Выбор пользователей для запроса информации (user_ids)
+     * @param array $fields Дополнительные запрашиваемые поля
+     * @param string $name_case Падеж
+     *
+     * @return stdClass|array|null Информация об аккаунте или массив с информацией об аккаунтах, если найдена
+     *
+     * @todo
+     * 1. Доделать
+     * 2. Написать обработчик ошибок возвращаемых ВКонтакте
+     */
+    public function get(int|string|array $receiver = [], array $fields = [], ?string $name_case = null): stdClass|array|null
+    {
+        // Реиницилазиция
+        $this->robot->api->reinit();
+
+        if (is_int($receiver)) {
+            // Идентификатор
+
+            // Инициализация пользователя
+            $this->robot->api['user_ids'] = $receiver;
+        } else if (is_array($receiver)) {
+            // Идентификаторы
+
+            // Инициализация пользователей
+            $this->robot->api['user_ids'] = '';
+
+            foreach ($receiver as $key => $user_id) {
+                // Перебор пользователей для получения информации
+
+                // Запись пользователя
+                $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)) {
+            // Запрошены дополнительные запрашиваемые поля
+
+            // Инициализация дополнительных запрашиваемых полей
+            $this->robot->api['fields'] = '';
+
+            foreach ($fields as $key => $field) {
+                // Перебор дополнительных запрашиваемых полей
+
+                // Запись запрашиваемого дополнительного поля
+                $this->robot->api['fields'] .= $field;
+
+                // Запись разделителя
+                if ($key !== array_key_last($fields)) $this->robot->api['fields'] .= ', ';
+            }
+        }
+
+        // Инициализация падежа
+        if (isset($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());
+
+        // Если в ответе ошибка
+        if (isset($request->error)) {
+            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);
+    }
+}

mirzaev/vk/system/api/settings.php

@@ -17,11 +17,8 @@ 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 <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 class settings implements ArrayAccess
 {
@@ -30,7 +27,7 @@ class settings implements ArrayAccess
      *
      * Должна иметь тип string потому, что PHP при стандартных настройках удаляет нули у float
      */
-    protected const VK_API_VERSION_DEFAULT = '5.130';
+    protected const VK_API_VERSION_DEFAULT = '5.131';
 
     /**
      * Конструктор
@@ -145,36 +142,6 @@ class settings implements ArrayAccess
         return $this;
     }
 
-    /**
-     * Инициализация получателя
-     *
-     * @see mirzaev\vk\api\methods\messages Сообщения
-     */
-    public function destination(string|array|int $target): self
-    {
-        if (is_int($target)) {
-            // Идентификатор
-
-            $this->settings['peer_id'] = $target;
-
-            return $this;
-        } else if (is_array($target)) {
-            // Идентификаторы
-
-            $this->settings['user_ids'] = $target;
-
-            return $this;
-        } else if (is_string($target)) {
-            // Домен
-
-            $this->settings['domain'] = $target;
-
-            return $this;
-        }
-
-        throw new Exception('Не удалось определить получателя', 500);
-    }
-
     /**
      * Записать свойство
      *
@@ -206,20 +173,44 @@ class settings implements ArrayAccess
         };
     }
 
-    // public function __unset(string $name): void
+    /**
-    // {
+     * Проверить инициализированность свойства
-    //     match ($name) {
+     *
-    //         'settings' => throw new Exception('Запрещено удалять настройки', 500),
+     * @param string $name Название
-    //         'robot' =>  throw new Exception('Запрещено удалять робота', 500),
+     *
-    //         'data', 'attachments' => $this->offsetUnset('attachments'),
+     * @return bool Свойство инициализировано?
-    //         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)
+        };
+    }
 
     /**
      * Записать по смещению
      */
-    public function offsetSet(mixed $offset, mixed $value): mixed
+    public function offsetSet(mixed $offset, mixed $value): void
     {
         if (isset($this->settings)) {
             if (strcasecmp($offset, 'settings') === 0) {
@@ -236,21 +227,27 @@ class settings implements ArrayAccess
                 if (is_array($value)) {
                     // Жесткая запись
 
-                    return $this->settings['attachments'] = $value;
+                    $this->settings['attachments'] = $value;
+
+                    return;
                 }
 
                 if (empty($this->settings['attachments']) || count($this->settings['attachments']) < 10) {
                     // Записано менее чем 10 вложений (от 0 до 9)
 
                     // Запись (конкатенация)
-                    return $this->settings['attachments'][] = $value;
+                    $this->settings['attachments'][] = $value;
+
+                    return;
                 }
 
                 throw new Exception('Превышено ограничение на 10 вложений', 500);
             } else {
                 // Запись по ключу или смещению
 
-                return $this->settings[$offset] = $value;
+                $this->settings[$offset] = $value;
+
+                return;
             }
         }
 
@@ -260,7 +257,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) {
@@ -284,7 +281,11 @@ class settings implements ArrayAccess
     }
 
     /**
-     * Проверка существования смещения
+     * Проверить существование смещения
+     *
+     * @param mixed $offset Сдвиг
+     *
+     * @return bool Смещение существует?
      */
     public function offsetExists(mixed $offset): bool
     {

mirzaev/vk/system/core.php

@@ -24,7 +24,7 @@ use exception;
  * @method public function get($id = null) Чтение из реестра
  *
  * @package mirzaev\vk
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class core
 {
@@ -45,22 +45,22 @@ final class core
      *
      * Используется в логировании
      */
-    private string $timezone;
+    private readonly string $timezone;
 
     /**
      * Путь до корня проекта
      */
-    private string $path_root;
+    private readonly string $path_root;
 
     /**
      * Путь до папки журналов
      */
-    private string $path_logs;
+    private readonly string $path_logs;
 
     /**
      * Путь до временной папки
      */
-    private string $path_temp;
+    private readonly string $path_temp;
 
     /**
      * Запись в журнал

mirzaev/vk/system/loggers/jasmo.php

@@ -21,7 +21,7 @@ use mirzaev\vk\core,
  * @see Jasny\ErrorHandler
  *
  * @package mirzaev\vk\loggers
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class jasmo extends logger
 {

mirzaev/vk/system/loggers/logger.php

@@ -8,7 +8,7 @@ namespace mirzaev\vk\loggers;
  * Абстрактный класс журналиста
  *
  * @package mirzaev\vk\loggers
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 abstract class logger
 {

mirzaev/vk/system/robots/group.php

@@ -22,7 +22,7 @@ use mirzaev\vk\robots\robot,
  * @method public function __isset($name) Проверка на инициализированность свойства
  *
  * @package mirzaev\vk\robots
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class group extends robot
 {
@@ -38,8 +38,8 @@ final class group extends robot
      * @param string|null $key Ключ
      */
     public function __construct(
-        protected int|null $id = null,
+        protected ?int $id = null,
-        protected string|null $key = null
+        protected ?string $key = null
     ) {
         parent::__construct($id, $key);
 

mirzaev/vk/system/robots/robot.php

@@ -39,39 +39,39 @@ use GuzzleHttp\Client as browser;
  * @method public function __toString() Конвертация в строку
  *
  * @package mirzaev\vk\robots
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 abstract class robot
 {
     /**
-     * Сессия
+     * @var int $session Сессия
      */
-    protected int $session;
+    protected readonly int $session;
 
     /**
-     * Аккаунт
+     * @var account $account Аккаунт ВКонтакте
      */
-    private account $account;
+    private readonly account $account;
 
     /**
-     * $messages_mode Режим отправки сообщений
+     * @var api $api API ВКонтакте
      */
-    protected int $messages_mode = 1;
+    protected readonly api $api;
 
     /**
-     * @var api API ВКонтакте
+     * @var browser $browser Браузер
      */
-    protected api $api;
+    protected readonly browser $browser;
 
     /**
      * Конструктор
      *
-     * @param int|null $id Идентификатор
+     * @param int|null $id Идентификатор робота
-     * @param string|null $key Ключ
+     * @param string|null $key Ключ API ВКонтакте
      */
     public function __construct(
-        protected int|null $id = null,
+        protected ?int $id = null,
-        protected string|null $key = null
+        protected ?string $key = null
     ) {
         // Инициализация ядра
         $core = core::init();
@@ -89,7 +89,6 @@ abstract class robot
         $this->api();
     }
 
-
     /**
      * Инициализация ключа
      *
@@ -183,14 +182,13 @@ abstract class robot
     public function __set(string $name, mixed $value): void
     {
         match ($name) {
-            'id' => isset($this->id) ? throw new Exception('Запрещено перезаписывать идентификатор', 500) : $this->id = (int) $value,
+            'id' => empty($this->id) ?: $this->id = $value,
-            'session' => isset($this->session) ? throw new Exception('Запрещено перезаписывать сессию', 500) : $this->session = (int) $value,
+            'session' => empty($this->session) ?: $this->session = $value,
             'key' => $this->key((string) $value),
             'account' => $this->account($value),
             'api' => $this->api(),
-            'browser' => isset($this->browser) ? throw new Exception('Запрещено перезаписывать браузер', 500) : $this->browser = $value,
+            'browser' => empty($this->browser) ?: $this->browser = $value,
-            'messages_new' => $this->messages_new = (int) $value,
+            'messages_new' => $this->messages_new = (int) $value
-            default => throw new Exception("Свойство $name не найдено", 404)
         };
     }
 
@@ -219,23 +217,16 @@ abstract class robot
     }
 
     /**
-     * Проверить свойство на инициализированность
+     * Проверить на инициализированность
      *
-     * @param string $name Название
+     * @param mixed $name Название
-     *
-     * @return mixed
      */
     public function __isset(string $name): bool
     {
         return match ($name) {
             'id' => isset($this->id),
-            'session' => isset($this->session),
             'key' => isset($this->key),
-            'account' => isset($this->account),
+            default => false
-            'api' => isset($this->api),
-            'browser' => isset($this->browser),
-            'messages_new' => isset($this->messages_new),
-            default => throw new Exception("Свойство $name не найдено", 404)
         };
     }
 
@@ -289,4 +280,14 @@ abstract class robot
     {
         return (string) $this->id;
     }
+
+    /**
+     * Клонировать объект
+     *
+     * @return void
+     */
+    public function __clone(): void {
+        // Инициализация робота
+        $this->__construct($this->id, $this->key);
+    }
 }

mirzaev/vk/system/robots/user.php

@@ -12,7 +12,7 @@ use mirzaev\accounts\vk as account;
  * Робот-пользователь
  *
  * @package mirzaev\vk\robots
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class user extends robot
 {
@@ -23,8 +23,8 @@ final class user extends robot
      * @param string|null $key Ключ
      */
     public function __construct(
-        protected int|null $id = null,
+        protected readonly int|null $id = null,
-        protected string|null $key = null
+        protected readonly string|null $key = null
     ) {
         parent::__construct($id, $key);