Compare commits
17 Commits
Author | SHA1 | Date | |
---|---|---|---|
d0ce9e47af | |||
b2088df8fb | |||
cb1388722c | |||
![]() |
11be80b0ad | ||
![]() |
48a8908afd | ||
![]() |
8f5f5b44de | ||
![]() |
8e7972d933 | ||
e7da9978d0 | |||
4daa93799e | |||
0012a31e6b | |||
c5d83ceee5 | |||
d21e421b2e | |||
0feecd605f | |||
2947dd694a | |||
b70d384053 | |||
3efe35fd30 | |||
f6c1d756d2 |
2
.gitignore
vendored
Normal file → Executable file
2
.gitignore
vendored
Normal file → Executable file
@@ -1 +1,3 @@
|
||||
vendor
|
||||
composer.lock
|
||||
!.gitignore
|
||||
|
11
LICENSE
Normal file
11
LICENSE
Normal file
@@ -0,0 +1,11 @@
|
||||
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
|
||||
Version 2, December 2004
|
||||
|
||||
Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
|
||||
|
||||
Everyone is permitted to copy and distribute verbatim or modified copies of this license document, and changing it is allowed as long as the name is changed.
|
||||
|
||||
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
|
||||
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||
|
||||
0. You just DO WHAT THE FUCK YOU WANT TO.
|
3
README.md
Normal file
3
README.md
Normal file
@@ -0,0 +1,3 @@
|
||||
# PHP 8.2 Framework for working with ArangoDB
|
||||
|
||||
🤟 Very simple and flexible, easy to scale and integrate
|
82
composer.json
Normal file → Executable file
82
composer.json
Normal file → Executable file
@@ -1,35 +1,47 @@
|
||||
{
|
||||
"name": "mirzaev/arangodb",
|
||||
"description": "Реализация управления хранилищем данных ArangoDB",
|
||||
"keywords": [
|
||||
"ArangoDB"
|
||||
],
|
||||
"type": "library",
|
||||
"license": "WTFPL",
|
||||
"homepage": "https://git.hood.su/mirzaev/arangodb",
|
||||
"authors": [
|
||||
{
|
||||
"name": "Arsen Mirzaev Tatyano-Muradovich",
|
||||
"email": "arsen@mirzaev.sexy",
|
||||
"homepage": "https://mirzaev.sexy",
|
||||
"role": "Developer"
|
||||
}
|
||||
],
|
||||
"require": {
|
||||
"php": "^8.0.0",
|
||||
"triagens/arangodb": "~3.2"
|
||||
},
|
||||
"require-dev": {
|
||||
"phpunit/phpunit": "^9.3.3"
|
||||
},
|
||||
"autoload": {
|
||||
"psr-4": {
|
||||
"mirzaev\\arangodb\\": "mirzaev/arangodb/system"
|
||||
}
|
||||
},
|
||||
"autoload-dev": {
|
||||
"psr-4": {
|
||||
"mirzaev\\arangodb\\tests\\": "mirzaev/arangodb/tests"
|
||||
}
|
||||
}
|
||||
}
|
||||
{
|
||||
"name": "mirzaev/arangodb",
|
||||
"description": "Simple PHP-framework for ArangoDB",
|
||||
"readme": "README.md",
|
||||
"keywords": [
|
||||
"ArangoDB"
|
||||
],
|
||||
"type": "library",
|
||||
"license": "WTFPL",
|
||||
"homepage": "https://git.hood.su/mirzaev/arangodb",
|
||||
"authors": [
|
||||
{
|
||||
"name": "Arsen Mirzaev Tatyano-Muradovich",
|
||||
"email": "arsen@mirzaev.sexy",
|
||||
"homepage": "https://mirzaev.sexy",
|
||||
"role": "Developer"
|
||||
}
|
||||
],
|
||||
"support": {
|
||||
"email": "arsen@mirzaev.sexy",
|
||||
"wiki": "https://git.mirzaev.sexy/mirzaev/arangodb/manual",
|
||||
"issues": "https://git.mirzaev.sexy/mirzaev/arangodb/issues"
|
||||
},
|
||||
"funding": [
|
||||
{
|
||||
"type": "funding",
|
||||
"url": "https://fund.mirzaev.sexy"
|
||||
}
|
||||
],
|
||||
"require": {
|
||||
"php": "^8.2",
|
||||
"triagens/arangodb": "~3.8"
|
||||
},
|
||||
"require-dev": {
|
||||
"phpunit/phpunit": "^9.3.3"
|
||||
},
|
||||
"autoload": {
|
||||
"psr-4": {
|
||||
"mirzaev\\arangodb\\": "mirzaev/arangodb/system"
|
||||
}
|
||||
},
|
||||
"autoload-dev": {
|
||||
"psr-4": {
|
||||
"mirzaev\\arangodb\\tests\\": "mirzaev/arangodb/tests"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
2175
composer.lock
generated
2175
composer.lock
generated
File diff suppressed because it is too large
Load Diff
208
mirzaev/arangodb/system/collection.php
Normal file → Executable file
208
mirzaev/arangodb/system/collection.php
Normal file → Executable file
@@ -1,83 +1,125 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace mirzaev\arangodb;
|
||||
|
||||
use mirzaev\arangodb\terminal;
|
||||
|
||||
use ArangoDBClient\Connection as _connection;
|
||||
use ArangoDBClient\Collection as _collection;
|
||||
use ArangoDBClient\CollectionHandler as _collection_handler;
|
||||
|
||||
/**
|
||||
* Коллекция
|
||||
*
|
||||
* @package mirzaev\arangodb
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
*/
|
||||
class collection
|
||||
{
|
||||
/**
|
||||
* Инициализация
|
||||
*
|
||||
* @param _connection $connection Инстанция соединения
|
||||
* @param string $name Название
|
||||
* @param bool $edge Это ребро? (иначе: вершина)
|
||||
*
|
||||
* @return string|null Идентификатор
|
||||
*/
|
||||
public static function init(_connection $connection, string $name, bool $edge = false): ?string
|
||||
{
|
||||
// Инициализация
|
||||
$collections = new _collection_handler($connection);
|
||||
|
||||
if (!$collections->has($name)) {
|
||||
// Коллекция не найдена
|
||||
|
||||
// Запись в вывод
|
||||
terminal::write("Коллекция \"$name\" не найдена");
|
||||
|
||||
// Инициализация
|
||||
$collection = new _collection();
|
||||
|
||||
// Настройка
|
||||
$collection->setName($name);
|
||||
$collection->setType($edge ? 'edge' : 'document');
|
||||
|
||||
// Запись коллекции на сервер и его ответ в буфер возврата
|
||||
$id = $collections->create($name);
|
||||
|
||||
if ($collections->has($name)) {
|
||||
// Коллекция найдена (записана)
|
||||
|
||||
// Запись в вывод
|
||||
terminal::write("Создана коллекция \"$name\"");
|
||||
|
||||
// Возврат идентификатора коллекции
|
||||
return $id;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Поиск
|
||||
*
|
||||
* @param _connection $connection Соединение
|
||||
* @param string $collection Название
|
||||
* @param array $condition Условия
|
||||
*
|
||||
* @return array|null Коллекция, если найдена
|
||||
*/
|
||||
public static function search(_connection $connection, string $name, array $condition): ?array
|
||||
{
|
||||
// Инициализация
|
||||
$collections = new _collection_handler($connection);
|
||||
|
||||
if ($collections->has($name)) {
|
||||
// Коллекция найдена
|
||||
|
||||
return $collections->byExample($name, $condition)->getAll();
|
||||
}
|
||||
}
|
||||
}
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace mirzaev\arangodb;
|
||||
|
||||
use mirzaev\arangodb\terminal;
|
||||
|
||||
use ArangoDBClient\Connection as _connection;
|
||||
use ArangoDBClient\Collection as _collection;
|
||||
use ArangoDBClient\Statement as _statement;
|
||||
use ArangoDBClient\Document as _document;
|
||||
use ArangoDBClient\CollectionHandler as _collection_handler;
|
||||
|
||||
/**
|
||||
* Коллекция
|
||||
*
|
||||
* @package mirzaev\arangodb
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
*/
|
||||
class collection
|
||||
{
|
||||
/**
|
||||
* Инициализация
|
||||
*
|
||||
* @param _connection $session Сессия соединения с базой данных
|
||||
* @param string $name Название
|
||||
* @param bool $edge Обрабатывать как ребро? (иначе: вершина)
|
||||
* @param ?terminal $terminal Инстанция терминала
|
||||
*
|
||||
* @return string|null Идентификатор коллекции
|
||||
*/
|
||||
public static function init(_connection $session, string $name, bool $edge = false, ?terminal $terminal = null): ?string
|
||||
{
|
||||
// Инициализация
|
||||
$collections = new _collection_handler($session);
|
||||
|
||||
if (!$collections->has($name)) {
|
||||
// Не найдана коллекция
|
||||
|
||||
// Запись в вывод
|
||||
if ($terminal instanceof terminal) $terminal::write("Коллекция \"$name\" не найдена");
|
||||
|
||||
// Запись коллекции на сервер и его ответ в буфер возврата
|
||||
$id = $collections->create($name, ['type' => $edge ? _collection::TYPE_EDGE : _collection::TYPE_DOCUMENT]);
|
||||
|
||||
if ($collections->has($name)) {
|
||||
// Коллекция найдена (записана)
|
||||
|
||||
// Запись в вывод
|
||||
if ($terminal instanceof terminal) $terminal::write("Создана коллекция \"$name\" с типом " . ($edge ? 'ребро' : 'документ'));
|
||||
|
||||
// Возврат идентификатора коллекции
|
||||
return $id;
|
||||
}
|
||||
} else {
|
||||
// Найдена коллекция
|
||||
|
||||
// Возврат идентификатора коллекции
|
||||
return $name;
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Поиск
|
||||
*
|
||||
* @param _connection $session Сессия соединения с базой данных
|
||||
* @param string $query AQL-запрос
|
||||
* @param array $binds Binds for query [bind => value]
|
||||
*
|
||||
* @return _document|array|string|int|null Инстанция документа
|
||||
*/
|
||||
public static function search(_connection $session, string $query, array $binds = []): _document|string|array|int|null
|
||||
{
|
||||
// Statement instance initialization
|
||||
$instance = new _statement(
|
||||
$session,
|
||||
[
|
||||
'query' => $query,
|
||||
"batchSize" => 1000,
|
||||
"sanitize" => true
|
||||
]
|
||||
);
|
||||
|
||||
// Binds application
|
||||
$instance->bind($binds);
|
||||
|
||||
// Sending the request
|
||||
$response = $instance->execute();
|
||||
|
||||
// Инициализация буфера вывода
|
||||
$buffer = [];
|
||||
|
||||
foreach ($response->getAll() as $key => $value) {
|
||||
$buffer[$key] = $value;
|
||||
}
|
||||
|
||||
return is_array($buffer) && count($buffer) > 1 ? $buffer : $buffer[0] ?? null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Очистка
|
||||
*
|
||||
* @param _connection $session Сессия соединения с базой данных
|
||||
* @param string $name Название
|
||||
*
|
||||
* @return bool Статус выполнения
|
||||
*/
|
||||
public static function truncate(_connection $session, string $name): bool
|
||||
{
|
||||
// Инициализация
|
||||
$collections = new _collection_handler($session);
|
||||
|
||||
if ($collections->has($name)) {
|
||||
// Найдена коллекция
|
||||
|
||||
// Очистка
|
||||
return $collections->truncate($name);
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
21
mirzaev/arangodb/system/connection.php
Normal file → Executable file
21
mirzaev/arangodb/system/connection.php
Normal file → Executable file
@@ -138,15 +138,16 @@ final class connection
|
||||
match ($name) {
|
||||
'adress', 'endpoint' => $this->adress = $value ?? throw new exception("Свойство \"$name\" не может быть пустым", 500),
|
||||
'storage', 'database', 'db' => $this->storage = $value ?? throw new exception("Свойство \"$name\" не может быть пустым", 500),
|
||||
'auth' => $this->auth = $value,
|
||||
'name' => $this->name = $value,
|
||||
'password' => $this->password = $value,
|
||||
'connection' => $this->connection = $value,
|
||||
'timeout_connect' => $this->timeout_connect = $value,
|
||||
'timeout_request' => $this->timeout_request = $value,
|
||||
'reconnect' => $this->reconnect = $value,
|
||||
'create' => $this->create = $value,
|
||||
'update', 'policy' => $this->update = $value,
|
||||
'auth' => !$value ?: $this->auth = $value,
|
||||
'name' => !$value ?: $this->name = $value,
|
||||
'password' => !$value ?: $this->password = $value,
|
||||
'connection' => !$value ?: $this->connection = $value,
|
||||
'timeout_connect' => !$value ?: $this->timeout_connect = $value,
|
||||
'timeout_request' => !$value ?: $this->timeout_request = $value,
|
||||
'reconnect' => !$value ?: $this->reconnect = $value,
|
||||
'create' => !$value ?: $this->create = $value,
|
||||
'update', 'policy' => !$value ?: $this->update = $value,
|
||||
'journal' => !$value ?: $this->journal = $value,
|
||||
default => throw new exception("Свойство \"$name\" не найдено", 404)
|
||||
};
|
||||
}
|
||||
@@ -171,6 +172,7 @@ final class connection
|
||||
'create' => $this->create,
|
||||
'update', 'policy' => $this->update,
|
||||
'session' => $this->session,
|
||||
'journal' => $this->journal,
|
||||
default => throw new exception("Свойство \"$name\" не найдено", 404)
|
||||
};
|
||||
}
|
||||
@@ -195,6 +197,7 @@ final class connection
|
||||
'create' => isset($this->create),
|
||||
'update', 'policy' => isset($this->update),
|
||||
'session' => isset($this->session),
|
||||
'journal' => isset($this->journal),
|
||||
default => throw new exception("Свойство \"$name\" не найдено", 404)
|
||||
};
|
||||
}
|
||||
|
196
mirzaev/arangodb/system/document.php
Normal file → Executable file
196
mirzaev/arangodb/system/document.php
Normal file → Executable file
@@ -1,82 +1,114 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace mirzaev\arangodb;
|
||||
|
||||
use mirzaev\arangodb\terminal;
|
||||
|
||||
use ArangoDBClient\Connection as _connection;
|
||||
use ArangoDBClient\Document as _document;
|
||||
use ArangoDBClient\Edge as _edge;
|
||||
use ArangoDBClient\CollectionHandler as _collection_handler;
|
||||
use ArangoDBClient\EdgeHandler as _edge_handler;
|
||||
|
||||
/**
|
||||
* Документ
|
||||
*
|
||||
* @package mirzaev\arangodb
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
*/
|
||||
class document
|
||||
{
|
||||
/**
|
||||
* Записать
|
||||
*
|
||||
* @param _connection $connection Инстанция соединения
|
||||
* @param string $collection Коллекция
|
||||
* @param array $data Данные
|
||||
*
|
||||
* @return string|null Идентификатор
|
||||
*/
|
||||
public static function write(_connection $connection, string $collection, array $data): ?string
|
||||
{
|
||||
// Инициализация коллекции
|
||||
collection::init($connection, $collection, isset($data['_from'], $data['_to']));
|
||||
|
||||
if (isset($data['_from'], $data['_to'])) {
|
||||
// Ребро
|
||||
|
||||
// Инициализация обработчика рёбер
|
||||
$documents = new _edge_handler($connection);
|
||||
|
||||
// Инициализация ребра
|
||||
$document = new _edge();
|
||||
|
||||
// Инициализация вершин
|
||||
$_from = $data['_from'];
|
||||
$_to = $data['_to'];
|
||||
|
||||
// Деинициализация из входных данных
|
||||
unset($data['_from'], $data['_to']);
|
||||
} else {
|
||||
// Вершина
|
||||
|
||||
// Инициализация обработчика вершин
|
||||
$documents = new _collection_handler($connection);
|
||||
|
||||
// Инициализация вершины
|
||||
$document = new _document();
|
||||
}
|
||||
|
||||
// Настройка
|
||||
foreach ($data as $key => $value) {
|
||||
// Перебор параметров
|
||||
|
||||
$document->set($key, $value);
|
||||
}
|
||||
|
||||
// Запись на сервер и его ответ в буфер возврата
|
||||
$id = isset($_from, $_to) ? $documents->saveEdge($collection, $_from, $_to, $document) : $documents->save($collection, $document);
|
||||
|
||||
if ($documents->has($collection, $id)) {
|
||||
// Документ записан
|
||||
|
||||
// Запись в вывод
|
||||
terminal::write("В коллекции \"$collection\" создан документ \"$id\"");
|
||||
|
||||
// Возврат идентификатора коллекции
|
||||
return $id;
|
||||
}
|
||||
}
|
||||
}
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace mirzaev\arangodb;
|
||||
|
||||
use mirzaev\arangodb\terminal;
|
||||
|
||||
use ArangoDBClient\Connection as _connection;
|
||||
use ArangoDBClient\Document as _document;
|
||||
use ArangoDBClient\Edge as _edge;
|
||||
use ArangoDBClient\DocumentHandler as _document_handler;
|
||||
use ArangoDBClient\EdgeHandler as _edge_handler;
|
||||
|
||||
/**
|
||||
* Документ
|
||||
*
|
||||
* @package mirzaev\arangodb
|
||||
* @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
|
||||
*/
|
||||
class document
|
||||
{
|
||||
/**
|
||||
* Записать
|
||||
*
|
||||
* @param _connection $session Сессия соединения с базой данных
|
||||
* @param string $collection Коллекция
|
||||
* @param ?array $data Данные
|
||||
* @param bool $check Проверка на запись в базу данных
|
||||
* @param ?terminal $terminal Инстанция терминала
|
||||
*
|
||||
* @return string|null Идентификатор
|
||||
*/
|
||||
public static function write(_connection $session, string $collection, ?array $data = [], bool $check = false, ?terminal $terminal = null): ?string
|
||||
{
|
||||
// Инициализация коллекции
|
||||
collection::init($session, $collection, isset($data['_from'], $data['_to']));
|
||||
|
||||
if (isset($data['_from'], $data['_to'])) {
|
||||
// Ребро
|
||||
|
||||
// Инициализация обработчика рёбер
|
||||
$documents = new _edge_handler($session);
|
||||
|
||||
// Инициализация ребра
|
||||
$document = new _edge();
|
||||
|
||||
// Инициализация вершин
|
||||
$_from = $data['_from'];
|
||||
$_to = $data['_to'];
|
||||
|
||||
// Деинициализация из входных данных
|
||||
unset($data['_from'], $data['_to']);
|
||||
} else {
|
||||
// Вершина
|
||||
|
||||
// Инициализация обработчика вершин
|
||||
$documents = new _document_handler($session);
|
||||
|
||||
// Инициализация вершины
|
||||
$document = new _document();
|
||||
}
|
||||
|
||||
// Инициализация даты создания
|
||||
$created = time();
|
||||
|
||||
foreach (['created' => $created, 'updated' => $created] + $data as $key => $value) {
|
||||
// Перебор параметров
|
||||
|
||||
// Запись в инстанцию документа
|
||||
$document->set($key, $value);
|
||||
}
|
||||
|
||||
// Запись на сервер и его ответ в буфер возврата
|
||||
$id = isset($_from, $_to) ? $documents->saveEdge($collection, $_from, $_to, $document) : $documents->insert($collection, $document);
|
||||
|
||||
if ($check && $documents->has($collection, $id)) {
|
||||
// Найден записанный документ
|
||||
|
||||
// Запись в вывод
|
||||
if ($terminal instanceof terminal) $terminal::write("В коллекции \"$collection\" создан документ \"$id\"");
|
||||
} else if ($check) {
|
||||
// Не найден записанный документ
|
||||
|
||||
// Запись в вывод
|
||||
if ($terminal instanceof terminal) $terminal::write("В коллекции \"$collection\" не удалось найти созданный или создать документ");
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
// Возврат идентификатора коллекции
|
||||
return $id;
|
||||
}
|
||||
|
||||
/**
|
||||
* Обновить
|
||||
*
|
||||
* @param _connection $session Сессия соединения с базой данных
|
||||
* @param _document $document Инстанция документа вершины
|
||||
*
|
||||
* @return bool Статус обработки
|
||||
*/
|
||||
public static function update(_connection $session, _document $document): bool
|
||||
{
|
||||
// Инициализация обработчика вершин
|
||||
$documents = new _document_handler($session);
|
||||
|
||||
// Запись даты обновления в инстанцию документа
|
||||
$document->set('updated', time());
|
||||
|
||||
// Запись в базу данных
|
||||
return $documents->update($document);
|
||||
}
|
||||
}
|
||||
|
54
mirzaev/arangodb/system/terminal.php
Normal file → Executable file
54
mirzaev/arangodb/system/terminal.php
Normal file → Executable file
@@ -1,31 +1,23 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace mirzaev\arangodb;
|
||||
|
||||
class terminal
|
||||
{
|
||||
/**
|
||||
* Префикс
|
||||
*/
|
||||
protected const PREFIX = 'arangodb';
|
||||
|
||||
/**
|
||||
* Запись в вывод
|
||||
*
|
||||
* @param string $text Текст сообщения
|
||||
*/
|
||||
public static function write(string $text): void
|
||||
{
|
||||
echo self::generate_prefix() . ' ' . $text . PHP_EOL;
|
||||
}
|
||||
|
||||
/**
|
||||
* Генерация префикса
|
||||
*/
|
||||
public static function generate_prefix(): string
|
||||
{
|
||||
return '[' . self::PREFIX . ']';
|
||||
}
|
||||
}
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace mirzaev\arangodb;
|
||||
|
||||
class terminal
|
||||
{
|
||||
/**
|
||||
* Префикс
|
||||
*/
|
||||
protected const PREFIX = 'arangodb';
|
||||
|
||||
/**
|
||||
* Запись в вывод
|
||||
*
|
||||
* @param string $text Текст сообщения
|
||||
*/
|
||||
public static function write(string $text): void
|
||||
{
|
||||
echo sprintf("[%s] $text\n", self::PREFIX);
|
||||
}
|
||||
}
|
||||
|
Reference in New Issue
Block a user