Compare commits

..

4 Commits

49 changed files with 4257 additions and 4179 deletions

7
.gitignore vendored
View File

@ -1,3 +1,4 @@
!.gitignore
composer.phar
vendor
/logs
/temp
/vendor
.env

22
LICENSE Normal file
View File

@ -0,0 +1,22 @@
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
Это свободная программа: вы можете перераспространять ее и/или изменять
ее на условиях Стандартной общественной лицензии GNU в том виде, в каком
она была опубликована Фондом свободного программного обеспечения; либо
версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
Эта программа распространяется в надежде, что она будет полезной,
но БЕЗО ВСЯКИХ ГАРАНТИЙ; даже без неявной гарантии ТОВАРНОГО ВИДА
или ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННЫХ ЦЕЛЕЙ. Подробнее см. в Стандартной
общественной лицензии GNU <https://www.gnu.org/licenses/>.

View File

@ -1,30 +1,24 @@
# PHP-фреймворк ВКонтакте
Многопоточный фреймворк с поддержкой всех возможностей API ВКонтакте
# Колпачный фреймворк для ВКонтакте
Развивается как многопоточный фреймворк с поддержкой всех возможностей API ВКонтакте, а так же не добавленных, но необходимых функций, работу с большим количеством роботов под разными сессиями, поддерживающий PSR-спецификацию и полностью покрытый тестами
### Установка:
```sh
$ composer install mirzaev/vk
$ composer install hood/vk
```
### Пример использования:
```php
use mirzaev\vk\core;
use mirzaev\accounts\vk;
use hood\vk\core;
use hood\accounts\vk;
// Подключение библеотек
require_once './vendor/autoload.php';
// Инициализация ядра
$core = core::init();
// Инициализация менеджера аккаунтов ВКонтакте
$vk = new vk(ACCOUNT_ID);
// Инициализация аккаунта ВКонтакте
$account = $vk->auth(ACCOUNT_LOGIN, ACCOUNT_PASSWORD)->key(PROJECT_KEY);
// Инициализация пользователя ВКонтакте
$account = (new vk($id))->auth('login', 'password')->key($project_id);
// Инициализация робота-группы
$robot = $core->group($account);
$robot = core::init()->group($account);
// Отправка сообщения
$robot->message(RECEIVER_ID, 'Привет, я создал робота!');
$robot->message($to, 'Привет, я создал робота!');
```

View File

@ -1,48 +1,53 @@
{
"name": "mirzaev/vk",
"type": "framework",
"description": "Framework for vk.com API",
"readme": "README.md",
"name": "hood/vk",
"type": "library",
"description": "Фреймворк VK API",
"keywords": [
"vk",
"hood",
"api"
],
"homepage": "https://git.mirzaev.sexy/mirzaev/vk",
"license": "WTFPL",
"homepage": "https://git.hood.su/vk",
"license": "AGPL-3.0-or-later",
"authors": [
{
"name": "Arsen Mirzaev Tatyano-Muradovich",
"email": "arsen@mirzaev.sexy",
"homepage": "https://mirzaev.sexy/mirzaev",
"role": "Programmer"
"name": "Arsen Mirzaev",
"email": "red@hood.su",
"homepage": "https://hood.su/sex",
"role": "Developer"
}
],
"support": {
"docs": "https://git.mirzaev.sexy/mirzaev/vk/wiki",
"issues": "https://git.mirzaev.sexy/mirzaev/vk/issues"
"docs": "https://git.hood.su/hood/vk/manual",
"issues": "https://git.hood.su/hood/vk/issues",
"chat": "https://vk.me/darkweb228"
},
"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": ">=7.4.0",
"psr/log": "1.*",
"monolog/monolog": ">=1.6",
"jasny/error-handler": "^0.2.0",
"hood/accounts": "^0.0.2",
"guzzlehttp/guzzle": "^7.2"
},
"require-dev": {
"phpunit/phpunit": "^9.5"
},
"suggest": {
"ext-sodium": "Can be selected in some conditions to increase security"
"phpdocumentor/phpdocumentor": ">=2.9",
"phpunit/phpunit": "^9"
},
"autoload": {
"psr-4": {
"mirzaev\\vk\\": "mirzaev/vk/system"
"hood\\vk\\": "hood/vk/system"
}
},
"autoload-dev": {
"psr-4": {
"mirzaev\\vk\\tests\\": "mirzaev/vk/tests"
"hood\\vk\\tests\\": "hood/vk/tests"
}
},
"funding": [
{
"type": "Hood",
"url": "https://git.hood.su/vk/thanks"
}
]
}

3919
composer.lock generated

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,52 @@
<?php
declare(strict_types=1);
namespace Hood\VK\API;
class CallBack extends CallBackAbstract
{
/**
* Адрес для создания колбек-сервера
*
* @var string
*/
private $url;
/**
* Пользовательский ключ колбек-сессии
*
* @var string
*/
private $secret_key;
/**
* Ключ подтверждения колбек сессии
*
* @var string
*/
private $confirmation_token;
/**
* @var int
*/
private $group_id;
public function __construct(object $group, array $params = []){
$this->secret_key = $_ENV['CALLBACK_SECRET_KEY'];
$this->url = $_ENV['SERVER_DOMAIN'];
$this->group_id = $group->id;
$this->group_id->request('groups.addCallbackServer', [
'group_id' => $this->group_id,
'url' => $this->url,
'title' => $this->group_id . 'CallBackServer',
'secret_key' => $this->secret_key
]);
// $this->confirmation_token = request('groups.getCallbackConfirmationCode', [$this->group_id]);
echo $this->confirmation_token;
}
public function sendOk(){
echo 'ok';
}
}

View File

@ -2,13 +2,11 @@
declare(strict_types=1);
namespace mirzaev\vk\api;
namespace hood\vk\api;
use Exception;
use mirzaev\vk\core,
mirzaev\vk\robots\robot,
mirzaev\vk\robots\group;
use hood\vk\core,
hood\vk\robots\robot;
/**
* LongPoll
@ -25,8 +23,8 @@ use mirzaev\vk\core,
* @see https://vk.com/dev/groups.getLongPollServer
* @see https://vk.com/dev/groups.setLongPollSettings
*
* @package mirzaev\vk\api
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
* @package hood\vk\api
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*
* @todo Добавить обработку ошибок ($request['errors];)
*/
@ -37,14 +35,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,41 +58,25 @@ final class longpoll
*
* $robot Робот
*/
public function __construct(private robot&group $robot)
public function __construct(private robot $robot)
{
// Инициализация
if (empty($robot->id)) throw new Exception('Необходимо указать идентификатор ВКонтакте');
if (empty($robot->key)) throw new Exception('Необходимо указать ключ для доступа к LongPoll');
if (empty($robot->api) || empty($robot->api['v'])) {
// Настройки API не инициализированы или не соблюдены условия
// Безопасная инициализация
$robot->api->init();
}
// Инициализация робота
match (true) {
!isset($robot->id) => throw new Exception('Необходимо указать идентификатор ВКонтакте'),
!isset($robot->key) => throw new Exception('Необходимо указать ключ для доступа к LongPoll'),
!isset($robot->version) => throw new Exception('Необходимо указать версию используемого API ВКонтакте'),
default => null
};
// Остановка процессов-дубликатов
try {
// Поиск директории для временных файлов
if (!file_exists(core::init()->path_temp)) {
// Не удалось найти директорию для временных файлов
if (!mkdir(core::init()->path_temp, 0775, true)) {
// Не удалось создать директорию для временных файлов
throw new Exception('Не удалось создать директорию для временных файлов', 500);
// Если не существует каталога temp, то создать
mkdir(core::init()->path_temp, 0775, true);
}
}
// Поиск файла-блокировщика
if (file_exists($lock = core::init()->path_temp . '/' . $this->robot->id . '_' . (int) $this->robot->session . '.longpoll')) {
// Удалось найти файл-блокировщик
// Удаление файла
// Если существует файл-блокировщик, то удалить его
unlink($lock);
}
} catch (Exception $e) {
throw new Exception('Не удалось обработать процессы-дубликаты', 500, $e->getPrevious());
}
}
/**
@ -192,37 +174,22 @@ final class longpoll
/**
* Получить события
*
* @param int $wait Время ожидания новых событий (в секундах)
*
* @todo Проверка на ошибки запроса, включая на наличие доступа к лонгполл у ключа
*
* @return array
* $wait Время ожидания новых событий (в секундах)
*/
public function get(int $wait = 25): array
{
if (empty($this->key) || empty($this->server) || empty($this->ts)) {
// LongPoll-сервер не инициализирован
// Если не инициализирован LongPoll-сервер
// Запрос на получение доступа и данных LongPoll-сервера
$response = json_decode(
$this->robot->browser->request(
method: 'POST',
uri: 'groups.getLongPollServer',
options: [
'form_params' => $this->robot->api['settings']
]
)->getBody()->getContents()
);
$response = json_decode($this->robot->browser->request(method: 'POST', uri: 'groups.getLongPollServer', options: [
'form_params' => [
'group_id' => $this->robot->id,
'v' => $this->robot->version,
'access_token' => $this->robot->key
],
if (isset($response->error)) {
// Что-то сделать
var_export($response->error);
die;
}
// Инициализация
$response = $response->response;
])->getBody()->getContents())->response;
// Ключ доступа
$this->key = $response->key;

View File

@ -0,0 +1,218 @@
<?php
declare(strict_types=1);
namespace hood\vk\api\methods;
use hood\vk\robots\robot,
hood\vk\robots\group,
hood\vk\robots\user;
/**
* Сообщение
*
* public static function put(RobotAbstract $from, int $to, string $message, int $mode = 2) Отправить сообщение
*
* @see https://vk.com/dev/messages.send
* @see https://vk.com/dev/messages.getById
*
* @package hood\vk\api
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*
* @todo Доработать строгий режим отправки: проверку сообщения в беседе (не имеет ID сообщений)
*/
final class messages extends method
{
/**
* $mode Режим отправки
*/
protected int $mode = 1;
/**
* Создать сообщение
*
* Если переданы все параметры, то сразу отправляет
*
* $robot Робот
* $message Текст
* $destination Получатель
* $attachments Вложения
*
* @return self
*/
public function __construct(
protected robot $robot,
protected string $message,
protected int|string|array|null $destination = null,
protected array $attachments = []
) {
// Отправка, если все параметры инициализированы
return $this->send($destination);
}
/**
* Отправить сообщение
*
* $destination Получатель
*
* @see https://vk.com/dev/messages.send
*
* Ответ сервера
*/
public function send(int|string|array $destination): array
{
// Идентификатор сообщения
$random_id = time();
if ($this->mode = 1) {
// Перемножение (по умолчанию)
$random_id *= rand();
}
# Ключ
match (true) {
// Робот-группа
$this->robot instanceof group => $settings['access_token'] = $this->robot->key,
// Робот-пользователь
$this->robot instanceof User => $settings['access_token'] = $this->robot->key
};
// Версия API
$settings['v'] = $this->robot->version;
// Цель отправки
match (true) {
// Отправить по идентификатору
is_int($destination) => $settings['peer_id'] = $destination,
// Массовая отправка по идентификаторам
is_array($destination) => $settings['user_ids'] = $destination,
// Отправить по домену
default => $settings['domain'] = $destination
};
// Сообщение
$settings['message'] = $this->message;
// Идентификатор сообщения
$settings['random_id'] = $random_id;
// Фильтрация вложений
$forward_messages = [];
foreach ($this->attachments as &$attachment) {
//var_dump($attachment);
if (iconv_substr($attachment, 0, 7, "UTF-8") === 'message') {
// Если среди вложений найдено сообщение для пересылки
$forward_messages[] = $attachment;
unset($attachment);
}
}
if (!empty($forward_messages)) {
// Если есть пересылаемые сообщения
$settings['forward_messages'] = implode(',', $forward_messages);
}
//var_dump($attachments);
if (!empty($this->attachments)) {
// Если есть вложения
//echo 'lol';
$settings['attachment'] = implode(',', $this->attachments);
//var_dump($settings['attachment']);
}
// Запрос
$request = $this->robot->browser->request(method: 'POST', uri: 'messages.send', options: ['form_params' => $settings]);
// Очистка
unset($settings);
if ($this->mode >= 2) {
// Если установлен режим 2 (усиленная проверка отправленного сообщения)
if (!empty($request["response"])) {
// Если пришел ID сообщения
// Ключ
match (true) {
// Робот-группа
$this->robot instanceof Group => $settings['access_token'] = $this->robot->key,
// Робот-пользователь
$this->robot instanceof User => $settings['access_token'] = $this->robot->key
};
// Версия API
$settings['v'] = $this->robot->version;
// Запрашиваемые сообщения
$settings['message_ids'] = $request["response"];
// Запрос
if ($this->robot->browser->post(uri: 'https://api.vk.com/method/messages.getById', options: $settings)['response']['count'] === 0) {
// Если сообщения не существует, то повторить отправку
$this->send($destination);
}
} else {
// Что-то придумать :)
}
}
return (array) $request;
}
/**
* Получить информацию о сообщении
*
* Информация о сообщении
*/
public function info(): array
{
# Ключ
match (true) {
// Робот-группа
$this->robot instanceof group => $settings['access_token'] = $this->robot->key,
// Робот-пользователь
$this->robot instanceof User => $settings['access_token'] = $this->robot->key,
};
// Цель отправки
match (true) {
// Отправить по идентификатору
is_int($this->destination) => $settings['peer_id'] = $this->destination,
// Массовая отправка по идентификаторам
is_array($this->destination) => $settings['user_ids'] = $this->destination,
// Отправить по домену
default => $settings['domain'] = $this->destination
};
// Версия API
$settings['v'] = $this->robot->version;
// Сообщение
$settings['message'] = $this->message;
// Режим отправки
$settings['mode'] = $this->mode;
// Фильтрация вложений
$forward_messages = [];
foreach ($this->attachments as &$attachment) {
if (iconv_substr(str: $attachment, offset: 0, length: 7, charset: "UTF-8") === 'message') {
// Если среди вложений найдено сообщение для пересылки
$forward_messages[] = $attachment;
unset($attachment);
}
}
if (!empty($forward_messages)) {
// Если есть пересылаемые сообщения
$settings['forward_messages'] = implode(',', $forward_messages);
}
if (!empty($attachments)) {
// Если есть вложения
$settings['attachment'] = implode(',', $attachments);
}
return $settings;
}
}

View File

@ -0,0 +1,61 @@
<?php
declare(strict_types=1);
namespace hood\vk\api\methods;
use hood\vk\robots\robot;
/**
* Абстракция метода API
*
* protected static put(string $url, ...$params) Создать
* protected static post(string $url, ...$params) Изменить
* protected static get(string $url, ...$params) Получить
* protected static delete(string $url, ...$params) Удалить
*
* @package hood\vk\api\methods
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*/
abstract class method
{
/**
* Создать
*
* Ответ сервера
*/
public static function put(): array
{
return ['error' => 'Метод не поддерживается'];
}
/**
* Изменить
*
* Ответ сервера
*/
public static function post(): array
{
return ['error' => 'Метод не поддерживается'];
}
/**
* Получить
*
* Ответ сервера
*/
public static function get(): array
{
return ['error' => 'Метод не поддерживается'];
}
/**
* Удалить
*
* Ответ сервера
*/
public static function delete(): array
{
return ['error' => 'Метод не поддерживается'];
}
}

View File

@ -2,49 +2,44 @@
declare(strict_types=1);
namespace mirzaev\vk\api\methods;
namespace hood\vk\api\methods;
// Файлы проекта
use mirzaev\vk\robots\robot,
mirzaev\vk\robots\group;
use hood\vk\robots\robot,
hood\vk\robots\group;
use hood\accounts\vk as account;
// Встроенные библиотеки
use Exception;
/**
* Фотографии (изображения)
*
* @method public static function put(RobotAbstract $from, int $to, string $message, int $mode = 2) Отправить сообщение
* public static function put(RobotAbstract $from, int $to, string $message, int $mode = 2) Отправить сообщение
*
* @see https://vk.com/dev/photos.getUploadServer
* @see https://vk.com/dev/messages.getById
*
* @package mirzaev\vk\api\methods
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
* @package hood\vk\api\methods
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*
* @todo Добавить обработку ошибок ($request['errors])
* @todo Добавить обработку ошибок ($request['errors];)
*/
final class photos extends method
{
/**
* Конструктор
*
* @param robot $robot Робот
* $url
*/
public function __construct(
protected robot $robot
) {
}
protected $url;
/**
* Сохранить
*
* @param robot $robot Робот
* @param int $album_id Альбом
* @param int|null $group_id Группа
* @param string|null $caption Описание
* @param float|null $latitude Географическая широта (-90, 90)
* @param float|null $longitude Географическая долгота (-180, 180)
* $robot Робот
* $album_id Альбом
* $group_id Группа
* $caption Описание
* $latitude Географическая широта (-90, 90)
* $longitude Географическая долгота (-180, 180)
*
* @see https://vk.com/dev/photos.save
*
@ -107,23 +102,17 @@ final class photos extends method
/**
* Загрузить
*
* @param string $images
*
* @return void
*
* @todo Вынести этот мусор за Костей
* @param Type $var
*/
// public static function upload(string ...$images): void
// {
// if (count($images) > 5) {
// throw new Exception('Запрещено отправлять более 5 фотографий');
// }
// }
public static function upload(string ...$images): void
{
if (count($images) > 5) {
throw new Exception('Запрещено отправлять более 5 фотографий');
}
}
/**
* загрузить
*
* @todo Вынести этот мусор за Костей
*/
public static function uploadMessage(robot $robot, string $upload_url, string ...$images)
{
@ -133,11 +122,11 @@ final class photos extends method
/**
* Получить сервер для загрузки изображений
*
* @see https://vk.com/dev/photos.getUploadServer
* $robot Робот
* $album_id Альбом
* $group_id Группа
*
* @param robot $robot Робот
* @param int|null $album_id Альбом
* @param int|group|null $group_id Группа
* @see https://vk.com/dev/photos.getUploadServer
*
* @return array|null Ответ сервера
*/
@ -175,17 +164,17 @@ final class photos extends method
/**
* Получить альбомы
*
* $robot Робот
* $album_ids = null Идентификаторы альбомов
* $offset = null Смещение для выборки подмножества
* $count = null Количество для возврата
* $need_system = null Активация возврата системных альбомов
* $need_covers = null Активация возврата поля с обложкой альбома
* $photo_sizes = null Активация специального формата размеров фотографий
*
* @see https://vk.com/dev/photos.getUploadServer
*
* @param robot $robot Робот
* @param array $album_ids = null Идентификаторы альбомов
* @param int $offset = null Смещение для выборки подмножества
* @param int $count = null Количество для возврата
* @param bool $need_system = null Активация возврата системных альбомов
* @param bool $need_covers = null Активация возврата поля с обложкой альбома
* @param bool $photo_sizes = null Активация специального формата размеров фотографий
*
* @return array Ответ сервера
* Ответ сервера
*/
public static function getAlbums(robot $robot, array $album_ids = null, int $offset = null, int $count = null, bool $need_system = null, bool $need_covers = null, bool $photo_sizes = null): array
{
@ -219,103 +208,51 @@ final class photos extends method
}
/**
* Получить адрес сервера сообщений
* загрузить фото и получить его id
*
* @return object
* $robot робот
*
* $img фото
*/
public function getMessageServer(): object
public function sex(robot $robot, $img)
{
// Реиницилазиция
$this->robot->api->reinit();
if (!isset($this->url)) {
// Идентификатор группы
$this->robot->api['group_id'] = $this->robot->id;
// Идентификатор назначения (0 Для ботов)
$this->robot->api['peer_id'] = 0;
// Получить адрес сервера
$request = json_decode($this->robot->browser->request('POST', 'photos.getMessagesUploadServer', [
'form_params' => $this->robot->api['settings']
])->getBody()->getContents());
// Если в ответе ошибка
if (isset($request->error)) {
throw new Exception('Вконтакте: ' . $request->error->error_msg, $request->error->error_code);
// Получить адрес сервера для загрузки фотографии в личное сообщение
$this->url = json_decode($robot->browser->request('POST', 'photos.getMessagesUploadServer', [
'form_params' => [
'group_id' => $robot->id,
'v' => $robot->version,
'access_token' => $robot->key,
'peer_id' => 0
]
])->getBody()->getContents())->response->upload_url;
}
return $request->response;
}
/**
* Загрузить фото
*/
public function upload($photo, string $url): object
{
// Загрузить фото
$request = json_decode($this->robot->browser->request('POST', $url, [
//загрузить
$response = json_decode($robot->browser->request('POST', $this->url, [
'multipart' => [
[
'Content-type' => 'multipart/form-data',
'name' => 'photo',
'contents' => $photo
'contents' => $img
]
]
])->getBody()->getContents());
// Если в ответе ошибка
if (isset($request->error)) {
throw new Exception('Вконтакте: ' . $request->error->error_msg, $request->error->error_code);
}
return $request;
}
/**
* Получить id фото для сообщения
*
* $robot робот
*
* $pathPhoto Путь к фото
*/
public function getPhoto(string $pathPhoto): string
{
// Получить адрес сервера сообщений
$url = $this->getMessageServer()->upload_url;
// Открыть фото
$pathPhoto = fopen($pathPhoto, 'r');
//Загрузить фото
$response = $this->upload($pathPhoto, $url);
// Реинициализация
$this->robot->api->reinit();
// Идентификатор группы
$this->robot->api['group_id'] = $this->robot->id;
// Сервер
$this->robot->api['server'] = $response->server;
// Фото
$this->robot->api['photo'] = $response->photo;
// Хэш
$this->robot->api['hash'] = $response->hash;
// Сохранить фото
$request = json_decode($this->robot->browser->request('POST', 'photos.saveMessagesPhoto', [
'form_params' => $this->robot->api['settings']
//сохранить
$response = json_decode($robot->browser->request('POST', 'photos.saveMessagesPhoto', [
'form_params' => [
'group_id' => $robot->id,
'v' => $robot->version,
'access_token' => $robot->key,
'server' => $response->server,
'photo' => $response->photo,
'hash' => $response->hash
]
])->getBody()->getContents());
// Если в ответе ошибка
if (isset($request->error)) {
throw new Exception('Вконтакте: ' . $request->error->error_msg, $request->error->error_code);
}
$request;
// Ссылка на фото
return 'photo' . $request->response[0]->owner_id . '_' . $request->response[0]->id;
return 'photo' . $response->response[0]->owner_id . '_' . $response->response[0]->id;
}
}

221
hood/vk/system/core.php Normal file
View File

@ -0,0 +1,221 @@
<?php
declare(strict_types=1);
namespace hood\vk;
use Exception;
use hood\vk\loggers\jasmo,
hood\vk\traits\singleton,
hood\vk\robots\robot;
/**
* Ядро
*
* $robots Количество роботов
* $timezone Временная зона (журналирование)
* $path Пути (архитектура проекта)
*
* protected static function __construct() Инициализация
* public static function init() Запуск инициализации или получение инстанции
* public public function build() Сборщик
* public function set($id, $value) Запись в реестр
* public function get($id = null) Чтение из реестра
*
* @package VK
* @author Арсен Мирзаев <red@hood.su>
*/
final class core
{
use singleton;
/**
* Счётчик роботов
*/
private int $robots = 0;
/**
* Реестр роботов
*/
private array $registry = [];
/**
* Временная зона
*
* Используется в логировании
*/
private string $timezone;
/**
* Путь до корня проекта
*/
private string $path_root;
/**
* Путь до папки журналов
*/
private string $path_logs;
/**
* Путь до временной папки
*/
private string $path_temp;
/**
* Журналист
*
* $file Файл для журналирования
*
* @todo Добавить установку иного журналиста по спецификации PSR-3
* @todo Более гибкое журналирование
*/
public function log(string $file = null): self
{
// Инициализация журналиста (требует переработки)
jasmo::init()::post($file)::postErrorHandler()::postShutdownHandler();
return $this;
}
/**
* Записать в реестр
*
* $id Идентификатор
* $robot робот
*
* @see hood\vk\traits\registry Модификация метода
*/
public function set(int $id, robot $robot): void
{
// if (empty($this->registry[$id])) {
// // Если нет сессий, то инициализировать
// $this->registry[$id] = [];
// }
// Создать новую сессию и обновить счётчик роботов
$this->registry[$id][++$this->robots] = $robot;
}
/**
* Прочитать из реестра
*
* Если не передать идентификатор, то вернёт все значения
*
* $id Идентификатор
* $session Сессия
*
* @see hood\vk\traits\registry Модификация метода
*/
public function get(int|null $id = null, int|null $session = null): mixed
{
if (isset($id) && array_key_exists($id, $this->registry)) {
// Робот передан и найден
if (isset($session) && array_key_exists($session, $this->registry[$id])) {
// Сессия робота передана и найдена
return $this->registry[$id][$session];
}
return $this->registry[$id];
}
return $this->registry;
}
/**
* Удалить из реестра
*
* $id Идентификатор
* $session Сессия
*
* @see hood\vk\traits\registry Модификация метода
*/
public function delete(int|null $id = null, int|null $session = null): void
{
if (isset($id)) {
// Робот передан
if (!array_key_exists($id, $this->registry)) {
throw new Exception('Робот не найден');
}
if (isset($session)) {
// Сессия передана
if (!array_key_exists($session, $this->registry[$id])) {
throw new Exception('Сессия не найдена');
}
// Счётчик роботов
--$this->robots;
// Удаление сессии
unset($this->registry[$id][$session]);
return;
}
// Счётчик роботов
$this->robots = $this->robots - count($this->registry[$id]);
// Удаление робота и всех его сессий
unset($this->registry[$id]);
return;
}
// Удаление всех роботов и их сессий
$this->registry = [];
}
/**
* Записать свойство
*
* $name Название
* $value Значение
*/
public function __set(mixed $name, mixed $value): void
{
match ($name) {
'timezone' => !isset($this->timezone) ? $this->timezone = $value : throw new Exception('Запрещено переопределять часовой пояс'),
'path_root' => !isset($this->path_root) ? $this->path_root = $value : throw new Exception('Запрещено переопределять корневой каталог'),
'path_logs' => !isset($this->path_logs) ? $this->path_logs = $value : throw new Exception('Запрещено переопределять каталог журналов'),
'path_temp' => !isset($this->path_temp) ? $this->path_temp = $value : throw new Exception('Запрещено переопределять каталог временных файлов')
};
}
/**
* Прочитать свойство
*
* Значение по умолчанию, есле не задано
*
* $name Название
*/
public function __get(mixed $name): mixed
{
return match ($name) {
'robots' => $this->robots,
'timezone' => !isset($this->timezone) ? $this->timezone = 'Europe/Moscow' : $this->timezone,
'path_root' => !isset($this->path_root) ? $this->path_root = dirname(__DIR__) : $this->path_root,
'path_logs' => !isset($this->path_logs) ? $this->path_logs = $this->path_root . '/logs' : $this->path_logs,
'path_temp' => !isset($this->path_temp) ? $this->path_root . '/temp' : $this->path_temp,
default => null
};
}
/**
* Вызвать метод
*
* Ищет класс описывающий робота,
* создаёт и возвращает его объект
*
* $method Метод
* $params Параметры
*/
public function __call(string $method, array $params): robot
{
if (class_exists($robot = '\\hood\\vk\\robots\\' . $method)) {
// Если найден класс реализующий запрошенного робота
return new $robot(...$params);
} else {
throw new Exception('Не найден робот: ' . $method);
}
}
}

View File

@ -2,14 +2,14 @@
declare(strict_types=1);
namespace mirzaev\vk\loggers;
namespace hood\vk\loggers;
use DateTime;
use Monolog\logger;
use Monolog\Handler\StreamHandler;
use Jasny\ErrorHandler;
use mirzaev\vk\core,
mirzaev\vk\traits\singleton;
use hood\vk\core,
hood\vk\traits\singleton;
/**
* Журналист Jasmo
@ -20,8 +20,8 @@ use mirzaev\vk\core,
* @see Monolog\logger
* @see Jasny\ErrorHandler
*
* @package mirzaev\vk\loggers
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
* @package hood\vk\loggers
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*/
final class jasmo extends logger
{

View File

@ -2,18 +2,20 @@
declare(strict_types=1);
namespace mirzaev\vk\loggers;
namespace hood\vk\loggers;
/**
* Абстрактный класс журналиста
*
* @package mirzaev\vk\loggers
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
* @package hood\vk\loggers
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*/
abstract class logger
{
/**
* Экземпляр класса журналиста
*
* @var logger
*/
public static $logger;

View File

@ -2,60 +2,40 @@
declare(strict_types=1);
namespace mirzaev\vk\robots;
namespace hood\vk\robots;
use Throwable;
use Exception;
use hood\vk\robots\robot,
hood\vk\api\longpoll;
use mirzaev\vk\robots\robot,
mirzaev\vk\api\settings as api,
mirzaev\vk\api\longpoll;
use Throwable,
Exception;
/**
* Робот-группа
*
* @property longpoll $longpoll LongPoll-сессия
* $longpoll LongPoll-сессия
*
* @method public function __construct(int|null $id, string|null $key) Конструктор
* @method public function __set($name, $value) Запись свойства
* @method public function __get($name) Чтение свойства
* @method public function __isset($name) Проверка на инициализированность свойства
* public function __set($name, $value) Запись свойства
* public function __get($name) Чтение свойства
* public function __isset($name) Проверка на инициализированность свойства
*
* @package mirzaev\vk\robots
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
* hood\vk\robots
* Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*/
final class group extends robot
{
/**
* @var longpoll $longpoll LongPoll-сессия
* $longpoll LongPoll-сессия
*/
protected longpoll $longpoll;
/**
* Конструктор
*
* @param int|null $id Идентификатор
* @param string|null $key Ключ
*/
public function __construct(
protected ?int $id = null,
protected ?string $key = null
) {
parent::__construct($id, $key);
// Инициализация данных API
$this->api['group_id'] = $this->id;
}
/**
* Запись свойства
*
* @param string $name Название
* @param mixed $value Значение
* $name Название
* $value Значение
*
* @see mirzaev\vk\robots\robot Наследуемый метод
*
* @return void
* @see hood\vk\robots\robot Наследуемый метод
*/
public function __set(string $name, mixed $value): void
{
@ -74,11 +54,9 @@ final class group extends robot
/**
* Чтение свойства
*
* @param string $name Название
* $name Название
*
* @see mirzaev\vk\robots\robot Наследуемый метод
*
* @return mixed
* @see hood\vk\robots\robot Наследуемый метод
*/
public function __get(string $name): mixed
{
@ -101,11 +79,11 @@ final class group extends robot
/**
* Проверка на инициализированность свойства
*
* @param string $name Название
* $name Название
*
* @return mixed
*/
public function __isset(string $name): bool
public function __isset(string $name)
{
try {
return parent::__isset($name);

View File

@ -0,0 +1,287 @@
<?php
declare(strict_types=1);
namespace hood\vk\robots;
use Exception;
use GuzzleHttp\Client as browser;
use hood\vk\core,
hood\vk\api\methods\method,
hood\vk\proxies\proxy,
hood\vk\captcha\captcha;
use hood\accounts\vk as account;
/**
* Робот
*
* $id Идентификатор
* $session Сессия
* $key Ключ
* $version Версия API
* $account Аккаунт
* $browser Браузер
* $proxy Прокси
* $captcha Обработчик капчи
*
* $messages_mode Режим отправки сообщений
*
* public function __construct(int $id = null, float $version = null) Конструктор
* public function key(string $key) Инициализация ключа
* public function account(account $account) Инициализация аккаунта
* public function __set($name, $value) Запись свойства
* public function __get($name) Чтение свойства
* public function __isset($name) Проверка на инициализированность свойства
* public function __call(string $method, array $params) Вызов метода
* public static function __callStatic(string $method, array $params) Вызов статического метода
* public function __toString() Конвертация в строку
*
* @package hood\vk\robots
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*/
abstract class robot
{
/**
* Идентификатор
*/
protected int $id;
/**
* Сессия
*/
protected int $session;
/**
* Ключ
*/
protected string $key;
/**
* Версия API
*/
protected float $version = 5.124;
/**
* Аккаунт
*/
private account $account;
/**
* Прокси
*/
protected proxy $proxy;
/**
* Обработчик капчи
*/
protected captcha $captcha;
/**
* $messages_mode Режим отправки сообщений
*/
protected int $messages_mode = 1;
/**
* Конструктор
*
* $id Идентификатор
* $version Версия API
*/
public function __construct(int|null $id = null, float|null $version = null)
{
// Инициализация ядра
$core = core::init();
// Идентификация робота
$this->id = empty($id) ? $core->robots + 1 : $id;
// Регистрация робота в ядре
$core->set($this->id, $this);
// Идентификация сессии робота
$this->session = count($core->get($this->id));
if (isset($version)) {
// Инициализация версии
$this->version = $version;
}
}
/**
* Инициализация ключа
*
* $key Ключ
*/
public function key(string $key): self
{
if (!isset($this->key)) {
$this->key = $key;
} else {
throw new Exception('Запрещено перезаписывать ключ');
}
return $this;
}
/**
* Инициализация аккаунта
*
* $account Аккаунт
*/
public function account(account $account): self
{
if (!isset($this->account)) {
$this->account = $account;
} else {
throw new Exception('Запрещено перезаписывать аккаунт');
}
return $this;
}
/**
* Инициализация прокси
*
* $proxy Прокси
*/
public function proxy(proxy $proxy): self
{
$this->proxy = $proxy;
return $this;
}
/**
* Инициализация обработчика капчи
*
* $captcha Обработчик капчи
*/
public function captcha(captcha $captcha): self
{
$this->captcha = $captcha;
return $this;
}
/**
* Записать свойство
*
* $name Название
* $value Значение
*/
public function __set(string $name, mixed $value): void
{
match ($name) {
'id' => !isset($this->id) ? $this->id = (int) $value : throw new Exception('Запрещено перезаписывать идентификатор'),
'session' => !isset($this->session) ? $this->session = (int) $value : throw new Exception('Запрещено перезаписывать сессию'),
'key' => !isset($this->key) ? $this->key = (string) $value : throw new Exception('Запрещено перезаписывать ключ'),
'version' => !isset($this->version) ? $this->version = (float) $value : throw new Exception('Запрещено перезаписывать версию API'),
'account' => !isset($this->account) && $value instanceof account ? $this->account = $value : throw new Exception('Запрещено перезаписывать аккаунт'),
'browser' => !isset($this->browser) && $value instanceof browser ? $this->browser = $value : throw new Exception('Запрещено перезаписывать браузер'),
'proxy' => $this->proxy = $value,
'captcha' => $this->captcha = $value,
'messages_new' => $this->messages_new = (int) $value,
// Если свойство не найдено:
default => throw new Exception('Свойство не найдено: ' . $name)
};
}
/**
* Прочитать свойство
*
* $name Название
*
* @return mixed
*/
public function __get(string $name)
{
return match ($name) {
'id' => isset($this->id) ? $this->id : throw new Exception('Идентификатор не инициализирован'),
'session' => isset($this->session) ? $this->session : throw new Exception('Сессия не инициализирована'),
'key' => isset($this->key) ? $this->key : throw new Exception('Ключ не инициализирован'),
'version' => isset($this->version) ? $this->version : throw new Exception('Версия не инициализирована'),
'account' => isset($this->account) ? $this->account : throw new Exception('Аккаунт не инициализирован'),
'browser' => $this->browser ?? $this->browser = new browser([
'base_uri' => 'https://api.vk.com/method/',
'cookies' => true
]),
'proxy' => $this->proxy,
'captcha' => $this->captcha,
'messages_new' => $this->messages_new,
// Если свойство не найдено:
default => throw new Exception('Свойство не найдено: ' . $name)
};
}
/**
* Проверить свойство на инициализированность
*
* $name Название
*
* @return mixed
*/
public function __isset(string $name)
{
return match ($name) {
'id' => isset($this->id),
'session' => isset($this->session),
'key' => isset($this->key),
'account' => isset($this->account),
'version' => isset($this->version),
'browser' => isset($this->browser),
'proxy' => isset($this->proxy),
'captcha' => isset($this->captcha),
'messages_new' => isset($this->messages_new),
default => throw new Exception('Свойство не найдено: ' . $name)
};
}
/**
* Вызвать метод
*
* Ищет класс описывающий метод API ВКонтакте,
* создаёт и возвращает его объект
*
* $method Метод
* $params Параметры
*/
public function __call(string $method, array $params): method
{
if (class_exists($class = '\\hood\\vk\\api\\methods\\' . $method . 's')) {
// Если найден класс реализующий запрошенный метод
return new $class($this, ...$params);
}
throw new Exception('Метод не найден: ' . $method);
}
/**
* Вызвать статический метод
*
* Ищет класс описывающий метод API ВКонтакте,
* создаёт и возвращает его объект
*
* $method Метод
* $params Параметры
*/
public static function __callStatic(string $method, array $params): method
{
if (class_exists($class = '\\hood\\vk\\api\\methods\\' . $method . 's')) {
return $class(self, ...$params);
}
throw new Exception('Метод не найден: ' . $method);
}
/**
* Конвертировать в строку
*/
public function __toString(): string
{
return (string) $this->id;
}
}

View File

@ -0,0 +1,34 @@
<?php
declare(strict_types=1);
namespace hood\vk\robots;
use hood\vk\robots\robot;
use hood\accounts\vk as account;
/**
* Робот-пользователь
*
* @package hood\vk\robots
* @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
*/
final class user extends robot
{
/**
* Инициализация аккаунта
*
* @param account $account Аккаунт
*
* @return self
*/
public function account(account $account): self
{
parent::account($account);
$this->key = $account->key;
return $this;
}
}

View File

@ -2,7 +2,7 @@
declare(strict_types=1);
namespace mirzaev\vk\traits;
namespace hood\vk\traits;
/**
* Паттерн registry

View File

@ -2,7 +2,7 @@
declare(strict_types=1);
namespace mirzaev\vk\traits;
namespace hood\vk\traits;
use Exception;

View File

@ -0,0 +1 @@
[]

View File

@ -0,0 +1 @@
[]

View File

@ -4,16 +4,16 @@ declare(strict_types=1);
use PHPUnit\Framework\TestCase;
use mirzaev\vk\core;
use mirzaev\vk\robots\robot;
use mirzaev\vk\tests\settings;
use hood\vk\core,
hood\vk\robots\robot,
hood\vk\tests\settings;
use mirzaev\accounts\vk as account;
use hood\accounts\vk as account;
/**
* @testdox Фото
* @testdox Робот-группа
*/
final class photosTest extends TestCase
final class messagesTest extends TestCase
{
use settings;
@ -32,6 +32,20 @@ final class photosTest extends TestCase
*/
private static robot $robot;
/**
* @testdox Деинициализация аккаунта
* @afterClass
*/
public static function testAccountDeinit(): void
{
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, __DIR__ . '../../accounts');
// Деаутентификация
self::$account->deauth();
}
/**
* @testdox Инициализация аккаунта
* @beforeClass
@ -40,11 +54,11 @@ final class photosTest extends TestCase
{
// Проверка входных данных
if (empty(self::$project_id)) {
self::markTestSkipped('Не инициализирован идентификатор проекта');
self::$markTestSkipped('Не найден идентификатор проекта');
}
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, __DIR__ . '../../accounts');
// Запись режима SSL-протокола
self::$account->ssl = self::$ssl ?? true;
@ -54,9 +68,9 @@ final class photosTest extends TestCase
// Проверка входных данных
if (empty(self::$login)) {
self::markTestSkipped('Не инициализирован входной аккаунта');
self::$markTestSkipped('Не найден входной аккаунта');
} else if (empty(self::$password)) {
self::markTestSkipped('Не инициализирован пароль аккаунта');
self::$markTestSkipped('Не найден пароль аккаунта');
}
// Деаутентификация (на всякий случай)
@ -70,16 +84,16 @@ final class photosTest extends TestCase
}
/**
* @testdox Деинициализация аккаунта
* @afterClass
* @testdox Деинициализация робота
* @after
*/
public static function testAccountDeinit(): void
public function testRobotGroupDeinit(): void
{
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
// Очистка реестра
self::$core->delete();
// Деаутентификация
self::$account->deauth();
// Проверка
$this->assertEmpty(self::$core->get(self::$robot->id), 'Ошибка при деинициализации робота');
}
/**
@ -101,53 +115,12 @@ final class photosTest extends TestCase
$this->assertEquals(self::$core->robots, $count + 1, 'Ошибка при инициализации робота');
}
/**
* @testdox Деинициализация робота
* @after
*/
public function testRobotGroupDeinit(): void
{
// Очистка реестра
self::$core->delete();
// Проверка
$this->assertEmpty(self::$core->get(self::$robot->id), 'Ошибка при деинициализации робота');
}
/**
* @testdox Получение адреса сервера сообщений
* @testdox Инициализация робота
*/
public function testGetMessageServer(): void
public function testApiMethodMessagesNew(): void
{
// Получение адреса сервера
$response = self::$robot->key(self::$group_key)->photo()->getMessageServer();
// Проверка
$this->assertIsString($response->upload_url, 'Адрес сервера не получен');
}
/**
* @testdox Загрузка фото
*/
public function testUpload(): void
{
// Получение адреса сервера
$url = self::$robot->key(self::$group_key)->photo()->getMessageServer()->upload_url;
// Загрузка фото
$response = self::$robot->photo()->upload(fopen(self::$path_photo, 'r'), $url);
// Проверка
$this->assertIsString($response->hash, 'Фото не загружено');
}
/**
* @testdox Получение id фото для сообщения
*/
public function testGetPhoto(): void
{
// Проверка
self::$robot->key(self::$group_key)->photo()->getPhoto(self::$path_photo);
var_dump(self::$robot->message('Тестирование отправки сообщения', self::$target_id ?? 'pizba228'));
}
}

View File

@ -4,11 +4,11 @@ declare(strict_types=1);
use PHPUnit\Framework\TestCase;
use mirzaev\vk\core;
use mirzaev\vk\robots\robot;
use mirzaev\vk\tests\settings;
use hood\vk\core,
hood\vk\robots\robot,
hood\vk\tests\settings;
use mirzaev\accounts\vk as account;
use hood\accounts\vk as account;
/**
* @testdox Робот-группа
@ -33,7 +33,6 @@ final class groupTest extends TestCase
private static robot $robot;
/**
<<<<<<< HEAD
* @testdox Деинициализация аккаунта
* @afterClass
*/
@ -47,8 +46,6 @@ final class groupTest extends TestCase
}
/**
=======
>>>>>>> a45b5c327511a74d1fae5ab0e3a1dcc68e7dc3b4
* @testdox Инициализация аккаунта
* @beforeClass
*/
@ -56,11 +53,11 @@ final class groupTest extends TestCase
{
// Проверка входных данных
if (empty(self::$project_id)) {
self::markTestSkipped('Не инициализирован идентификатор проекта');
self::$markTestSkipped('Не найден идентификатор проекта');
}
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, __DIR__ . '../../accounts');
// Запись режима SSL-протокола
self::$account->ssl = self::$ssl ?? true;
@ -70,9 +67,9 @@ final class groupTest extends TestCase
// Проверка входных данных
if (empty(self::$login)) {
self::markTestSkipped('Не инициализирован входной аккаунта');
self::$markTestSkipped('Не найден входной аккаунта');
} else if (empty(self::$password)) {
self::markTestSkipped('Не инициализирован пароль аккаунта');
self::$markTestSkipped('Не найден пароль аккаунта');
}
// Деаутентификация (на всякий случай)
@ -86,7 +83,6 @@ final class groupTest extends TestCase
}
/**
<<<<<<< HEAD
* @testdox Деинициализация робота
* @after
*/
@ -97,18 +93,6 @@ final class groupTest extends TestCase
// Проверка
$this->assertEmpty(self::$core->get(self::$robot->id), 'Ошибка при деинициализации робота');
=======
* @testdox Деинициализация аккаунта
* @afterClass
*/
public static function testAccountDeinit(): void
{
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
// Деаутентификация
self::$account->deauth();
>>>>>>> a45b5c327511a74d1fae5ab0e3a1dcc68e7dc3b4
}
/**
@ -131,22 +115,6 @@ final class groupTest extends TestCase
}
/**
<<<<<<< HEAD
=======
* @testdox Деинициализация робота
* @after
*/
public function testRobotGroupDeinit(): void
{
// Очистка реестра
self::$core->delete();
// Проверка
$this->assertEmpty(self::$core->get(self::$robot->id), 'Ошибка при деинициализации робота');
}
/**
>>>>>>> a45b5c327511a74d1fae5ab0e3a1dcc68e7dc3b4
* @testdox Запись идентификатора
*/
public function testRobotGroupWriteId(): void
@ -165,7 +133,7 @@ final class groupTest extends TestCase
{
// Проверки
$this->assertNotNull(self::$robot->id, 'Не удалось прочитать идентификатор');
$this->assertNotEmpty(self::$core->get(self::$robot->id), 'Робот не инициализирован');
$this->assertNotEmpty(self::$core->get(self::$robot->id), 'Робот не найден');
}
/**
@ -187,7 +155,7 @@ final class groupTest extends TestCase
{
// Проверки
$this->assertNotNull(self::$robot->session, 'Не удалось прочитать сессию');
$this->assertNotEmpty(self::$core->get(self::$robot->id, self::$robot->session), 'Сессия не инициализирована');
$this->assertNotEmpty(self::$core->get(self::$robot->id, self::$robot->session), 'Сессия не найдена');
}
/**
@ -258,7 +226,6 @@ final class groupTest extends TestCase
}
/**
<<<<<<< HEAD
* @testdox Запись версии API
*/
public function testRobotGroupWriteVersion(): void
@ -277,13 +244,5 @@ final class groupTest extends TestCase
{
// Проверка
$this->assertNotNull(self::$robot->version, 'Не удалось прочитать версию');
=======
* @testdox Чтение API
*/
public function testRobotGroupReadApi(): void
{
// Проверка
$this->assertNotNull(self::$robot->key(self::$group_key)->api);
>>>>>>> a45b5c327511a74d1fae5ab0e3a1dcc68e7dc3b4
}
}

View File

@ -4,11 +4,11 @@ declare(strict_types=1);
use PHPUnit\Framework\TestCase;
use mirzaev\vk\core;
use mirzaev\vk\robots\robot;
use mirzaev\vk\tests\settings;
use hood\vk\core,
hood\vk\robots\robot,
hood\vk\tests\settings;
use mirzaev\accounts\vk as account;
use hood\accounts\vk as account;
/**
* @testdox Робот-пользователь
@ -33,7 +33,6 @@ final class userTest extends TestCase
private static robot $robot;
/**
<<<<<<< HEAD
* @testdox Деинициализация аккаунта
* @afterClass
*/
@ -47,8 +46,6 @@ final class userTest extends TestCase
}
/**
=======
>>>>>>> a45b5c327511a74d1fae5ab0e3a1dcc68e7dc3b4
* @testdox Инициализация аккаунта
* @beforeClass
*/
@ -56,11 +53,11 @@ final class userTest extends TestCase
{
// Проверка входных данных
if (empty(self::$project_id)) {
self::markTestSkipped('Не инициализирован идентификатор проекта');
self::$markTestSkipped('Не найден идентификатор проекта');
}
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, __DIR__ . '../../accounts');
// Запись режима SSL-протокола
self::$account->ssl = self::$ssl ?? true;
@ -70,9 +67,9 @@ final class userTest extends TestCase
// Проверка входных данных
if (empty(self::$login)) {
self::markTestSkipped('Не инициализирован входной аккаунта');
self::$markTestSkipped('Не найден входной аккаунта');
} else if (empty(self::$password)) {
self::markTestSkipped('Не инициализирован пароль аккаунта');
self::$markTestSkipped('Не найден пароль аккаунта');
}
// Деаутентификация (на всякий случай)
@ -86,7 +83,6 @@ final class userTest extends TestCase
}
/**
<<<<<<< HEAD
* @testdox Деинициализация робота
* @after
*/
@ -97,18 +93,6 @@ final class userTest extends TestCase
// Проверка
$this->assertEmpty(self::$core->get(self::$robot->id), 'Ошибка при деинициализации робота');
=======
* @testdox Деинициализация аккаунта
* @afterClass
*/
public static function testAccountDeinit(): void
{
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
// Деаутентификация
self::$account->deauth();
>>>>>>> a45b5c327511a74d1fae5ab0e3a1dcc68e7dc3b4
}
/**
@ -131,22 +115,6 @@ final class userTest extends TestCase
}
/**
<<<<<<< HEAD
=======
* @testdox Деинициализация робота
* @after
*/
public function testRobotGroupDeinit(): void
{
// Очистка реестра
self::$core->delete();
// Проверка
$this->assertEmpty(self::$core->get(self::$robot->id), 'Ошибка при деинициализации робота');
}
/**
>>>>>>> a45b5c327511a74d1fae5ab0e3a1dcc68e7dc3b4
* @testdox Запись идентификатора
*/
public function testRobotGroupWriteId(): void
@ -165,7 +133,7 @@ final class userTest extends TestCase
{
// Проверки
$this->assertNotNull(self::$robot->id, 'Не удалось прочитать идентификатор');
$this->assertNotEmpty(self::$core->get(self::$robot->id), 'Робот не инициализирован');
$this->assertNotEmpty(self::$core->get(self::$robot->id), 'Робот не найден');
}
/**
@ -187,7 +155,7 @@ final class userTest extends TestCase
{
// Проверки
$this->assertNotNull(self::$robot->session, 'Не удалось прочитать сессию');
$this->assertNotEmpty(self::$core->get(self::$robot->id, self::$robot->session), 'Сессия не инициализирована');
$this->assertNotEmpty(self::$core->get(self::$robot->id, self::$robot->session), 'Сессия не найдена');
}
/**
@ -233,7 +201,6 @@ final class userTest extends TestCase
}
/**
<<<<<<< HEAD
* @testdox Чтение ключа
*/
public function testRobotGroupReadKey(): void
@ -277,13 +244,5 @@ final class userTest extends TestCase
{
// Проверка
$this->assertNotNull(self::$robot->version, 'Не удалось прочитать версию');
=======
* @testdox Чтение API
*/
public function testRobotGroupReadApi(): void
{
// Проверка
$this->assertNotNull(self::$robot->key(self::$group_key)->api);
>>>>>>> a45b5c327511a74d1fae5ab0e3a1dcc68e7dc3b4
}
}

View File

@ -0,0 +1,68 @@
<?php
declare(strict_types=1);
namespace hood\vk\tests;
trait settings
{
/**
* @var int $id Идентификатор аккаунта
*/
protected static int $id = 214547089;
/**
* @var int $id Идентификатор вспомогательного аккаунта
*/
protected static int $target_id = 214547089;
/**
* @var string $password Входной аккаунта (если не указан ключ)
*/
protected static string $login = '79148817786';
/**
* @var string $password Пароль аккаунта (если не указан ключ)
*/
protected static string $password = 'Limboxergamasex1';
/**
* @var string $key Ключ аккаунта
*/
protected static string $key = '';
/**
* @var int $group_id Идентификатор группы
*/
protected static int $group_id = 191417381;
/**
* @var string $key Ключ группы
*/
protected static string $group_key = '5801f6117f61a1dc651e4347849d404f924858b6c15f381783197f1e22101e5cb7b6d8f61da8476424aeb';
/**
* @var float $version Версия API
*/
protected static float $version = 0;
/**
* @var int $project_id Идентификатор проекта
*/
protected static int $project_id = 7625813;
/**
* @var string $project_key Ключ проекта
*/
protected static string $project_key = 'Vv6LEC43seY86zctkumP';
/**
* @var string $project_service_key Сервисный ключ проекта
*/
protected static string $project_service_key = 'c17d6b72c17d6b72c17d6b7259c1093727cc17dc17d6b729efee947c77ef8d7dfc6b8b5';
/**
* @var bool $ssl SSL-протокол
*/
protected static bool $ssl = false;
}

View File

@ -1,2 +0,0 @@
/*
!.gitignore

View File

@ -1,52 +0,0 @@
<?php
// declare(strict_types=1);
// namespace mirzaev\vk\API;
// class CallBack extends CallBackAbstract
// {
// /**
// * Адрес для создания колбек-сервера
// *
// * @var string
// */
// private $url;
// /**
// * Пользовательский ключ колбек-сессии
// *
// * @var string
// */
// private $secret_key;
// /**
// * Ключ подтверждения колбек сессии
// *
// * @var string
// */
// private $confirmation_token;
// /**
// * @var int
// */
// private $group_id;
// public function __construct(object $group, array $params = []){
// $this->secret_key = $_ENV['CALLBACK_SECRET_KEY'];
// $this->url = $_ENV['SERVER_DOMAIN'];
// $this->group_id = $group->id;
// $this->group_id->request('groups.addCallbackServer', [
// 'group_id' => $this->group_id,
// 'url' => $this->url,
// 'title' => $this->group_id . 'CallBackServer',
// 'secret_key' => $this->secret_key
// ]);
// // $this->confirmation_token = request('groups.getCallbackConfirmationCode', [$this->group_id]);
// echo $this->confirmation_token;
// }
// public function sendOk(){
// echo 'ok';
// }
// }

View File

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

View File

@ -1,874 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\vk\api\methods;
// Файлы проекта
use mirzaev\vk\robots\robot,
mirzaev\vk\robots\group;
// Встроенные библиотеки
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;
}
/**
* Сообщение
*
* @method public static function put(RobotAbstract $from, int $to, string $message, int $mode = 2) Отправить сообщение
*
* @see https://vk.com/dev/messages.send
* @see https://vk.com/dev/messages.getById
*
* @package mirzaev\vk\api
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*
* @todo Доработать строгий режим отправки: проверку сообщения в беседе (не имеет ID сообщений)
*/
final class messages extends method
{
/**
* @var message_send $send_mode Режим отправки сообщений
*/
protected message_send $send_mode = message_send::simple;
/**
* @var random_id $generate_mode Режим генерации идентификатора сессии доставки сообщения
*/
protected random_id $generate_mode = random_id::crypto;
/**
* @var int|string|array|null $peer_id Получатель
*/
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;
/**
* Конструктор
*
* @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 string|null $text Текст
*
* @return static
*/
public function text(string|null $text): static
{
// Запись в свойство
$this->__set('text', $text);
return $this;
}
/**
* Записать: географическая ширина
*
* @param ?int $lat Географическая ширина
*
* @return static
*/
public function lat(?int $lat): static
{
// Запись в свойство
$this->__set('lat', $lat);
return $this;
}
/**
* Записать: географическая долгота
*
* @param ?int $long Географическая долгота
*
* @return static
*/
public function long(?int $long): static
{
// Запись в свойство
$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 ?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
*
* @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 Идентификатор сессии доставки сообщения (защита от повторных отправок)
*
* @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
*
* @todo
* 1. Написать обработчик ошибок возвращаемых ВКонтакте
* 2. Добавить параметр forward (не путать с forward_messages)
* 3. Добавить клавиатуру
* 4. Добавить шаблоны сообщений
* 5. Добавить content_source
*/
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 {
// Реинициализация настроек
$this->robot->api->reinit();
// Инициализация получателя
$this->receiver($peer_id);
// Инициализация идентификатора сессии доставки сообщения (защита от повторных отправок)
$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
if (!empty($message ??= $this->text)) $this->robot->api['message'] = $message;
// Инициализация широты
if (!empty($lat ??= $this->lat)) $this->robot->api['lat'] = $lat;
// Инициализация долготы
if (!empty($long ??= $this->long)) $this->robot->api['long'] = $long;
// Инициализация вложений
if (!empty($attachments ??= $this->robot->api->data)) $this->robot->api['attachment'] = implode(',', $attachments);
// Инициализация сообщения, на которое требуется ответить
if (!empty($reply_to ??= $this->reply_to)) $this->robot->api['reply_to'] = $reply_to;
// Инициализация пересылаемых сообщений
if (!empty($forward_messages ??= $this->forward_messages)) $this->robot->api['forward_messages'] = implode(',', $forward_messages);
// Инициализация стикера
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('Сообщение должно содержать текст, либо вложение');
// Запрос
$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 ($this->send_mode === message_send::check) {
// Надёжная доставка сообщения
if (!empty($request["response"])) {
// Ответ получен
// Реиницилазиция
$this->robot->api->reinit();
// Запрашиваемые сообщения
$this->robot->api['message_ids'] = $request["response"];
if ($this->robot->browser->request('POST', 'messages.getById', ['form_params' => $this->robot->api->settings])['response']['count'] === 0) {
// Сообщения не существует
//!!!!!!!!!!!!!!!!!!!!!!!!!!!
//!!!!!!!!!!!!!!!!!!!!!!!!!!
//!!!!!!!!!!!!!!!!!!!!!!!!!
// Повторная отправка
$this->send();
}
} else {
}
}
return $request->response;
}
/**
* Удалить сообщение
*
* @see https://dev.vk.com/method/messages.delete
*
* @param int|string|array|null $messages Получатель (message_ids + cmids)
* @param int|string|null $peer_id Идентификатор беседы
* @param bool $spam Пометить как спам?
* @param bool $delete_for_all Удалить для всех?
*
* @return int|array Идентификатор успешно отправленного сообщения или ответ сервера (подразумевается ошибка)
*
* @todo
* 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
{
// Реиницилазиция настроек
$this->robot->api->reinit();
if (isset($peer_id)) {
// Получен идентификатор беседы
// Инициализация идентификатора беседы
$this->robot->api['peer_id'] = $peer_id;
// Инициализация идентификаторов сообщений
$this->robot->api['cmids'] = $messages;
// Инициализация: "удалить для всех?"
$this->robot->api['delete_for_all'] = 1;
} else {
// Не получен идентификатор беседы
// Инициализация идентификаторов сообщений
$this->robot->api['message_ids'] = $messages;
// Инициализация: "удалить для всех?"
if ($delete_for_all) $this->robot->api['delete_for_all'] = 1;
}
// Инициализация: "сообщить о спаме?"
if ($spam) $this->robot->api['spam'] = $spam;
// Запрос
$request = json_decode($this->robot->browser->request('POST', 'messages.delete', ['form_params' => $this->robot->api->settings])->getBody()->getContents());
// Проверка на наличие ошибок в ответе от ВКонтакте
if (isset($request->error)) throw new Exception('ВКонтакте: ' . $request->error->error_msg, $request->error->error_code);
return $request->response;
}
/**
* Получить информацию о сообщении по id
*
* @param string $message_ids Идентификатор сообщения
*
* @return object Информация о сообщении
*
* @todo
* 1. Доделать, а лучше полностью переделать
*/
public function getById(int $message_ids): object
{
// Реиницилазиция
$this->robot->api->reinit();
// Идентификаторы сообщений. Максимум 100 идентификаторов
$this->robot->api['message_ids'] = $message_ids;
if ($this->robot instanceof group) {
// Если это группа
// Идентификатор группы
isset($this->robot->id) ? $this->robot->api['group_id'] = $this->robot->id : throw new Exception('Необходимо указать идентификатор сообщества');
}
// Запрос
$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'] .= ', ';
}
}
// Запрос
$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)
};
}
}

View File

@ -1,15 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\vk\api\methods;
/**
* Абстракция метода API ВКонтакте
*
* @package mirzaev\vk\api\methods
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
abstract class method
{
}

View File

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

View File

@ -1,340 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\vk\api;
use Throwable;
use Exception;
use ArrayAccess;
use mirzaev\vk\robots\robot;
/**
* Настройки соединения с API
*
* @var robot $robot Робот
* @var array $settings Настройки
* @var float $version Версия API
*
* @package mirzaev\vk\api
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
class settings implements ArrayAccess
{
/**
* Версия API ВКонтакте по умолчанию
*
* Должна иметь тип string потому, что PHP при стандартных настройках удаляет нули у float
*/
protected const VK_API_VERSION_DEFAULT = '5.131';
/**
* Конструктор
*/
public function __construct(
protected robot $robot,
protected array $settings = []
) {
if (empty($settings)) {
// Настройки не получены
// Инициализация
$this->_init();
}
}
/**
* Инициализация (безопасная)
*
* @var float $version Версия API (переопределять не рекомендуется)
*/
public function init(string $version = self::VK_API_VERSION_DEFAULT): self
{
// Инициализация
static $blocked = false;
if ($blocked) {
// Блокировка найдена
throw new Exception('Повторная инициализация запрещена', 500);
}
// Блокировка
$blocked = true;
// Инициализация
try {
$this->_init($version);
} catch (Throwable $t) {
throw new Exception('Не удалось инициализировать API', 500, $t->getPrevious());
}
return $this;
}
/**
* Реинициализация
*
* @param bool $purge Полная очистка
*/
public function reinit(bool $purge = false): self
{
// Реинициализация
try {
if ($purge) {
// Полная очистка
// Очистка
$this->settings = [];
} else {
// Инициализация буфера
$buffer = [];
if (isset($this->settings['v'])) {
// Найдена версия API (подразумевается использование робота-группы)
// Запись в буфер
$buffer['v'] = $this->settings['v'];
}
if (isset($this->settings['access_token'])) {
// Найден ключ группы (подразумевается использование робота-группы)
// Запись в буфер
$buffer['access_token'] = $this->settings['access_token'];
}
if (isset($this->settings['group_id'])) {
// Найден идентификатор группы (подразумевается использование робота-группы)
// Запись в буфер
$buffer['group_id'] = $this->settings['group_id'];
}
if (isset($this->settings['user_id'])) {
// Найден идентификатор пользователя (подразумевается использование робота-пользователя)
// Запись в буфер
$buffer['user_id'] = $this->settings['user_id'];
}
// Перенос данных из буфера
$this->settings = $buffer;
}
} catch (Throwable $t) {
throw new Exception('Не удалось инициализировать API', 500, $t->getPrevious());
}
return $this;
}
/**
* Инициализация
*
* @var float $version Версия API (переопределять не рекомендуется)
*/
protected function _init(string $version = self::VK_API_VERSION_DEFAULT): self
{
// Версия API
$this->settings['v'] = $version;
return $this;
}
/**
* Записать свойство
*
* @param string $name Название
* @param mixed $value Значение
*/
public function __set(string $name, mixed $value): void
{
match ($name) {
'settings' => isset($this->settings) ? throw new Exception('Запрещено перезаписывать настройки', 500) : $this->settings = $value,
'robot' => isset($this->robot) ? throw new Exception('Запрещено перезаписывать Робота', 500) : $this->robot = $value,
'data', 'attachments' => $this->offsetSet('attachments', $value),
default => $this->offsetSet($name, $value)
};
}
/**
* Прочитать свойство
*
* @param string $name Название
*/
public function __get(string $name): mixed
{
return match ($name) {
'settings' => $this->settings ?? throw new Exception('Настройки не инициализированы', 500),
'robot' => $this->robot ?? throw new Exception('Робот не инициализирован', 500),
'data', 'attachments' => $this->offsetGet('attachments'),
default => $this->offsetGet($name)
};
}
/**
* Проверить инициализированность свойства
*
* @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 offsetSet(mixed $offset, mixed $value): void
{
if (isset($this->settings)) {
if (strcasecmp($offset, 'settings') === 0) {
// Полная запись
throw new Exception('Запрещено перезаписывать настройки', 500);
} else if (
(strcasecmp($offset, 'data') === 0)
|| (strcasecmp($offset, 'attachment') === 0)
|| (strcasecmp($offset, 'attachments') === 0)
) {
// Записать вложения
if (is_array($value)) {
// Жесткая запись
$this->settings['attachments'] = $value;
return;
}
if (empty($this->settings['attachments']) || count($this->settings['attachments']) < 10) {
// Записано менее чем 10 вложений (от 0 до 9)
// Запись (конкатенация)
$this->settings['attachments'][] = $value;
return;
}
throw new Exception('Превышено ограничение на 10 вложений', 500);
} else {
// Запись по ключу или смещению
$this->settings[$offset] = $value;
return;
}
}
throw new Exception('Настройки не инициализированы', 500);
}
/**
* Прочитать по смещению
*/
public function offsetGet(mixed $offset): mixed
{
if (isset($this->settings)) {
if (strcasecmp($offset, 'settings') === 0) {
// Полное чтение
return $this->settings;
} else if (strcasecmp($offset, 'data') === 0 || strcasecmp($offset, 'attachments') === 0) {
// Прочитать вложения
return $this->settings['attachments'];
} else if (array_key_exists($offset, $this->settings)) {
// Прочитать по ключу или смещению
return $this->settings[$offset];
}
throw new Exception(is_int($offset) ? "Смещение $offset не найдено" : "Ключ $offset не найден", 404);
}
throw new Exception('Настройки не инициализированы', 500);
}
/**
* Проверить существование смещения
*
* @param mixed $offset Сдвиг
*
* @return bool Смещение существует?
*/
public function offsetExists(mixed $offset): bool
{
if (isset($this->settings)) {
if (strcasecmp($offset, 'settings') === 0) {
// Полная проверка
return isset($this->settings);
} else if (strcasecmp($offset, 'data') === 0 || strcasecmp($offset, 'attachments') === 0) {
// Проверка вложений
return array_key_exists('attachments', $this->settings);
} else {
// Проверка по ключу или смещению
return array_key_exists($offset, $this->settings);
}
}
throw new Exception('Настройки не инициализированы', 500);
}
/**
* Удалить по смещению
*/
public function offsetUnset(mixed $offset): void
{
if (isset($this->settings)) {
if (strcasecmp($offset, 'settings') === 0) {
// Полное удаление
unset($this->settings);
return;
} else if (strcasecmp($offset, 'data') === 0 || strcasecmp($offset, 'attachments') === 0) {
// Удаление вложений
unset($this->settings['attachments']);
return;
} else {
// Удаление по ключу или смещению
unset($this->settings[$offset]);
return;
}
}
throw new Exception('Настройки не инициализированы', 500);
}
}

View File

@ -1,267 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\vk;
use mirzaev\vk\robots\robot;
use mirzaev\vk\traits\singleton;
use mirzaev\vk\loggers\jasmo;
use exception;
/**
* Ядро
*
* @property-read int $robots Количество роботов
* @property string $timezone Временная зона (журналирование)
* @property array $path Пути (архитектура проекта)
*
* @method protected static function __construct() Инициализация
* @method public static function init() Запуск инициализации или получение инстанции
* @method public public function build() Сборщик
* @method public function set($id, $value) Запись в реестр
* @method public function get($id = null) Чтение из реестра
*
* @package mirzaev\vk
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
final class core
{
use singleton;
/**
* Счётчик роботов
*/
private int $robots = 0;
/**
* Реестр роботов
*/
private array $registry = [];
/**
* Временная зона
*
* Используется в логировании
*/
private readonly string $timezone;
/**
* Путь до корня проекта
*/
private readonly string $path_root;
/**
* Путь до папки журналов
*/
private readonly string $path_logs;
/**
* Путь до временной папки
*/
private readonly string $path_temp;
/**
* Запись в журнал
*
* @param string $file Файл для журналирования
*
* @return self
*
* @todo Добавить установку иного журналиста по спецификации PSR-3
*/
public function journal(string $file = null): self
{
// Инициализация журналиста (требует переработки)
jasmo::init()::post($file)::postErrorHandler()::postShutdownHandler();
return $this;
}
/**
* Записать в реестр
*
* @param int $id
* @param robot $robot
*
* @see mirzaev\vk\traits\registry Модификация метода
*
* @return void
*/
public function write(int $id, robot $robot): void
{
try {
// Инициализация уникального идентификатора сессии
$session = count($this->read($id));
} catch (exception $e) {
if ($e->getCode() === 404) {
// Робота или сессии не существует
$session = 0;
}
} finally {
// Записать новую сессию
$this->registry[$id][$session] = $robot;
// Прединкрементация счётчика роботов
++$this->robots;
}
}
/**
* Прочитать из реестра
*
* Если не передать идентификатор, то вернёт все значения
*
* @param int|null $id Идентификатор
* @param int|null $session Сессия
*
* @see mirzaev\vk\traits\registry Модификация метода
*
* @return mixed Весь реестр, робота или сессию робота
*/
public function read(int|null $id = null, int|null $session = null): mixed
{
if (isset($id)) {
// Робот передан
if (array_key_exists($id, $this->registry)) {
// Робот найден
if (isset($session)) {
// Сессия робота передана
if (array_key_exists($session, $this->registry[$id])) {
// Сессия робота найдена
return $this->registry[$id][$session];
}
throw new exception("Сессия $session робота с идентификатором $id не найдена", 404);
}
return $this->registry[$id];
} else {
throw new exception("Робот с идентификатором $id не найден", 404);
}
}
return $this->registry;
}
/**
* Удалить из реестра
*
* @param int|null $id Идентификатор
* @param int|null $session Сессия
*
* @return void
*
* @see mirzaev\vk\traits\registry Модификация метода
*/
public function delete(int|null $id = null, int|null $session = null): void
{
if (isset($id)) {
// Робот передан
if (array_key_exists($id, $this->registry)) {
// Робот найден
if (isset($session)) {
// Сессия передана
if (array_key_exists($session, $this->registry[$id])) {
// Сессия найдена
// Постдекрементация счётчика роботов
--$this->robots;
// Удаление сессии
unset($this->registry[$id][$session]);
return;
}
throw new exception("Сессия $session робота с идентификатором $id не найдена", 404);
}
// Вычитание из счётчика количества сессий робота
$this->robots = $this->robots - count($this->registry[$id]);
// Удаление робота и всех его сессий
unset($this->registry[$id]);
return;
}
throw new exception("Робот с идентификатором $id не найден", 404);
}
// Полная очистка
$this->registry = [];
}
/**
* Записать свойство
*
* @param string $name Название
* @param mixed $value Значение
*
* @return void
*/
public function __set(string $name, mixed $value): void
{
match ($name) {
'timezone' => !isset($this->timezone) ? $this->timezone = $value : throw new exception('Запрещено переопределять часовой пояс', 500),
'path_root' => !isset($this->path_root) ? $this->path_root = $value : throw new exception('Запрещено переопределять корневой каталог', 500),
'path_logs' => !isset($this->path_logs) ? $this->path_logs = $value : throw new exception('Запрещено переопределять каталог журналов', 500),
'path_temp' => !isset($this->path_temp) ? $this->path_temp = $value : throw new exception('Запрещено переопределять каталог временных файлов', 500),
default => throw new exception("Свойство $name не обнаружено", 404)
};
}
/**
* Прочитать свойство
*
* Записывает значение по умолчанию, если свойство не инициализировано
*
* @param mixed $name Название
*
* @return mixed
*/
public function __get(string $name): mixed
{
return match ($name) {
'robots' => $this->robots,
'timezone' => $this->timezone ?? $this->timezone = 'Europe/Moscow',
'path_root' => $this->path_root ?? $this->path_root = dirname(__DIR__),
'path_logs' => $this->path_logs ?? $this->path_logs = $this->__get('path_root') . '/logs',
'path_temp' => $this->path_temp ?? $this->path_temp = $this->__get('path_root') . '/temp',
default => throw new exception("Свойство \"\$$name\" не обнаружено", 404)
};
}
/**
* Вызвать метод
*
* Ищет класс описывающий робота,
* создаёт и возвращает его объект
*
* @param string $method Метод
* @param array $params Параметры
*
* @return robot
*/
public function __call(string $method, array $params): robot
{
if (class_exists($robot = '\\mirzaev\\vk\\robots\\' . $method)) {
// Если найден класс реализующий запрошенного робота
return new $robot(...$params);
} else {
throw new exception("Робот $method не найден", 404);
}
}
}

View File

@ -1,293 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\vk\robots;
use Exception;
use mirzaev\vk\core,
mirzaev\vk\proxies\proxy,
mirzaev\vk\captcha\captcha,
mirzaev\vk\api\settings as api,
mirzaev\vk\api\methods\method;
use mirzaev\accounts\vk as account;
use GuzzleHttp\Client as browser;
/**
* Робот
*
* @var int $id Идентификатор
* @var int $session Сессия
* @var string $key Ключ
* @var api $api API ВКонтакте
* @var account $account Аккаунт
* @var browser $browser Браузер
*
* @var int $messages_mode Режим отправки сообщений
*
* @method public function __construct(int $id = null) Конструктор
* @method public function key(string $key) Инициализация ключа
* @method public function account(account $account) Инициализация аккаунта
* @method public function __set($name, $value) Запись свойства
* @method public function __get($name) Чтение свойства
* @method public function __isset($name) Проверка на инициализированность свойства
* @method public function __call(string $method, array $params) Вызов метода
* @method public static function __callStatic(string $method, array $params) Вызов статического метода
* @method public function __toString() Конвертация в строку
*
* @package mirzaev\vk\robots
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
abstract class robot
{
/**
* @var int $session Сессия
*/
protected readonly int $session;
/**
* @var account $account Аккаунт ВКонтакте
*/
private readonly account $account;
/**
* @var api $api API ВКонтакте
*/
protected readonly api $api;
/**
* @var browser $browser Браузер
*/
protected readonly browser $browser;
/**
* Конструктор
*
* @param int|null $id Идентификатор робота
* @param string|null $key Ключ API ВКонтакте
*/
public function __construct(
protected ?int $id = null,
protected ?string $key = null
) {
// Инициализация ядра
$core = core::init();
// Идентификация робота
$this->id = $id ?? $core->robots + 1;
// Регистрация робота в ядре
$core->write($this->id, $this);
// Идентификация сессии робота
$this->session = count($core->read($this->id));
// Инициализация настроек API
$this->api();
}
/**
* Инициализация ключа
*
* @param string|null $key Ключ
*
* @return string|self Ключ при чтении или инстанцию робота при записи
*/
public function key(string|null $key = null): string|self
{
if (isset($key)) {
// Ключ передан (подразумевается как запись)
if (isset($this->key)) {
// Ключ уже инициализирован
throw new Exception('Запрещено перезаписывать ключ', 500);
} else {
// Ключ ещё не инициализирован
// Запись ключа
$this->key = $key;
// Инициализация данных в настройках API
$this->api()['access_token'] = $key;
}
return $this;
}
// Ключ не передан (подразумевается как чтение)
return $this->key;
}
/**
* Инициализация аккаунта
*
* @param account $account Аккаунт
*
* @return account|self Аккаунт при чтении или инстанцию робота при записи
*/
public function account(account|null $account = null): account|self
{
if (isset($account)) {
// Аккаунт передан (подразумевается как запись)
if (isset($this->account)) {
// Аккаунт уже инициализирован
throw new Exception('Запрещено перезаписывать аккаунт', 500);
} else {
// Аккаунт ещё не инициализирован
// Запись аккаунта
$this->account = $account;
}
return $this;
}
// Аккаунт не передан (подразумевается как чтение)
return $this->account;
}
/**
* Инициализация API
*
* @return api Инстанция настроек API
*/
public function api(): api
{
if (!isset($this->api)) {
// Настройки API ещё не инициализированы
// Запись инстанции настроек API
$this->api = new api($this);
}
return $this->api;
}
/**
* Записать свойство
*
* @param string $name Название
* @param mixed $value Значение
*
* @return void
*/
public function __set(string $name, mixed $value): void
{
match ($name) {
'id' => empty($this->id) ?: $this->id = $value,
'session' => empty($this->session) ?: $this->session = $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
};
}
/**
* Прочитать свойство
*
* @param string $name Название
*
* @return mixed
*/
public function __get(string $name): mixed
{
return match ($name) {
'id' => $this->id ?? throw new Exception('Идентификатор не инициализирован', 500),
'session' => $this->session ?? throw new Exception('Сессия не инициализирована', 500),
'key' => $this->key(),
'account' => $this->account(),
'api' => $this->api(),
'browser' => $this->browser ?? $this->browser = new browser([
'base_uri' => 'https://api.vk.com/method/',
'cookies' => true
]),
'messages_new' => $this->messages_new,
default => throw new Exception("Свойство $name не найдено", 404)
};
}
/**
* Проверить на инициализированность
*
* @param mixed $name Название
*/
public function __isset(string $name): bool
{
return match ($name) {
'id' => isset($this->id),
'key' => isset($this->key),
default => false
};
}
/**
* Вызвать метод
*
* Ищет класс описывающий метод API ВКонтакте,
* создаёт и возвращает его объект
*
* @param string $method Метод
* @param array $params Параметры
*
* @return method
*/
public function __call(string $method, array $params): method
{
if (class_exists($class = '\\mirzaev\\vk\\api\\methods\\' . $method . 's')) {
// Если найден класс реализующий запрошенный метод
return new $class($this, ...$params);
}
throw new Exception("Метод $method не найден", 404);
}
/**
* Вызвать статический метод
*
* Ищет класс описывающий метод API ВКонтакте,
* создаёт и возвращает его объект
*
* @param string $method Метод
* @param array $params Параметры
*
* @return method
*/
public static function __callStatic(string $method, array $params): method
{
if (class_exists($class = '\\mirzaev\\vk\\api\\methods\\' . $method . 's')) {
return $class(self, ...$params);
}
throw new Exception("Метод $method не найден", 404);
}
/**
* Конвертировать в строку
*
* @return string
*/
public function __toString(): string
{
return (string) $this->id;
}
/**
* Клонировать объект
*
* @return void
*/
public function __clone(): void {
// Инициализация робота
$this->__construct($this->id, $this->key);
}
}

View File

@ -1,57 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\vk\robots;
use mirzaev\vk\robots\robot;
use mirzaev\accounts\vk as account;
/**
* Робот-пользователь
*
* @package mirzaev\vk\robots
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
*/
final class user extends robot
{
/**
* Конструктор
*
* @param int|null $id Идентификатор
* @param string|null $key Ключ
*/
public function __construct(
protected readonly int|null $id = null,
protected readonly string|null $key = null
) {
parent::__construct($id, $key);
// Инициализация данных API
$this->api['user_id'] = $this->id;
}
/**
* Инициализация аккаунта
*
* @param account $account Аккаунт
*
* @return account|self Аккаунт при чтении или инстанцию робота при записи
*/
public function account(account|null $account = null): account|self
{
if (isset($account)) {
// Передан аккаунт
if (isset($account->key)) {
// Ключ инициализирован
// Инициализация данных в настройках API
$this->api()['access_token'] = $account->key;
}
}
return parent::account($account);
}
}

View File

@ -1,2 +0,0 @@
/*
!.gitignore

View File

@ -1 +0,0 @@
/settings.php

View File

@ -1,2 +0,0 @@
/*
!.gitignore

View File

@ -1,273 +0,0 @@
<?php
declare(strict_types=1);
use PHPUnit\Framework\TestCase;
use mirzaev\vk\core;
use mirzaev\vk\robots\robot;
use mirzaev\vk\tests\settings;
use mirzaev\accounts\vk as account;
use Exception as RealException;
/**
* @testdox API ВКонтакте
*/
final class apiTest extends TestCase
{
use settings;
/**
* @var core $core Ядро фреймворка
*/
private static core $core;
/**
* @var account $account Аккаунт
*/
protected static account $account;
/**
* @var robot $robot Робот
*/
private static robot $robot;
/**
* @testdox Инициализация аккаунта
* @beforeClass
*/
public function testAccountInit(): void
{
// Проверка входных данных
if (empty(self::$project_id)) {
self::markTestSkipped('Не инициализирован идентификатор проекта');
}
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
// Запись режима SSL-протокола
self::$account->ssl = self::$ssl ?? true;
if (empty(self::$key)) {
// Если не указан ключ
// Проверка входных данных
if (empty(self::$login)) {
self::markTestSkipped('Не инициализирован входной аккаунта');
} else if (empty(self::$password)) {
self::markTestSkipped('Не инициализирован пароль аккаунта');
}
// Деаутентификация (на всякий случай)
self::$account->deauth();
// Аутентификация и генерация ключа
self::$key = self::$account->auth(self::$login, self::$password)->key(self::$project_id);
}
$this->assertNotNull(self::$key, 'Ошибка при инициализации ключа аккаунта');
}
/**
* @testdox Деинициализация аккаунта
* @afterClass
*/
public static function testAccountDeinit(): void
{
// Инициализация аккаунта
self::$account = new account(self::$id ?? rand(0, 10), self::$path_accounts);
// Деаутентификация
self::$account->deauth();
}
/**
* @testdox Инициализация робота-группы
* @before
*/
public function testRobotGroupInit(): void
{
// Инициализация ядра
self::$core = core::init();
// Сохранение количества роботов
$count = self::$core->robots;
// Инициализация робота
self::$robot = self::$core->group(self::$group_id ?? rand(0, 10));
// Проверка
$this->assertSame(self::$core->robots, $count + 1, 'Ошибка при инициализации робота-группы');
}
/**
* @testdox Деинициализация робота-группы
* @after
*/
public function testRobotGroupDeinit(): void
{
// Очистка реестра
self::$core->delete();
// Проверка выброса исключения (НЕ РАБОТАЕТ, ВЕРОЯТНО БАГ)
// $this->expectExceptionMessage('Робот с идентификатором ' . self::$robot->id . ' не найден');
// $this->expectExceptionCode(404);
try {
// Чтение
self::$core->read(self::$robot->id);
} catch (RealException $e) {
// Проверка
$this->assertSame('Робот с идентификатором ' . self::$robot->id . ' не найден', $e->getMessage(), 'Не удалось удалить робота');
}
}
/**
* @testdox Инициализация
*/
public function testInit(): void
{
// Инициализация
$settings = self::$robot->key(self::$group_key)->api->init(self::$version);
// Проверка
$this->assertNotNull($settings['access_token']);
$this->assertNotNull($settings['v']);
$this->assertSame($settings['v'], self::$version);
// Проверка
$this->expectExceptionMessage('Повторная инициализация запрещена');
// Инициализация (повторная)
$settings = self::$robot->api->init(self::$version);
}
/**
* @testdox Реинициализация
*/
public function testReinit(): void
{
// Реинициализация
self::$robot->key(self::$group_key)->api->reinit();
}
/**
* @testdox Запись и чтение параметра
*/
public function testWriteAndReadParameter(): void
{
// Запись
self::$robot->key(self::$group_key)->api['key'] = 'value';
// Проверка
$this->assertSame('value', self::$robot->api['key'], 'Не удалось записать или прочитать параметр');
}
/**
* @testdox Чтение неинициализированного параметра
*/
public function testReadUndefinedParameter(): void
{
// Проверка выброса исключения
$this->expectExceptionMessage('Ключ key не найден');
// Чтение
self::$robot->key(self::$group_key)->api['key'];
}
/**
* @testdox Выбор получателя по идентификатору
*/
public function testChooseDestinationById(): void
{
// Выбор получателя
self::$robot->key(self::$group_key)->api->destination(self::$target_id);
// Проверка
$this->assertSame(self::$target_id, self::$robot->api['peer_id'], 'Не удалось выбрать получателя по идентификатору');
}
/**
* @testdox Выбор получателей по идентификаторам
*/
public function testChooseDestinationsByIds(): void
{
// Выбор получателей
self::$robot->key(self::$group_key)->api->destination([self::$target_id, self::$target_id]);
// Проверка
$this->assertSame([self::$target_id, self::$target_id], self::$robot->api['user_ids'], 'Не удалось выбрать получателей по идентификаторам');
}
/**
* @testdox Выбор получателя по домену
*/
public function testChooseDestinationByDomain(): void
{
// Выбор получателя
self::$robot->key(self::$group_key)->api->destination(self::$target_domain);
// Проверка
$this->assertSame(self::$target_domain, self::$robot->api['domain'], 'Не удалось выбрать получателя по домену');
}
/**
* @testdox Запись, чтение и удаление вложений
*/
public function testWriteAndReadAttachments(): void
{
// Инициализация
self::$robot->key(self::$group_key);
// Запись
self::$robot->api['attachments'] = 'photo0000_0000';
self::$robot->api['attachments'] = 'video0000_0000';
self::$robot->api['attachments'] = 'audio0000_0000';
// Проверка
$this->assertSame(['photo0000_0000', 'video0000_0000', 'audio0000_0000'], self::$robot->api['attachments'], 'Не удалось записать или прочитать вложения');
// Удаление одного вложения
unset(self::$robot->api['attachments'][0]);
// Реинициализация смещений (для точной проверки)
self::$robot->api['attachments'] = array_values(self::$robot->api['attachments']);
// Проверка
$this->assertSame(['video0000_0000', 'audio0000_0000'], self::$robot->api['attachments'], 'Не удалось удалить или прочитать вложения');
// Удаление всех вложений
unset(self::$robot->api['attachments']);
// Проверка
$this->assertNull(self::$robot->api['attachments'], 'Не удалось удалить вложения');
}
/**
* @testdox Запись вложений с превышением ограничения
*/
public function testWriteWithOverflowAttachments()
{
// Проверка выброса исключения
$this->expectExceptionMessage('Превышено ограничение на 10 вложений');
// Инициализация
self::$robot->key(self::$group_key);
// Запись (11 вложений)
self::$robot->api['attachments'] = 'photo0000_0000';
self::$robot->api['attachments'] = 'video0000_0000';
self::$robot->api['attachments'] = 'audio0000_0000';
self::$robot->api['attachments'] = 'photo0000_0000';
self::$robot->api['attachments'] = 'video0000_0000';
self::$robot->api['attachments'] = 'audio0000_0000';
self::$robot->api['attachments'] = 'photo0000_0000';
self::$robot->api['attachments'] = 'video0000_0000';
self::$robot->api['attachments'] = 'audio0000_0000';
self::$robot->api['attachments'] = 'photo0000_0000';
self::$robot->api['attachments'] = 'video0000_0000';
}
}

View File

@ -1,333 +0,0 @@
<?php
declare(strict_types=1);
use PHPUnit\Framework\TestCase;
use mirzaev\vk\core;
use mirzaev\vk\robots\robot;
use mirzaev\vk\tests\settings;
use mirzaev\accounts\vk as account;
use mirzaev\accounts\vk;
/**
* @testdox [МЕТОД] Сообщения
*/
final class messagesTest extends TestCase
{
use settings;
/**
* @var core $core Ядро фреймворка
*/
private static core $core;
/**
* @var account $account Аккаунт
*/
protected static account $account;
/**
* @var robot $robot Робот
*/
private static robot $robot;
/**
* @testdox Инициализация аккаунта
* @beforeClass
*/
public function testAccountInit(): void
{
// Проверка входных данных
if (empty(self::$project_id)) {
self::markTestSkipped('Не инициализирован идентификатор проекта');
}
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
// Запись режима SSL-протокола
self::$account->ssl = self::$ssl ?? true;
if (empty(self::$key)) {
// Если не указан ключ
// Проверка входных данных
if (empty(self::$login)) {
self::markTestSkipped('Не инициализирован входной аккаунта');
} else if (empty(self::$password)) {
self::markTestSkipped('Не инициализирован пароль аккаунта');
}
// Деаутентификация (на всякий случай)
self::$account->deauth();
// Аутентификация и генерация ключа
self::$key = self::$account->auth(self::$login, self::$password)->key(self::$project_id);
}
$this->assertNotNull(self::$key, 'Ошибка при инициализации ключа аккаунта');
}
/**
* @testdox Деинициализация аккаунта
* @afterClass
*/
public static function testAccountDeinit(): void
{
// Инициализация аккаунта
self::$account = new account(empty(self::$id) ? rand(0, 10) : self::$id, self::$path_accounts);
// Деаутентификация
self::$account->deauth();
}
/**
* @testdox Инициализация робота
* @before
*/
public function testRobotGroupInit(): void
{
// Инициализация ядра
self::$core = core::init();
// Сохранение количества роботов
$count = self::$core->robots;
// Инициализация робота
self::$robot = self::$core->group(empty(self::$group_id) ? rand(0, 10) : self::$group_id);
// Проверка
$this->assertSame(self::$core->robots, $count + 1, 'Ошибка при инициализации робота');
}
/**
* @testdox Деинициализация робота
* @after
*/
public function testRobotGroupDeinit(): void
{
// Очистка реестра
self::$core->delete();
// Проверка
$this->assertEmpty(self::$core->read(self::$robot->id), 'Ошибка при деинициализации робота');
}
/**
* @testdox Чтение текста
*/
public function testReadText(): void
{
// Проверка выброса исключения
$this->expectExceptionMessage('Текст не инициализирован');
// Чтение текста
self::$robot->message()->text;
}
/**
* @testdox Запись текста
*/
public function testWriteText(): void
{
// Запись текста
$message = self::$robot->message()->text('text');
// Проверка
$this->assertNotNull($message->text);
}
/**
* @testdox Запись текста (повторная)
*/
public function testWriteTextWhenHeIsAlreadyWrited(): void
{
// Запись текста
$message = self::$robot->message()->text('hello');
// Повторная запись текста
$message->text(' world');
// Проверка
$this->assertSame('hello world', $message->text, );
}
/**
* @testdox Отправка текста
*/
public function testSendText(): void
{
// Отправка сообщения
$response = self::$robot->key(self::$group_key)->message('Тестовое сообщение')->send(self::$target_id);
// Проверка
$this->assertIsInt($response, 'Сообщение не отправленно');
}
/**
* @testdox Получение информации о сообщении
*/
public function testGetById(): void
{
// Отправка сообщения
$id = self::$robot->key(self::$group_key)->message('Теста метода getByID')->send(self::$target_id);
// Получение информации
$response = self::$robot->message()->getById($id);
// Проверка
$this->assertIsArray($response->items, 'Информация не получена');
}
/**
* @testdox Чтение Вложений
*/
public function testReadAttachments(): void
{
// Проверка выброса исключеия
$this->expectExceptionMessage('Вложения не инициализированны');
// Проверка
self::$robot->message()->data;
}
/**
* @testdox Запись вложений (методом)
*/
public function testWriteAttachments(): void
{
// Запись вложений
$message = self::$robot->message()->attachments('Вложение');
// Проверка
$this->assertSame(['Вложение'], $message->data);
}
/**
* @testdox Запись фото
*/
public function testWriteImage(): void
{
// Запись фото
$message = self::$robot->key(self::$group_key)->message()->image(self::$path_photo);
// Проверка
$this->assertNotEmpty($message->data);
}
/**
* @testdox Отправка фото
*/
public function testSendPhoto(): void
{
// Запись фото
$message = self::$robot->key(self::$group_key)->message('Тест отправки фото')->image(self::$path_photo);
// Отправка сообщения
$id = $message->send(self::$target_id);
// Получене информации для проверки
$message = $message->getById($id);
// Проверка
$this->assertNotEmpty($message->items[0]->attachments, 'Фото не отправлено');
}
/**
* @testdox Чтение пересылаемых сообщений
*/
public function testReadForward(): void
{
// Проверка выброса исключеия
$this->expectExceptionMessage('Пересылаемые сообщения не инициализированны');
// Проверка
self::$robot->message()->forwardMessages;
}
/**
* @testdox Запись пересылаемых сообщений
*/
public function testWriteForward(): void
{
// Запись пересылаемых сообщений
$message = self::$robot->message()->forward(123456);
// Проверка
$this->assertNotEmpty($message->forwardMessages);
}
/**
* @testdox Пересылка сообщений
*/
public function testSendForward(): void
{
// Отправка пересылаемого сообщения
$id = self::$robot->key(self::$group_key)->message('Это сообщение будет переслано')->send(self::$target_id);
// Запись пересылаемых сообщений
$message = self::$robot->message('Тест пересылки сообщений')->forward($id);
// Отпрравка пересылки сообщения
$id = $message->send(self::$target_id);
// Получене информации для проверки
$message = self::$robot->message()->getById($id);
// Проверка
$this->assertNotEmpty($message->items[0]->fwd_messages, 'Сообщение не пересланно');
}
/**
* @testdox Чтение ответного сообщения
*/
public function testReadReply(): void
{
// Проверка выброса исключеия
$this->expectExceptionMessage('Ответное сообщение не инициализированно');
// Проверка
self::$robot->message()->ReplyMessage;
}
/**
* @testdox Запись ответного сообщения
*/
public function testWriteReply(): void
{
// Запись ответного сообщения
$message = self::$robot->message()->Reply(123456);
// Проверка
$this->assertNotNull($message->ReplyMessage);
}
/**
* @testdox Ответ на сообщение
*/
public function testSendReply(): void
{
// Отправка ответного сообщения
$id = self::$robot->key(self::$group_key)->message('Будет ответ на это сообщение')->send(self::$target_id);
// Запись ответного сообщения
$message = self::$robot->message('Тест ответа на сообщение')->reply($id);
// Отправка ответа на сообщение
$id = $message->send(self::$target_id);
// Получене информации для проверки
$message = self::$robot->message()->getById($id);
// Проверка
$this->assertNotEmpty($message->items[0]->reply_message, 'Сообщение не пересланно');
}
}

View File

@ -1,90 +0,0 @@
<?php
declare(strict_types=1);
namespace mirzaev\vk\tests;
/**
* Настройки окружения для тестирования
*
* Скопировать данные в файл "settings.php" и вписать свои значения параметров
*
* @todo Разгруппировать свойства и привести в понимаемый для тех кто только начал знакомиться с проектом вид
*/
trait settings
{
/**
* @var string $path_account Путь до директории с данными аккаунтов
*/
protected static string $path_accounts = __DIR__ . '/accounts';
/**
* @var string $path_images Путь до директории с изображениями
*/
protected static string $path_images = __DIR__ . '/storage/images';
/**
* Идентификатор аккаунта
*/
protected static int $id = 0;
/**
* Идентификатор вспомогательного аккаунта
*/
protected static int $target_id = 0;
/**
* Домен вспомогательного аккаунта
*/
protected static string $target_domain = '';
/**
* Входной аккаунта (если не указан ключ)
*/
protected static string $login = '';
/**
* Пароль аккаунта (если не указан ключ)
*/
protected static string $password = '';
/**
* Ключ аккаунта
*/
protected static string $key = '';
/**
* Идентификатор группы
*/
protected static int $group_id = 0;
/**
* Ключ группы
*/
protected static string $group_key = '';
/**
* Версия API
*/
protected static float $version = 5.124;
/**
* Идентификатор проекта
*/
protected static int $project_id = 0;
/**
* Ключ проекта
*/
protected static string $project_key = '';
/**
* Сервисный ключ проекта
*/
protected static string $project_service_key = '';
/**
* SSL-протокол
*/
protected static bool $ssl = false;
}