Compare commits
No commits in common. "stable" and "4.0.x" have entirely different histories.
|
|
@ -65,9 +65,9 @@ final class messages extends method
|
||||||
protected random_id $generate_mode = random_id::crypto;
|
protected random_id $generate_mode = random_id::crypto;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @var int|string|array|null $peer_id Получатель
|
* @var int|string|array|null $destination Получатель
|
||||||
*/
|
*/
|
||||||
protected int|string|array|null $peer_id = null;
|
protected int|string|array|null $destination = null;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @var string|null $text Текст
|
* @var string|null $text Текст
|
||||||
|
|
@ -120,40 +120,10 @@ final class messages extends method
|
||||||
protected ?string $intent = null;
|
protected ?string $intent = null;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @var ?int $subscribe_id Число, которое будет использоваться для работы с интентами
|
* @var ?string $subscribe_id Число, которое будет использоваться для работы с интентами
|
||||||
*/
|
*/
|
||||||
protected ?int $subscribe_id = null;
|
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;
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Конструктор
|
* Конструктор
|
||||||
*
|
*
|
||||||
|
|
@ -198,14 +168,14 @@ final class messages extends method
|
||||||
/**
|
/**
|
||||||
* Записать: получатель
|
* Записать: получатель
|
||||||
*
|
*
|
||||||
* @param int|string|array|null $peer_id Получатель
|
* @param int|string|array|null $destination Получатель
|
||||||
*
|
*
|
||||||
* @return static
|
* @return static
|
||||||
*/
|
*/
|
||||||
public function peer_id(int|string|array|null $peer_id): static
|
public function destination(int|string|array|null $destination): static
|
||||||
{
|
{
|
||||||
// Запись в свойство
|
// Запись в свойство
|
||||||
$this->__set('peer_id', $peer_id);
|
$this->__set('destination', $destination);
|
||||||
|
|
||||||
return $this;
|
return $this;
|
||||||
}
|
}
|
||||||
|
|
@ -270,6 +240,36 @@ final class messages extends method
|
||||||
return $this;
|
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;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Записать: идентификаторы пересылаемых сообщений
|
* Записать: идентификаторы пересылаемых сообщений
|
||||||
*
|
*
|
||||||
|
|
@ -315,6 +315,21 @@ final class messages extends method
|
||||||
return $this;
|
return $this;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Записать: идентификатор стикера
|
||||||
|
*
|
||||||
|
* @param ?string $sticker Идентификатор стикера
|
||||||
|
*
|
||||||
|
* @return static
|
||||||
|
*/
|
||||||
|
public function sticker(?string $sticker): static
|
||||||
|
{
|
||||||
|
// Запись в свойство
|
||||||
|
$this->__set('sticker_id', $sticker);
|
||||||
|
|
||||||
|
return $this;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Записать: полезная нагрузка
|
* Записать: полезная нагрузка
|
||||||
*
|
*
|
||||||
|
|
@ -345,6 +360,21 @@ final class messages extends method
|
||||||
return $this;
|
return $this;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Записать: создавать представление ссылки в сообщении?
|
||||||
|
*
|
||||||
|
* @param bool $payload Cоздавать представление ссылки в сообщении?
|
||||||
|
*
|
||||||
|
* @return static
|
||||||
|
*/
|
||||||
|
public function links(bool $links): static
|
||||||
|
{
|
||||||
|
// Запись в свойство
|
||||||
|
$this->__set('dont_parse_links', !$links);
|
||||||
|
|
||||||
|
return $this;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Записать: отключить уведомление об упоминании в сообщении?
|
* Записать: отключить уведомление об упоминании в сообщении?
|
||||||
*
|
*
|
||||||
|
|
@ -360,6 +390,21 @@ final class messages extends method
|
||||||
return $this;
|
return $this;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Записать: включить уведомление об упоминании в сообщении?
|
||||||
|
*
|
||||||
|
* @param bool $mentions Включить уведомление об упоминании в сообщении?
|
||||||
|
*
|
||||||
|
* @return static
|
||||||
|
*/
|
||||||
|
public function mentions(bool $mentions): static
|
||||||
|
{
|
||||||
|
// Запись в свойство
|
||||||
|
$this->__set('disable_mentions', !$mentions);
|
||||||
|
|
||||||
|
return $this;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Записать: интент
|
* Записать: интент
|
||||||
*
|
*
|
||||||
|
|
@ -391,118 +436,26 @@ final class messages extends method
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Записать: смещение для выбора сообщений
|
* Записать: число, которое будет использоваться для работы с интентами
|
||||||
*
|
*
|
||||||
* @param ?int $offset Смещение для выбора сообщений
|
* @param ?int $subscribe Число, которое будет использоваться для работы с интентами
|
||||||
*
|
*
|
||||||
* @return static
|
* @return static
|
||||||
*/
|
*/
|
||||||
public function offset(?int $offset): static
|
public function subscribe(?int $subscribe): static
|
||||||
{
|
{
|
||||||
// Запись в свойство
|
// Запись в свойство
|
||||||
$this->__set('offset', $offset);
|
$this->__set('subscribe_id', $subscribe);
|
||||||
|
|
||||||
return $this;
|
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 int|string|null $destination Получатель
|
||||||
* @param ?string $message Сообщение
|
* @param ?string $message Сообщение
|
||||||
* @param ?int $lat Географическая ширина
|
* @param ?int $lat Географическая ширина
|
||||||
* @param ?int $long Географическая долгота
|
* @param ?int $long Географическая долгота
|
||||||
|
|
@ -530,7 +483,7 @@ final class messages extends method
|
||||||
* 5. Добавить content_source
|
* 5. Добавить content_source
|
||||||
*/
|
*/
|
||||||
public function send(
|
public function send(
|
||||||
int|string|null $peer_id = null,
|
int|string|null $destination = null,
|
||||||
?string $message = null,
|
?string $message = null,
|
||||||
?int $lat = null,
|
?int $lat = null,
|
||||||
?int $long = null,
|
?int $long = null,
|
||||||
|
|
@ -552,7 +505,10 @@ final class messages extends method
|
||||||
$this->robot->api->reinit();
|
$this->robot->api->reinit();
|
||||||
|
|
||||||
// Инициализация получателя
|
// Инициализация получателя
|
||||||
$this->receiver($peer_id);
|
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) {
|
$this->robot->api['random_id'] = $random_id ?? match ($this->generate_mode) {
|
||||||
|
|
@ -563,43 +519,55 @@ final class messages extends method
|
||||||
};
|
};
|
||||||
|
|
||||||
// Инициализация текста в настройках API
|
// Инициализация текста в настройках API
|
||||||
if (!empty($message ??= $this->text)) $this->robot->api['message'] = $message;
|
if (isset($message)) $this->text = $message;
|
||||||
|
if (isset($this->text)) $this->robot->api['message'] = $this->text;
|
||||||
|
|
||||||
// Инициализация широты
|
// Инициализация широты
|
||||||
if (!empty($lat ??= $this->lat)) $this->robot->api['lat'] = $lat;
|
if (isset($lat)) $this->lat = $lat;
|
||||||
|
if (isset($this->lat)) $this->robot->api['lat'] = $this->lat;
|
||||||
|
|
||||||
// Инициализация долготы
|
// Инициализация долготы
|
||||||
if (!empty($long ??= $this->long)) $this->robot->api['long'] = $long;
|
if (isset($long)) $this->long = $long;
|
||||||
|
if (isset($this->long)) $this->robot->api['long'] = $this->long;
|
||||||
|
|
||||||
// Инициализация вложений
|
// Инициализация вложений
|
||||||
if (!empty($attachments ??= $this->robot->api->data)) $this->robot->api['attachment'] = implode(',', $attachments);
|
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 (!empty($reply_to ??= $this->reply_to)) $this->robot->api['reply_to'] = $reply_to;
|
if (isset($reply_to)) $this->reply = $reply_to;
|
||||||
|
if (isset($this->reply)) $this->robot->api['reply_to'] = $this->reply;
|
||||||
|
|
||||||
// Инициализация пересылаемых сообщений
|
// Инициализация пересылаемых сообщений
|
||||||
if (!empty($forward_messages ??= $this->forward_messages)) $this->robot->api['forward_messages'] = implode(',', $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 (!empty($sticker_id ??= $this->sticker_id)) $this->robot->api['sticker_id'] = $sticker_id;
|
if (isset($sticker_id)) $this->robot->api['sticker_id'] = $sticker_id;
|
||||||
|
if (isset($this->sticker_id)) $this->robot->api['sticker_id'] = $this->sticker_id;
|
||||||
|
|
||||||
// Инициализация полезной нагрузки
|
// Инициализация полезной нагрузки
|
||||||
if (!empty($payload ??= $this->payload)) $this->robot->api['payload'] = $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;
|
// $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 (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->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 (!empty($intent ??= $this->intent)) $this->robot->api['intent'] = $intent;
|
if (isset($intent)) $this->robot->api['intent'] = $intent;
|
||||||
|
if (isset($this->intent)) $this->robot->api['intent'] = $this->intent;
|
||||||
|
|
||||||
// Инициализация числа, которое будет использоваться для работы с интентами
|
// Инициализация числа, которое будет использоваться для работы с интентами
|
||||||
if (!empty($subscribe_id ??= $this->subscribe_id)) $this->robot->api['subscribe_id'] = $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('Сообщение должно содержать текст, либо вложение');
|
if (!$this->robot->api->offsetExists('message') && !$this->robot->api->offsetExists('attachment')) throw new Exception('Сообщение должно содержать текст, либо вложение');
|
||||||
|
|
@ -607,8 +575,10 @@ final class messages extends method
|
||||||
// Запрос
|
// Запрос
|
||||||
$request = json_decode($this->robot->browser->request('POST', 'messages.send', ['form_params' => $this->robot->api->settings])->getBody()->getContents());
|
$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->send_mode === message_send::check) {
|
||||||
// Надёжная доставка сообщения
|
// Надёжная доставка сообщения
|
||||||
|
|
@ -629,7 +599,7 @@ final class messages extends method
|
||||||
//!!!!!!!!!!!!!!!!!!!!!!!!!
|
//!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||||
|
|
||||||
// Повторная отправка
|
// Повторная отправка
|
||||||
$this->send();
|
$this->send($destination);
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
}
|
}
|
||||||
|
|
@ -641,7 +611,7 @@ final class messages extends method
|
||||||
/**
|
/**
|
||||||
* Удалить сообщение
|
* Удалить сообщение
|
||||||
*
|
*
|
||||||
* @see https://dev.vk.com/method/messages.delete
|
* @see https://vk.com/dev/messages.delete
|
||||||
*
|
*
|
||||||
* @param int|string|array|null $messages Получатель (message_ids + cmids)
|
* @param int|string|array|null $messages Получатель (message_ids + cmids)
|
||||||
* @param int|string|null $peer_id Идентификатор беседы
|
* @param int|string|null $peer_id Идентификатор беседы
|
||||||
|
|
@ -650,9 +620,7 @@ final class messages extends method
|
||||||
*
|
*
|
||||||
* @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
|
* @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
|
||||||
*
|
*
|
||||||
* @todo
|
* @todo Написать обработчик ошибок возвращаемых ВКонтакте
|
||||||
* 1. Переделать под новую версию
|
|
||||||
* 2. Написать обработчик ошибок возвращаемых ВКонтакте
|
|
||||||
*/
|
*/
|
||||||
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 delete(string|int|array|null $messages = null, int|string|null $peer_id = null, bool $spam = false, bool $delete_for_all = false): stdClass
|
||||||
{
|
{
|
||||||
|
|
@ -699,10 +667,11 @@ final class messages extends method
|
||||||
* @param string $message_ids Идентификатор сообщения
|
* @param string $message_ids Идентификатор сообщения
|
||||||
*
|
*
|
||||||
* @return object Информация о сообщении
|
* @return object Информация о сообщении
|
||||||
*
|
|
||||||
* @todo
|
|
||||||
* 1. Доделать, а лучше полностью переделать
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
//!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||||
|
// доделать
|
||||||
|
|
||||||
public function getById(int $message_ids): object
|
public function getById(int $message_ids): object
|
||||||
{
|
{
|
||||||
// Реиницилазиция
|
// Реиницилазиция
|
||||||
|
|
@ -722,82 +691,11 @@ final class messages extends method
|
||||||
// Запрос
|
// Запрос
|
||||||
$request = json_decode(($this->robot->browser->request('POST', 'messages.getById', ['form_params' => $this->robot->api->settings])->getBody()->getContents()));
|
$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);
|
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'] .= ', ';
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// Запрос
|
|
||||||
$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;
|
return $request->response;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -814,7 +712,7 @@ final class messages extends method
|
||||||
match ($name) {
|
match ($name) {
|
||||||
'send_mode' => $this->send_mode = $value,
|
'send_mode' => $this->send_mode = $value,
|
||||||
'generate_mode' => $this->generate_mode = $value,
|
'generate_mode' => $this->generate_mode = $value,
|
||||||
'peer_id', 'destination' => $this->peer_id = $value,
|
'destination' => $this->destination = $value,
|
||||||
'text' => $this->text = $value,
|
'text' => $this->text = $value,
|
||||||
'lat', 'latitude' => $this->lat = $value,
|
'lat', 'latitude' => $this->lat = $value,
|
||||||
'long', 'longitude' => $this->long = $value,
|
'long', 'longitude' => $this->long = $value,
|
||||||
|
|
@ -828,12 +726,6 @@ final class messages extends method
|
||||||
'mentions' => $this->disable_mentions = !$value,
|
'mentions' => $this->disable_mentions = !$value,
|
||||||
'intent' => $this->intent = $value,
|
'intent' => $this->intent = $value,
|
||||||
'subscribe_id' => $this->subscribe_id = $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)
|
default => throw new Exception("Свойство $name не найдено", 404)
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
@ -850,7 +742,7 @@ final class messages extends method
|
||||||
return match ($name) {
|
return match ($name) {
|
||||||
'send_mode' => $this->send_mode,
|
'send_mode' => $this->send_mode,
|
||||||
'generate_mode' => $this->generate_mode,
|
'generate_mode' => $this->generate_mode,
|
||||||
'peer_id', 'destination' => $this->peer_id,
|
'destination' => $this->destination,
|
||||||
'text' => $this->text,
|
'text' => $this->text,
|
||||||
'lat', 'latitude' => $this->lat,
|
'lat', 'latitude' => $this->lat,
|
||||||
'long', 'longitude' => $this->long,
|
'long', 'longitude' => $this->long,
|
||||||
|
|
@ -862,12 +754,6 @@ final class messages extends method
|
||||||
'disable_mentions', 'mentions' => $this->disable_mentions,
|
'disable_mentions', 'mentions' => $this->disable_mentions,
|
||||||
'intent' => $this->intent,
|
'intent' => $this->intent,
|
||||||
'subscribe_id' => $this->subscribe_id,
|
'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)
|
default => throw new Exception("Свойство $name не найдено", 404)
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -38,7 +38,7 @@ final class users extends method
|
||||||
* @see https://dev.vk.com/method/users.get
|
* @see https://dev.vk.com/method/users.get
|
||||||
*
|
*
|
||||||
* @param array $receiver Выбор пользователей для запроса информации (user_ids)
|
* @param array $receiver Выбор пользователей для запроса информации (user_ids)
|
||||||
* @param array $fields Дополнительные запрашиваемые поля
|
* @param array $fields Выбор дополнительных запрашиваемых полей
|
||||||
* @param string $name_case Падеж
|
* @param string $name_case Падеж
|
||||||
*
|
*
|
||||||
* @return stdClass|array|null Информация об аккаунте или массив с информацией об аккаунтах, если найдена
|
* @return stdClass|array|null Информация об аккаунте или массив с информацией об аккаунтах, если найдена
|
||||||
|
|
@ -93,7 +93,8 @@ final class users extends method
|
||||||
$this->robot->api['fields'] .= $field;
|
$this->robot->api['fields'] .= $field;
|
||||||
|
|
||||||
// Запись разделителя
|
// Запись разделителя
|
||||||
if ($key !== array_key_last($fields)) $this->robot->api['fields'] .= ', ';
|
if ($key === array_key_last($fields)) break;
|
||||||
|
else $this->robot->api['fields'] .= ', ';
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue