diff --git a/mirzaev/vk/system/api/methods/messages.php b/mirzaev/vk/system/api/methods/messages.php index 97a11c8..e415633 100644 --- a/mirzaev/vk/system/api/methods/messages.php +++ b/mirzaev/vk/system/api/methods/messages.php @@ -64,6 +64,16 @@ final class messages extends method */ protected random_id $generate_mode = random_id::crypto; + /** + * @var int|string|array|null $destination Получатель + */ + protected int|string|array|null $destination = null; + + /** + * @var string|null $text Текст + */ + protected string|null $text = null; + /** * @var ?int $lat Географическая ширина */ @@ -118,60 +128,324 @@ final class messages extends method * Конструктор * * @param robot $robot Робот - * @param int|string|array|null $receiver Получатель + */ + 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 $destination Получатель + * + * @return static + */ + public function destination(int|string|array|null $destination): static + { + // Запись в свойство + $this->__set('destination', $destination); + + return $this; + } + + /** + * Записать: текст + * * @param string|null $text Текст - */ - public function __construct( - protected robot $robot, - int|string|array|null $receiver = null, - protected string|null $text = null - ) { - if (isset($this->text, $receiver)) { - // Быстрая отправка - - $this->send($receiver); - } - } - - /** - * Записать текст * - * @param string $text Текст + * @return static */ - public function text(string $text): self + public function text(string|null $text): static { - // Записать текст - if (!isset($this->text)) { - $this->text = $text; - } else { - $this->text .= $text; - } + // Запись в свойство + $this->__set('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 ?int $reply Идентификатор сообщения, на которое требуется ответить + * + * @return static + */ + public function reply(?int $reply): static + { + // Запись в свойство + $this->__set('reply_to', $reply); + + return $this; + } + + /** + * Записать: идентификатор сообщения, на которое требуется ответить + * + * @param ?int $to Идентификатор сообщения, на которое требуется ответить + * + * @return static + */ + public function to(?int $to): static + { + // Запись в свойство + $this->__set('reply_to', $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 $sticker Идентификатор стикера + * + * @return static + */ + public function sticker(?string $sticker): static + { + // Запись в свойство + $this->__set('sticker_id', $sticker); + + 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 $payload Cоздавать представление ссылки в сообщении? + * + * @return static + */ + public function links(bool $links): static + { + // Запись в свойство + $this->__set('dont_parse_links', !$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 bool $mentions Включить уведомление об упоминании в сообщении? + * + * @return static + */ + public function mentions(bool $mentions): static + { + // Запись в свойство + $this->__set('disable_mentions', !$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 $subscribe Число, которое будет использоваться для работы с интентами + * + * @return static + */ + public function subscribe(?int $subscribe): static + { + // Запись в свойство + $this->__set('subscribe_id', $subscribe); return $this; } @@ -181,7 +455,7 @@ final class messages extends method * * @see https://vk.com/dev/messages.send * - * @param int|string|null $receiver Получатель + * @param int|string|null $destination Получатель * @param ?string $message Сообщение * @param ?int $lat Географическая ширина * @param ?int $long Географическая долгота @@ -209,7 +483,7 @@ final class messages extends method * 5. Добавить content_source */ public function send( - int|string|null $receiver, + int|string|null $destination = null, ?string $message = null, ?int $lat = null, ?int $long = null, @@ -231,9 +505,10 @@ final class messages extends method $this->robot->api->reinit(); // Инициализация получателя - if (is_int($receiver)) ($id = $receiver - 2000000000) > 0 ? $this->robot->api['peer_id'] = $receiver : $this->robot->api['chat_id'] = $id; - else if (is_array($receiver)) $this->robot->api['peer_ids'] = implode(',', $receiver); - else if (is_string($receiver)) $this->robot->api['domain'] = $receiver; + if (isset($destination)) $this->destination = $destination; + if (is_int($this->destination)) ($id = $this->destination - 2000000000) > 0 ? $this->robot->api['peer_id'] = $this->destination : $this->robot->api['chat_id'] = $id; + else if (is_array($this->destination)) $this->robot->api['peer_ids'] = implode(',',$this->destination); + else if (is_string($this->destination)) $this->robot->api['domain'] = $this->destination; // Инициализация идентификатора сессии доставки сообщения (защита от повторных отправок) $this->robot->api['random_id'] = $random_id ?? match ($this->generate_mode) { @@ -244,55 +519,55 @@ final class messages extends method }; // Инициализация текста в настройках API - if (isset($message)) $this->robot->api['message'] = $message; - else if (isset($this->text)) $this->robot->api['message'] = $this->text; + if (isset($message)) $this->text = $message; + if (isset($this->text)) $this->robot->api['message'] = $this->text; // Инициализация широты - if (isset($lat)) $this->robot->api['lat'] = $lat; - else if (isset($this->lat)) $this->robot->api['lat'] = $this->lat; + if (isset($lat)) $this->lat = $lat; + if (isset($this->lat)) $this->robot->api['lat'] = $this->lat; // Инициализация долготы - if (isset($long)) $this->robot->api['long'] = $long; - else if (isset($this->long)) $this->robot->api['long'] = $this->tlongext; + if (isset($long)) $this->long = $long; + if (isset($this->long)) $this->robot->api['long'] = $this->long; // Инициализация вложений - if (isset($attachments)) $this->robot->api['attachment'] = implode(',', $attachments); - else if (isset($this->robot->api->data) && $this->robot->api->__get('data') !== []) $this->robot->api['attachment'] = implode(',', $this->robot->api->__get('data')); + if (isset($attachments)) $this->robot->api->data = $attachments; + if (isset($this->robot->api->data) && $this->robot->api->__get('data') !== []) $this->robot->api['attachment'] = implode(',', $this->robot->api->__get('data')); // Инициализация сообщения, на которое требуется ответить - if (isset($reply_to)) $this->robot->api['reply_to'] = $reply_to; - else if (isset($this->reply)) $this->robot->api['reply_to'] = $this->reply; + if (isset($reply_to)) $this->reply = $reply_to; + if (isset($this->reply)) $this->robot->api['reply_to'] = $this->reply; // Инициализация пересылаемых сообщений - if (isset($forward_messages)) $this->robot->api['forward_messages'] = implode(',', $forward_messages); - else if (isset($this->forward_messages)) $this->robot->api['forward_messages'] = implode(',', $this->forward_messages); + if (isset($forward_messages)) $this->forward_messages = $forward_messages; + if (isset($this->forward_messages)) $this->robot->api['forward_messages'] = implode(',', $this->forward_messages); // Инициализация стикера if (isset($sticker_id)) $this->robot->api['sticker_id'] = $sticker_id; - else if (isset($this->sticker_id)) $this->robot->api['sticker_id'] = $this->sticker_id; + if (isset($this->sticker_id)) $this->robot->api['sticker_id'] = $this->sticker_id; // Инициализация полезной нагрузки - if (isset($payload)) $this->robot->api['payload'] = $payload; - else if (isset($this->payload)) $this->robot->api['payload'] = $this->payload; + if (isset($payload)) $this->payload = $payload; + if (isset($this->payload)) $this->robot->api['payload'] = $this->payload; // Инициализация пользовательского соглашения // $this->robot->api['content_source'] = $this->robot->content_source; // Инициализация "не создавать представление ссылки в сообщении?" - if ($dont_parse_links) $this->robot->api['dont_parse_links'] = 1; - else if ($this->dont_parse_links) $this->robot->api['dont_parse_links'] = 1; + if (isset($dont_parse_links)) $this->dont_parse_links = $dont_parse_links; + if ($this->dont_parse_links) $this->robot->api['dont_parse_links'] = 1; // Инициализация "отключить уведомление об упоминании в сообщении?" - if ($disable_mentions) $this->robot->api['disable_mentions'] = 1; - else if ($this->disable_mentions) $this->robot->api['disable_mentions'] = 1; + if (isset($disable_mentions)) $this->disable_mentions = $disable_mentions; + if ($this->disable_mentions) $this->robot->api['disable_mentions'] = 1; // Инициализация интентов if (isset($intent)) $this->robot->api['intent'] = $intent; - else if (isset($this->intent)) $this->robot->api['intent'] = $this->intent; + if (isset($this->intent)) $this->robot->api['intent'] = $this->intent; // Инициализация числа, которое будет использоваться для работы с интентами - if (isset($subscribe_id)) $this->robot->api['subscribe_id'] = $subscribe_id; - else if (isset($this->subscribe_id)) $this->robot->api['subscribe_id'] = $this->subscribe_id; + if (isset($subscribe_id)) $this->subscribe_id = $subscribe_id; + if (isset($this->subscribe_id)) $this->robot->api['subscribe_id'] = $this->subscribe_id; // Проверка сформированного сообщения if (!$this->robot->api->offsetExists('message') && !$this->robot->api->offsetExists('attachment')) throw new Exception('Сообщение должно содержать текст, либо вложение'); @@ -324,7 +599,7 @@ final class messages extends method //!!!!!!!!!!!!!!!!!!!!!!!!! // Повторная отправка - $this->send($receiver); + $this->send($destination); } } else { } @@ -386,38 +661,6 @@ final class messages extends method return $request->response; } - /** - * Записать свойство - * - * @param string $name Название - * @param mixed $value Значение - * - * @return void - */ - public function __set(string $name, mixed $value): void - { - match ($name) { - default => throw new Exception("Свойство $name не найдено", 404) - }; - } - - /** - * Прочитать свойство - * - * @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) - }; - } - /** * Получить информацию о сообщении по id * @@ -455,4 +698,63 @@ final class messages extends method 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, + 'destination' => $this->destination = $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, + 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, + 'destination' => $this->destination, + '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, + default => throw new Exception("Свойство $name не найдено", 404) + }; + } } diff --git a/mirzaev/vk/system/robots/robot.php b/mirzaev/vk/system/robots/robot.php index f0ad118..c7d073a 100644 --- a/mirzaev/vk/system/robots/robot.php +++ b/mirzaev/vk/system/robots/robot.php @@ -89,7 +89,6 @@ abstract class robot $this->api(); } - /** * Инициализация ключа * @@ -281,4 +280,14 @@ abstract class robot { return (string) $this->id; } + + /** + * Клонировать объект + * + * @return void + */ + public function __clone(): void { + // Инициализация робота + $this->__construct($this->id, $this->key); + } }