Compare commits
No commits in common. "stable" and "3.4.x" have entirely different histories.
|
|
@ -1,3 +1 @@
|
|||
!.gitignore
|
||||
composer.phar
|
||||
vendor
|
||||
/vendor
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
# PHP-фреймворк ВКонтакте
|
||||
Многопоточный фреймворк с поддержкой всех возможностей API ВКонтакте
|
||||
# Колпачный фреймворк для ВКонтакте
|
||||
Развивается как многопоточный фреймворк с поддержкой всех возможностей API ВКонтакте, а так же не добавленных, но необходимых функций, работу с большим количеством роботов под разными сессиями, поддерживающий PSR-спецификацию и полностью покрытый тестами
|
||||
|
||||
### Установка:
|
||||
```sh
|
||||
|
|
|
|||
|
|
@ -1,39 +1,35 @@
|
|||
{
|
||||
"name": "mirzaev/vk",
|
||||
"type": "framework",
|
||||
"description": "Framework for vk.com API",
|
||||
"readme": "README.md",
|
||||
"description": "Фреймворк VK API",
|
||||
"keywords": [
|
||||
"vk",
|
||||
"api"
|
||||
],
|
||||
"homepage": "https://git.mirzaev.sexy/mirzaev/vk",
|
||||
"homepage": "https://git.hood.su/mirzaev/vk",
|
||||
"license": "WTFPL",
|
||||
"authors": [
|
||||
{
|
||||
"name": "Arsen Mirzaev Tatyano-Muradovich",
|
||||
"email": "arsen@mirzaev.sexy",
|
||||
"homepage": "https://mirzaev.sexy/mirzaev",
|
||||
"email": "red@hood.su",
|
||||
"homepage": "https://hood.su/mirzaev",
|
||||
"role": "Programmer"
|
||||
}
|
||||
],
|
||||
"support": {
|
||||
"docs": "https://git.mirzaev.sexy/mirzaev/vk/wiki",
|
||||
"issues": "https://git.mirzaev.sexy/mirzaev/vk/issues"
|
||||
"docs": "https://git.hood.su/mirzaev/vk/manual",
|
||||
"issues": "https://git.hood.su/mirzaev/vk/issues"
|
||||
},
|
||||
"require": {
|
||||
"php": "^8.1",
|
||||
"psr/log": "^1.0",
|
||||
"mirzaev/accounts": "^1.2.0",
|
||||
"monolog/monolog": "^1.6",
|
||||
"jasny/error-handler": "^0.2",
|
||||
"guzzlehttp/guzzle": "^7.5"
|
||||
"php": "~8.0",
|
||||
"psr/log": "~1.0",
|
||||
"mirzaev/accounts": "~0.1.x-dev",
|
||||
"monolog/monolog": "~1.6",
|
||||
"jasny/error-handler": "~0.2",
|
||||
"guzzlehttp/guzzle": "~7.2"
|
||||
},
|
||||
"require-dev": {
|
||||
"phpunit/phpunit": "^9.5"
|
||||
},
|
||||
"suggest": {
|
||||
"ext-sodium": "Can be selected in some conditions to increase security"
|
||||
"phpunit/phpunit": "~9.5"
|
||||
},
|
||||
"autoload": {
|
||||
"psr-4": {
|
||||
|
|
|
|||
File diff suppressed because it is too large
Load Diff
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
// declare(strict_types=1);
|
||||
|
||||
// namespace mirzaev\vk\API;
|
||||
// namespace Hood\VK\API;
|
||||
|
||||
// class CallBack extends CallBackAbstract
|
||||
// {
|
||||
|
|
|
|||
|
|
@ -7,8 +7,7 @@ namespace mirzaev\vk\api;
|
|||
use Exception;
|
||||
|
||||
use mirzaev\vk\core,
|
||||
mirzaev\vk\robots\robot,
|
||||
mirzaev\vk\robots\group;
|
||||
mirzaev\vk\robots\robot;
|
||||
|
||||
/**
|
||||
* LongPoll
|
||||
|
|
@ -26,7 +25,7 @@ use mirzaev\vk\core,
|
|||
* @see https://vk.com/dev/groups.setLongPollSettings
|
||||
*
|
||||
* @package mirzaev\vk\api
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*
|
||||
* @todo Добавить обработку ошибок ($request['errors];)
|
||||
*/
|
||||
|
|
@ -37,14 +36,14 @@ final class longpoll
|
|||
*
|
||||
* @see $this->get()
|
||||
*/
|
||||
private readonly string $key;
|
||||
private string $key;
|
||||
|
||||
/**
|
||||
* Сервер (URL)
|
||||
*
|
||||
* @see $this->get()
|
||||
*/
|
||||
private readonly string $server;
|
||||
private string $server;
|
||||
|
||||
/**
|
||||
* Идентификатор последнего события
|
||||
|
|
@ -60,7 +59,7 @@ final class longpoll
|
|||
*
|
||||
* $robot Робот
|
||||
*/
|
||||
public function __construct(private robot&group $robot)
|
||||
public function __construct(private robot $robot)
|
||||
{
|
||||
// Инициализация
|
||||
if (empty($robot->id)) throw new Exception('Необходимо указать идентификатор ВКонтакте');
|
||||
|
|
|
|||
|
|
@ -1,115 +0,0 @@
|
|||
<?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;
|
||||
}
|
||||
}
|
||||
|
|
@ -4,40 +4,12 @@ declare(strict_types=1);
|
|||
|
||||
namespace mirzaev\vk\api\methods;
|
||||
|
||||
// Файлы проекта
|
||||
use mirzaev\vk\robots\robot,
|
||||
mirzaev\vk\robots\group;
|
||||
use Exception;
|
||||
|
||||
// Встроенные библиотеки
|
||||
use stdClass,
|
||||
Exception;
|
||||
|
||||
/**
|
||||
* Режимы отправки сообщений
|
||||
*/
|
||||
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;
|
||||
}
|
||||
use mirzaev\accounts\vk;
|
||||
use mirzaev\vk\robots\robot;
|
||||
use mirzaev\vk\api\data;
|
||||
use mirzaev\vk\robots\group;
|
||||
|
||||
/**
|
||||
* Сообщение
|
||||
|
|
@ -48,570 +20,153 @@ enum random_id
|
|||
* @see https://vk.com/dev/messages.getById
|
||||
*
|
||||
* @package mirzaev\vk\api
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*
|
||||
* @todo Доработать строгий режим отправки: проверку сообщения в беседе (не имеет ID сообщений)
|
||||
*/
|
||||
final class messages extends method
|
||||
{
|
||||
/**
|
||||
* @var message_send $send_mode Режим отправки сообщений
|
||||
* @var int $mode Режим отправки
|
||||
*/
|
||||
protected message_send $send_mode = message_send::simple;
|
||||
protected int $mode = 1;
|
||||
|
||||
/**
|
||||
* @var random_id $generate_mode Режим генерации идентификатора сессии доставки сообщения
|
||||
* @var array[int] Сообщения для пересылки
|
||||
*/
|
||||
protected random_id $generate_mode = random_id::crypto;
|
||||
protected array $forward;
|
||||
|
||||
/**
|
||||
* @var int|string|array|null $peer_id Получатель
|
||||
* @var int Сообщение для ответа
|
||||
*/
|
||||
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;
|
||||
protected int $reply;
|
||||
|
||||
/**
|
||||
* Конструктор
|
||||
*
|
||||
* @param robot $robot Робот
|
||||
*/
|
||||
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 int|string|array|null $destination Получатель
|
||||
* @param string|null $text Текст
|
||||
*
|
||||
* @return static
|
||||
*/
|
||||
public function text(string|null $text): static
|
||||
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 Текст
|
||||
*/
|
||||
public function text(string $text): self
|
||||
{
|
||||
// Запись в свойство
|
||||
$this->__set('text', $text);
|
||||
// Записать текст
|
||||
if (!isset($this->text)) {
|
||||
$this->text = $text;
|
||||
} else {
|
||||
$this->text .= $text;
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Записать: географическая ширина
|
||||
* Записать сообщения для пересылки
|
||||
*
|
||||
* @param ?int $lat Географическая ширина
|
||||
*
|
||||
* @return static
|
||||
* @param $ids Идентификаторы сообщений
|
||||
*/
|
||||
public function lat(?int $lat): static
|
||||
public function forward(...$ids): self
|
||||
{
|
||||
// Запись в свойство
|
||||
$this->__set('lat', $lat);
|
||||
// Запись
|
||||
$this->forward = array_merge($this->forward ?? [], $ids);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Записать: географическая долгота
|
||||
* Записать сообщение для ответа
|
||||
*
|
||||
* @param ?int $long Географическая долгота
|
||||
*
|
||||
* @return static
|
||||
* @param $id Идентификатор сообщения
|
||||
*/
|
||||
public function long(?int $long): static
|
||||
public function reply(int $id): self
|
||||
{
|
||||
// Запись в свойство
|
||||
$this->__set('long', $long);
|
||||
// Запись
|
||||
$this->reply = $id;
|
||||
|
||||
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://dev.vk.com/method/messages.send
|
||||
* @see https://vk.com/dev/messages.send
|
||||
*
|
||||
* @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 Идентификатор сессии доставки сообщения (защита от повторных отправок)
|
||||
* @param int|string|array|null $destination Получатель
|
||||
*
|
||||
* @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
|
||||
*
|
||||
* @todo
|
||||
* 1. Написать обработчик ошибок возвращаемых ВКонтакте
|
||||
* 2. Добавить параметр forward (не путать с forward_messages)
|
||||
* 3. Добавить клавиатуру
|
||||
* 4. Добавить шаблоны сообщений
|
||||
* 5. Добавить content_source
|
||||
* @todo Написать обработчик ошибок возвращаемых ВКонтакте
|
||||
*/
|
||||
public function send(
|
||||
int|string|null $peer_id = null,
|
||||
?string $message = null,
|
||||
?int $lat = null,
|
||||
?int $long = null,
|
||||
?array $attachments = null,
|
||||
?int $reply_to = null,
|
||||
?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 {
|
||||
// Реинициализация настроек
|
||||
public function send(int|string|array|null $destination): int|array
|
||||
{
|
||||
// Идентификатор
|
||||
$random_id = time();
|
||||
|
||||
if ($this->mode = 1) {
|
||||
// Перемножение (по умолчанию)
|
||||
$random_id *= rand();
|
||||
}
|
||||
|
||||
// Реиницилазиция
|
||||
$this->robot->api->reinit();
|
||||
|
||||
// Инициализация получателя
|
||||
$this->receiver($peer_id);
|
||||
// Цель отправки
|
||||
$this->robot->api->destination($destination);
|
||||
|
||||
// Инициализация идентификатора сессии доставки сообщения (защита от повторных отправок)
|
||||
$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['random_id'] = $random_id;
|
||||
|
||||
// Инициализация текста в настройках API
|
||||
if (!empty($message ??= $this->text)) $this->robot->api['message'] = $message;
|
||||
$this->robot->api['message'] = $this->text;
|
||||
|
||||
// Инициализация широты
|
||||
if (!empty($lat ??= $this->lat)) $this->robot->api['lat'] = $lat;
|
||||
// Пересылаемые сообщения
|
||||
if (!empty($this->forwardMessages)) {
|
||||
|
||||
// Инициализация долготы
|
||||
if (!empty($long ??= $this->long)) $this->robot->api['long'] = $long;
|
||||
// Инициализация пересылаемых сообщений в настройках API
|
||||
$this->robot->api['forward_messages'] = implode(',', $this->forwardMessages);
|
||||
}
|
||||
|
||||
// Инициализация вложений
|
||||
if (!empty($attachments ??= $this->robot->api->data)) $this->robot->api['attachment'] = implode(',', $attachments);
|
||||
// Ответные сообщения
|
||||
if (isset($this->ReplyMessage)) {
|
||||
|
||||
// Инициализация сообщения, на которое требуется ответить
|
||||
if (!empty($reply_to ??= $this->reply_to)) $this->robot->api['reply_to'] = $reply_to;
|
||||
// Инициализация идентификатора сообщения на которое обрабатывается ответ в настройках API
|
||||
$this->robot->api['reply_to'] = $this->ReplyMessage;
|
||||
}
|
||||
|
||||
// Инициализация пересылаемых сообщений
|
||||
if (!empty($forward_messages ??= $this->forward_messages)) $this->robot->api['forward_messages'] = implode(',', $forward_messages);
|
||||
// Вложения
|
||||
if (isset($this->data) && $this->__get('data') !== []) { // !empty($this->data->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('Сообщение должно содержать текст, либо вложение');
|
||||
// Инициализация вложений в настройках API
|
||||
$this->robot->api['attachment'] = implode(',', $this->__get('data'));
|
||||
}
|
||||
|
||||
// Запрос
|
||||
$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);
|
||||
// Если в ответе ошибка
|
||||
if (isset($request->error)) {
|
||||
throw new Exception('Вконтакте: ' . $request->error->error_msg, $request->error->error_code);
|
||||
}
|
||||
|
||||
if ($this->send_mode === message_send::check) {
|
||||
// Надёжная доставка сообщения
|
||||
if ($this->mode >= 2) {
|
||||
// Если установлен режим 2 (усиленная проверка отправленного сообщения)
|
||||
|
||||
if (!empty($request["response"])) {
|
||||
// Ответ получен
|
||||
|
|
@ -622,6 +177,7 @@ 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) {
|
||||
// Сообщения не существует
|
||||
//!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||
|
|
@ -629,7 +185,7 @@ final class messages extends method
|
|||
//!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||
|
||||
// Повторная отправка
|
||||
$this->send();
|
||||
$this->send($destination);
|
||||
}
|
||||
} else {
|
||||
}
|
||||
|
|
@ -639,58 +195,35 @@ final class messages extends method
|
|||
}
|
||||
|
||||
/**
|
||||
* Удалить сообщение
|
||||
* Записать свойство
|
||||
*
|
||||
* @see https://dev.vk.com/method/messages.delete
|
||||
* @param string $name Название
|
||||
* @param mixed $value Значение
|
||||
*
|
||||
* @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. Написать обработчик ошибок возвращаемых ВКонтакте
|
||||
* @return 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
|
||||
public function __set(string $name, mixed $value): void
|
||||
{
|
||||
// Реиницилазиция настроек
|
||||
$this->robot->api->reinit();
|
||||
match ($name) {
|
||||
default => throw new Exception("Свойство $name не найдено", 404)
|
||||
};
|
||||
}
|
||||
|
||||
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;
|
||||
/**
|
||||
* Прочитать свойство
|
||||
*
|
||||
* @param string $name Название
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
public function __get(string $name): mixed
|
||||
{
|
||||
return match ($name) {
|
||||
'text' => $this->text ?? throw new Exception('Текст не инициализирован'),
|
||||
'forward' => empty($this->forward) ? throw new Exception('Сообщения для пересылки не инициализированы') : $this->forward,
|
||||
'reply' => isset($this->reply) ? $this->reply : throw new Exception('Сообщение для ответа не инициализировано'),
|
||||
default => throw new Exception("Свойство $name не найдено", 404)
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
|
|
@ -699,10 +232,11 @@ final class messages extends method
|
|||
* @param string $message_ids Идентификатор сообщения
|
||||
*
|
||||
* @return object Информация о сообщении
|
||||
*
|
||||
* @todo
|
||||
* 1. Доделать, а лучше полностью переделать
|
||||
*/
|
||||
|
||||
//!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||
// доделать
|
||||
|
||||
public function getById(int $message_ids): object
|
||||
{
|
||||
// Реиницилазиция
|
||||
|
|
@ -722,153 +256,11 @@ 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)) 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'] .= ', ';
|
||||
}
|
||||
// Если в ответе ошибка
|
||||
if (isset($request->error)) {
|
||||
throw new Exception('Вконтакте: ' . $request->error->error_msg, $request->error->error_code);
|
||||
}
|
||||
|
||||
// Запрос
|
||||
$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)
|
||||
};
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -4,12 +4,58 @@ 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>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*/
|
||||
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' => 'Метод не поддерживается'];
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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 Exception;
|
||||
use mirzaev\accounts\vk as account;
|
||||
|
||||
/**
|
||||
* Фотографии (изображения)
|
||||
|
|
@ -20,14 +20,14 @@ use Exception;
|
|||
* @see https://vk.com/dev/messages.getById
|
||||
*
|
||||
* @package mirzaev\vk\api\methods
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*
|
||||
* @todo Добавить обработку ошибок ($request['errors])
|
||||
* @todo Добавить обработку ошибок ($request['errors];)
|
||||
*/
|
||||
final class photos extends method
|
||||
{
|
||||
/**
|
||||
* Конструктор
|
||||
* Создать сообщение
|
||||
*
|
||||
* @param robot $robot Робот
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -1,113 +0,0 @@
|
|||
<?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);
|
||||
}
|
||||
}
|
||||
|
|
@ -17,8 +17,11 @@ 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>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*/
|
||||
class settings implements ArrayAccess
|
||||
{
|
||||
|
|
@ -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';
|
||||
|
||||
/**
|
||||
* Конструктор
|
||||
|
|
@ -142,6 +145,36 @@ 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);
|
||||
}
|
||||
|
||||
/**
|
||||
* Записать свойство
|
||||
*
|
||||
|
|
@ -173,44 +206,20 @@ class settings implements ArrayAccess
|
|||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Проверить инициализированность свойства
|
||||
*
|
||||
* @param string $name Название
|
||||
*
|
||||
* @return bool Свойство инициализировано?
|
||||
*/
|
||||
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 __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): void
|
||||
public function offsetSet(mixed $offset, mixed $value): mixed
|
||||
{
|
||||
if (isset($this->settings)) {
|
||||
if (strcasecmp($offset, 'settings') === 0) {
|
||||
|
|
@ -227,27 +236,21 @@ class settings implements ArrayAccess
|
|||
if (is_array($value)) {
|
||||
// Жесткая запись
|
||||
|
||||
$this->settings['attachments'] = $value;
|
||||
|
||||
return;
|
||||
return $this->settings['attachments'] = $value;
|
||||
}
|
||||
|
||||
if (empty($this->settings['attachments']) || count($this->settings['attachments']) < 10) {
|
||||
// Записано менее чем 10 вложений (от 0 до 9)
|
||||
|
||||
// Запись (конкатенация)
|
||||
$this->settings['attachments'][] = $value;
|
||||
|
||||
return;
|
||||
return $this->settings['attachments'][] = $value;
|
||||
}
|
||||
|
||||
throw new Exception('Превышено ограничение на 10 вложений', 500);
|
||||
} else {
|
||||
// Запись по ключу или смещению
|
||||
|
||||
$this->settings[$offset] = $value;
|
||||
|
||||
return;
|
||||
return $this->settings[$offset] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
|
|
@ -257,7 +260,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 +284,7 @@ class settings implements ArrayAccess
|
|||
}
|
||||
|
||||
/**
|
||||
* Проверить существование смещения
|
||||
*
|
||||
* @param mixed $offset Сдвиг
|
||||
*
|
||||
* @return bool Смещение существует?
|
||||
* Проверка существования смещения
|
||||
*/
|
||||
public function offsetExists(mixed $offset): bool
|
||||
{
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@ use exception;
|
|||
* @method public function get($id = null) Чтение из реестра
|
||||
*
|
||||
* @package mirzaev\vk
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*/
|
||||
final class core
|
||||
{
|
||||
|
|
@ -45,22 +45,22 @@ final class core
|
|||
*
|
||||
* Используется в логировании
|
||||
*/
|
||||
private readonly string $timezone;
|
||||
private string $timezone;
|
||||
|
||||
/**
|
||||
* Путь до корня проекта
|
||||
*/
|
||||
private readonly string $path_root;
|
||||
private string $path_root;
|
||||
|
||||
/**
|
||||
* Путь до папки журналов
|
||||
*/
|
||||
private readonly string $path_logs;
|
||||
private string $path_logs;
|
||||
|
||||
/**
|
||||
* Путь до временной папки
|
||||
*/
|
||||
private readonly string $path_temp;
|
||||
private string $path_temp;
|
||||
|
||||
/**
|
||||
* Запись в журнал
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ use mirzaev\vk\core,
|
|||
* @see Jasny\ErrorHandler
|
||||
*
|
||||
* @package mirzaev\vk\loggers
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*/
|
||||
final class jasmo extends logger
|
||||
{
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ namespace mirzaev\vk\loggers;
|
|||
* Абстрактный класс журналиста
|
||||
*
|
||||
* @package mirzaev\vk\loggers
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*/
|
||||
abstract class logger
|
||||
{
|
||||
|
|
|
|||
|
|
@ -22,7 +22,7 @@ use mirzaev\vk\robots\robot,
|
|||
* @method public function __isset($name) Проверка на инициализированность свойства
|
||||
*
|
||||
* @package mirzaev\vk\robots
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*/
|
||||
final class group extends robot
|
||||
{
|
||||
|
|
@ -38,8 +38,8 @@ final class group extends robot
|
|||
* @param string|null $key Ключ
|
||||
*/
|
||||
public function __construct(
|
||||
protected ?int $id = null,
|
||||
protected ?string $key = null
|
||||
protected int|null $id = null,
|
||||
protected string|null $key = null
|
||||
) {
|
||||
parent::__construct($id, $key);
|
||||
|
||||
|
|
|
|||
|
|
@ -39,39 +39,39 @@ use GuzzleHttp\Client as browser;
|
|||
* @method public function __toString() Конвертация в строку
|
||||
*
|
||||
* @package mirzaev\vk\robots
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*/
|
||||
abstract class robot
|
||||
{
|
||||
/**
|
||||
* @var int $session Сессия
|
||||
* Сессия
|
||||
*/
|
||||
protected readonly int $session;
|
||||
protected int $session;
|
||||
|
||||
/**
|
||||
* @var account $account Аккаунт ВКонтакте
|
||||
* Аккаунт
|
||||
*/
|
||||
private readonly account $account;
|
||||
private account $account;
|
||||
|
||||
/**
|
||||
* @var api $api API ВКонтакте
|
||||
* $messages_mode Режим отправки сообщений
|
||||
*/
|
||||
protected readonly api $api;
|
||||
protected int $messages_mode = 1;
|
||||
|
||||
/**
|
||||
* @var browser $browser Браузер
|
||||
* @var api API ВКонтакте
|
||||
*/
|
||||
protected readonly browser $browser;
|
||||
protected api $api;
|
||||
|
||||
/**
|
||||
* Конструктор
|
||||
*
|
||||
* @param int|null $id Идентификатор робота
|
||||
* @param string|null $key Ключ API ВКонтакте
|
||||
* @param int|null $id Идентификатор
|
||||
* @param string|null $key Ключ
|
||||
*/
|
||||
public function __construct(
|
||||
protected ?int $id = null,
|
||||
protected ?string $key = null
|
||||
protected int|null $id = null,
|
||||
protected string|null $key = null
|
||||
) {
|
||||
// Инициализация ядра
|
||||
$core = core::init();
|
||||
|
|
@ -89,6 +89,7 @@ abstract class robot
|
|||
$this->api();
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Инициализация ключа
|
||||
*
|
||||
|
|
@ -182,13 +183,14 @@ abstract class robot
|
|||
public function __set(string $name, mixed $value): void
|
||||
{
|
||||
match ($name) {
|
||||
'id' => empty($this->id) ?: $this->id = $value,
|
||||
'session' => empty($this->session) ?: $this->session = $value,
|
||||
'id' => isset($this->id) ? throw new Exception('Запрещено перезаписывать идентификатор', 500) : $this->id = (int) $value,
|
||||
'session' => isset($this->session) ? throw new Exception('Запрещено перезаписывать сессию', 500) : $this->session = (int) $value,
|
||||
'key' => $this->key((string) $value),
|
||||
'account' => $this->account($value),
|
||||
'api' => $this->api(),
|
||||
'browser' => empty($this->browser) ?: $this->browser = $value,
|
||||
'messages_new' => $this->messages_new = (int) $value
|
||||
'browser' => isset($this->browser) ? throw new Exception('Запрещено перезаписывать браузер', 500) : $this->browser = $value,
|
||||
'messages_new' => $this->messages_new = (int) $value,
|
||||
default => throw new Exception("Свойство $name не найдено", 404)
|
||||
};
|
||||
}
|
||||
|
||||
|
|
@ -217,16 +219,23 @@ abstract class robot
|
|||
}
|
||||
|
||||
/**
|
||||
* Проверить на инициализированность
|
||||
* Проверить свойство на инициализированность
|
||||
*
|
||||
* @param mixed $name Название
|
||||
* @param string $name Название
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
public function __isset(string $name): bool
|
||||
{
|
||||
return match ($name) {
|
||||
'id' => isset($this->id),
|
||||
'session' => isset($this->session),
|
||||
'key' => isset($this->key),
|
||||
default => false
|
||||
'account' => isset($this->account),
|
||||
'api' => isset($this->api),
|
||||
'browser' => isset($this->browser),
|
||||
'messages_new' => isset($this->messages_new),
|
||||
default => throw new Exception("Свойство $name не найдено", 404)
|
||||
};
|
||||
}
|
||||
|
||||
|
|
@ -280,14 +289,4 @@ abstract class robot
|
|||
{
|
||||
return (string) $this->id;
|
||||
}
|
||||
|
||||
/**
|
||||
* Клонировать объект
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function __clone(): void {
|
||||
// Инициализация робота
|
||||
$this->__construct($this->id, $this->key);
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ use mirzaev\accounts\vk as account;
|
|||
* Робот-пользователь
|
||||
*
|
||||
* @package mirzaev\vk\robots
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
|
||||
*/
|
||||
final class user extends robot
|
||||
{
|
||||
|
|
@ -23,8 +23,8 @@ final class user extends robot
|
|||
* @param string|null $key Ключ
|
||||
*/
|
||||
public function __construct(
|
||||
protected readonly int|null $id = null,
|
||||
protected readonly string|null $key = null
|
||||
protected int|null $id = null,
|
||||
protected string|null $key = null
|
||||
) {
|
||||
parent::__construct($id, $key);
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue