Добавлено: удаление сообщений, информация об аккаунте и профиле

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,15 @@ declare(strict_types=1);
 
 namespace mirzaev\vk\api\methods;
 
-use Exception;
+// Файлы проекта
+use mirzaev\accounts\vk,
+    mirzaev\vk\robots\robot,
+    mirzaev\vk\api\data,
+    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;
 
 /**
  * Режимы отправки сообщений
@@ -57,18 +60,18 @@ final class messages extends method
      * Конструктор
      *
      * @param robot $robot Робот
-     * @param int|string|array|null $destination Получатель
+     * @param int|string|array|null $receiver Получатель
      * @param string|null $text Текст
      */
     public function __construct(
         protected robot $robot,
-        int|string|array|null $destination = null,
+        int|string|array|null $receiver = null,
         protected string|null $text = null
     ) {
-        if (isset($this->text, $destination)) {
+        if (isset($this->text, $receiver)) {
             // Быстрая отправка
 
-            $this->send($destination);
+            $this->send($receiver);
         }
     }
 
@@ -120,13 +123,13 @@ final class messages extends method
      *
      * @see https://vk.com/dev/messages.send
      *
-     * @param int|string|array|null $destination Получатель
+     * @param int|string|array|null $receiver Получатель
      *
      * @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
      *
      * @todo Написать обработчик ошибок возвращаемых ВКонтакте
      */
-    public function send(int|string|array|null $destination): int|array
+    public function send(int|string|array|null $receiver): int|array
     {
         // Идентификатор
         $random_id = time();
@@ -140,8 +143,22 @@ final class messages extends method
         // Реиницилазиция
         $this->robot->api->reinit();
 
-        // Цель отправки
+        if (is_int($receiver)) {
-        $this->robot->api->destination($destination);
+            // Идентификатор
+
+            // Инициализация получателя
+            $this->robot->api['peer_id'] = $receiver;
+        } else if (is_array($receiver)) {
+            // Идентификаторы
+
+            // Инициализация получателя
+            $this->robot->api['user_ids'] = $receiver;
+        } else if (is_string($receiver)) {
+            // Домен
+
+            // Инициализация получателя
+            $this->robot->api['domain'] = $receiver;
+        }
 
         // Инициализация идентификатора сообщения (защита от повторных отправок) в настройках API
         $this->robot->api['random_id'] = $random_id;
@@ -197,7 +214,7 @@ final class messages extends method
                     //!!!!!!!!!!!!!!!!!!!!!!!!!
 
                     // Повторная отправка
-                    $this->send($destination);
+                    $this->send($receiver);
                 }
             } else {
             }
@@ -206,6 +223,59 @@ final class messages extends method
         return $request->response;
     }
 
+    /**
+     * Удалить сообщение
+     *
+     * @see https://vk.com/dev/messages.delete
+     *
+     * @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 Написать обработчик ошибок возвращаемых ВКонтакте
+     */
+    public function delete(string|int|array|null $messages = null, int|string|null $peer_id = null, bool $spam = false, bool $delete_for_all = false): stdClass
+    {
+        // Реиницилазиция настроек
+        $this->robot->api->reinit();
+
+        if (isset($peer_id)) {
+            // Получен идентификатор беседы
+
+            // Инициализация идентификатора беседы
+            $this->robot->api['peer_id'] = $peer_id;
+
+            // Инициализация идентификаторов сообщений
+            $this->robot->api['cmids'] = $messages;
+
+            // Инициализация: "удалить для всех?"
+            $this->robot->api['delete_for_all'] = 1;
+        } else {
+            // Не получен идентификатор беседы
+
+            // Инициализация идентификаторов сообщений
+            $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;
+    }
+
     /**
      * Записать свойство
      *

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 <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

@@ -27,7 +27,7 @@ use mirzaev\accounts\vk as account;
 final class photos extends method
 {
     /**
-     * Создать сообщение
+     * Конструктор
      *
      * @param robot $robot Робот
      */

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

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

mirzaev/vk/system/api/settings.php

@@ -145,36 +145,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);
-    }
-
     /**
      * Записать свойство
      *