Большая доработка сообщений

This commit is contained in:
Arsen Mirzaev Tatyano-Muradovich 2022-11-10 23:15:06 +10:00
parent e670be5816
commit 39d13d9020
2 changed files with 406 additions and 95 deletions

View File

@ -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)
};
}
}

View File

@ -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);
}
}