13 Commits
4.1 ... 7.1

Author SHA1 Message Date
User
c516546b5d 20250326#1 2025-03-26 16:02:27 +03:00
User
945c95441f 20250321#1 2025-03-21 21:46:19 +03:00
User
d0e38875e6 20250224#3 2025-02-24 19:22:20 +03:00
User
73c9af71ab 20250224#2 2025-02-24 19:02:59 +03:00
User
5b0c0bc7b4 20250224#1 2025-02-24 18:33:53 +03:00
User
dfbcfdf321 20250222#1 2025-02-22 16:22:21 +03:00
User
a54b55cc4e 20250218#5 2025-02-18 02:34:04 +03:00
User
612132f938 20250218#4 2025-02-18 02:32:22 +03:00
User
73b7cb3a5f 20250218#3 2025-02-18 01:24:05 +03:00
User
4f7993750c 20250218#2 2025-02-18 01:08:03 +03:00
User
bdff890b41 20250218#1 2025-02-18 00:14:52 +03:00
User
e390bc262e 20250128#2 2025-01-28 03:32:28 +03:00
User
2afc439354 20250128#1 2025-01-28 03:31:47 +03:00
14 changed files with 448 additions and 190 deletions

View File

@@ -10,12 +10,12 @@ Stable version
composer require rmphp/storage
```
```bash
composer require rmphp/storage:"^4.0"
composer require rmphp/storage:"^6.0"
```
Dev version contains the latest changes
```bash
composer require rmphp/storage:"4.x-dev"
composer require rmphp/storage:"6.x-dev"
```

View File

@@ -3,16 +3,21 @@
namespace Rmphp\Storage;
use Rmphp\Storage\Entity\EntityInterface;
use Rmphp\Storage\Exception\RepositoryException;
use Rmphp\Storage\Mysql\MysqlRepositoryInterface;
use Rmphp\Storage\Mysql\MysqlResultData;
use Rmphp\Storage\Mysql\MysqlStorageInterface;
use Rmphp\Storage\Repository\AbstractRepository;
abstract class AbstractMysqlRepository extends AbstractRepository implements MysqlRepositoryInterface {
public const DEBUG = false;
public const TABLE = null;
public const ENTINY = null;
public const ENTITY = null;
private string $table;
private string $entity;
private bool $debug;
public function __construct(
public readonly MysqlStorageInterface $mysql
@@ -42,27 +47,26 @@ abstract class AbstractMysqlRepository extends AbstractRepository implements Mys
/** @inheritDoc */
public function getEntityById(int $id, $require = false) {
$this->checkConst();
if($result = $this->mysql->findById(static::TABLE, $id)) $out = $this->createFromData(static::ENTINY, $result);
if(empty($out) && $require) throw new RepositoryException("Запись не найдена");
public function getEntityById(int $id, string $table = null): mixed {
if(!isset($table)) $table = $this->getTable();
if($result = $this->mysql->findById($table, $id)) $out = $this->createFromData($this->getEntityClass(), $result);
return $out ?? null;
}
/** @inheritDoc */
public function saveEntity(EntityInterface $object) : mixed {
$this->checkConst();
public function saveEntity(EntityInterface $object, string $table = null) : mixed {
if(!isset($table)) $table = $this->getTable();
$in = $this->getProperties($object, function ($value){
return (is_string($value)) ? $this->mysql->escapeStr($value) : $value;
});
if(static::DEBUG) {$this->getSaveDebug($object, $in, static::TABLE); exit;}
if($this->getDebug()) {$this->debug($object, $in, $table, $this->getRepositoryStack()); exit;}
try {
if (!empty($object->getId()) && !empty($this->mysql->findById(static::TABLE, $object->getId()))) {
$this->mysql->updateById(static::TABLE, $in, $object->getId());
if (!empty($object->getId()) && !empty($this->mysql->findById($table, $object->getId()))) {
$this->mysql->updateById($table, $in, $object->getId());
return $object->getId();
} else {
$this->mysql->insert(static::TABLE, $in);
$this->mysql->insert($table, $in);
return (is_string($object->getId())) ? $object->getId() : $this->mysql->mysql()->insert_id;
}
} catch (\Throwable $throwable) {throw new RepositoryException($throwable->getMessage());}
@@ -70,10 +74,29 @@ abstract class AbstractMysqlRepository extends AbstractRepository implements Mys
/** @inheritDoc */
public function saveGroup(array $objects): array {
public function saveData(array $data, string $table = null, string $primaryKey = 'id') : mixed {
if(!isset($table)) $table = $this->getTable();
$in = array_map(function ($value){
return (is_string($value)) ? $this->mysql->escapeStr($value) : $value;
}, $data);
if($this->getDebug()) {$this->debug($data, $in, $table, $this->getRepositoryStack()); exit;}
try {
if (!empty($data[$primaryKey]) && !empty($this->mysql->findById($table, $data[$primaryKey], $primaryKey))) {
$this->mysql->updateById($table, $in, $data[$primaryKey]);
return $data[$primaryKey];
} else {
$this->mysql->insert($table, $in);
return (is_string($data[$primaryKey])) ? $data[$primaryKey] : $this->mysql->mysql()->insert_id;
}
} catch (\Throwable $throwable) {throw new RepositoryException($throwable->getMessage());}
}
/** @inheritDoc */
public function saveEntityGroup(array $objects, string $table = null): array {
try{
$this->mysql->mysql()->begin_transaction();
foreach($objects as $object) $id[] = $this->saveEntity($object);
foreach($objects as $object) $id[] = $this->saveEntity($object, $table);
$this->mysql->mysql()->commit();
return $id ?? [];
}
@@ -85,10 +108,25 @@ abstract class AbstractMysqlRepository extends AbstractRepository implements Mys
/** @inheritDoc */
public function deleteEntity(EntityInterface $object) : bool {
$this->checkConst();
public function saveDataGroup(array $objects, string $table = null, string $primaryKey = 'id'): array {
try{
$this->mysql->mysql()->begin_transaction();
foreach($objects as $object) $id[] = $this->saveData($object, $table, $primaryKey);
$this->mysql->mysql()->commit();
return $id ?? [];
}
catch (\Exception $exception){
$this->mysql->mysql()->rollback();
throw new RepositoryException($exception->getMessage());
}
}
/** @inheritDoc */
public function deleteEntity(EntityInterface $object, string $table = null) : bool {
if(!isset($table)) $table = $this->getTable();
if(!empty($object->getId())){
return $this->mysql->deleteById(static::TABLE, $object->getId());
return $this->mysql->deleteById($table, $object->getId());
}
return false;
}
@@ -100,23 +138,63 @@ abstract class AbstractMysqlRepository extends AbstractRepository implements Mys
}
/** @inheritDoc */
public function setTable(string $table) : void {
$this->table = $table;
}
/** @inheritDoc */
public function setEntity(string $entity) : void {
$this->entity = $entity;
}
/** @inheritDoc */
public function setDebug(bool $debug) : void {
$this->debug = $debug;
}
/**
* @return string
* @throws RepositoryException
*/
private function getTable() : string {
if(!empty($this->table)) return $this->table;
if(!empty(static::TABLE)) return static::TABLE;
throw new RepositoryException("Имя таблицы не задано");
}
/**
* @return string
* @throws RepositoryException
*/
private function getEntityClass() : string {
if(!empty($this->entity)) return $this->entity;
if(!empty(static::ENTITY)) return static::ENTITY;
throw new RepositoryException("Не указан объект");
}
/**
* @return bool
*/
private function getDebug(): bool {
if(!empty($this->debug)) return $this->debug;
if(!empty(static::DEBUG)) return static::DEBUG;
return false;
}
/**
* @param ...$arg
* @return void
*/
protected function getSaveDebug(...$arg) : void {
protected function debug(...$arg) : void {
if(function_exists('dd')) dd(...$arg);
if(function_exists('vdd')) vdd(...$arg);
var_dump(...$arg);
}
/**
* @throws RepositoryException
*/
protected function checkConst(): void {
if(empty(static::TABLE)) throw new RepositoryException("Имя таблицы не задано");
if(empty(static::ENTINY)) throw new RepositoryException("Не указан объект");
}
}

View File

@@ -1,96 +0,0 @@
<?php
namespace Rmphp\Storage;
use ReflectionClass;
use ReflectionException;
use ReflectionProperty;
use Rmphp\Storage\Entity\ValueObjectInterface;
abstract class AbstractRepository implements RepositoryInterface {
static array $classes = [];
/** @inheritDoc */
public function createFromData(string $class, $data) : mixed {
try {
if(!isset(static::$classes[$class])) static::$classes[$class] = new ReflectionClass($class);
$object = new $class;
/** @var ReflectionProperty $property */
foreach (static::$classes[$class]->getProperties() as $property) {
// data[propertyName] ?? data[property_name] ?? null
$value = $data[$property->getName()] ?? $data[strtolower(preg_replace("'([A-Z])'", "_$1", $property->getName()))] ?? null;
// если есть внутренний метод (приоритетная обработка)
if(static::$classes[$class]->hasMethod('set'.ucfirst($property->getName()))) $object->{'set'.ucfirst($property->getName())}($value);
// Если тип свойства класс (valueObject)
elseif($property->hasType() && class_exists($property->getType()->getName())) $object->{$property->getName()} = (is_object($value)) ? $value : new ($property->getType()->getName())($value);
// если значения не пустое
elseif(isset($value)) $object->{$property->getName()} = $value;
// если значения может быть пустое
elseif($property->getType()->allowsNull()) $object->{$property->getName()} = null;
}
return $object;
}
catch (ReflectionException $exception) {
throw new RepositoryException($exception->getMessage());
}
}
/** @inheritDoc */
public function getAllProperties(object $class, callable $method = null) : array {
$properties = $this->initProperties($class);
return (isset($method)) ? array_map($method, $properties) : $properties;
}
/** @inheritDoc */
public function getProperties(object $class, callable $method = null) : array {
$properties = $this->initProperties($class);
foreach ($properties as $fieldName => $value) {
if(isset($value)) $out[$fieldName] = $value;
}
return (isset($method)) ? array_map($method, $out ?? []) : $out ?? [];
}
/**
* @param object $class
* @return array
*/
private function initProperties(object $class): array {
$objectData = get_object_vars($class);
foreach ($objectData as $fieldName => $value)
{
// если есть внутренний метод (приоритетная обработка)
if(method_exists($class, 'get'.ucfirst($fieldName))) {
$fieldValue[$fieldName] = $class->{'get'.ucfirst($fieldName)}($value);
}
// если тип свойства класс (valueObject)
elseif($value instanceof ValueObjectInterface) {
$fieldValue[$fieldName] = $value->get();
}
// если это логическое значение
elseif(is_bool($value)){
$fieldValue[$fieldName] = (int) $value;
}
// если это дробное число
elseif(is_float($value)) {
$fieldValue[$fieldName] = $value;
}
// если это целое число
elseif(is_int($value)) {
$fieldValue[$fieldName] = $value;
}
// если это строка
elseif(is_string($value)) {
$fieldValue[$fieldName] = $value;
}
// to option_id
$fieldNameSnakeCase = strtolower(preg_replace("'([A-Z])'", "_$1", $fieldName));
$out[$fieldNameSnakeCase] = $fieldValue[$fieldName] ?? null;
}
return $out ?? [];
}
}

View File

@@ -0,0 +1,104 @@
<?php
namespace Rmphp\Storage\Component;
use Exception;
use ReflectionClass;
use ReflectionException;
class AbstractDataObject {
private static array $constructorEmptyAvailableClasses = [];
private static array $stack = [];
/**
* @param ReflectionClass $class
* @param object $object
* @param array $data
* @param bool $update
* @return mixed
* @throws Exception
*/
protected static function fillObject(ReflectionClass $class, object $object, array $data, bool $update = false) : mixed {
try {
$value = [];
foreach($class->getProperties() as $property){
$prop[$property->getName()] = ($property->hasType()) ? $property->getType()->getName() : "";
// значение в массиве по ключю с именем свойства
if(array_key_exists($property->getName(), $data)){
$value[$property->getName()] = $data[$property->getName()];
}
// значение в массиве по ключю с именем свойства в snake case
elseif(array_key_exists(strtolower(preg_replace("'([A-Z])'", "_$1", $property->getName())), $data)){
$value[$property->getName()] = $data[strtolower(preg_replace("'([A-Z])'", "_$1", $property->getName()))];
}
elseif($update) {
continue;
}
// если есть внутренний метод (приоритетная обработка)
if($class->hasMethod('set'.ucfirst($property->getName()))) {
$object->{'set'.ucfirst($property->getName())}($value[$property->getName()] ?? null);
}
// Если тип свойства класс (valueObject)
elseif($property->hasType() && class_exists($property->getType()->getName())) {
if(is_object($value[$property->getName()])){
$object->{$property->getName()} = $value[$property->getName()];
}
elseif(isset($value[$property->getName()])){
$object->{$property->getName()} = new ($property->getType()->getName())($value[$property->getName()]);
}
// Значения нет и VO может быть без параметров
elseif(self::isEmptyAvailable($property->getType()->getName())) {
$object->{$property->getName()} = new ($property->getType()->getName())();
}
}
// Базовые типы при наличии значения
elseif(array_key_exists($property->getName(), $value)){
if(!$property->hasType()){
$object->{$property->getName()} = $value[$property->getName()];
}
elseif(in_array($property->getType()->getName(), ['float', 'int'])){
if(is_numeric($value[$property->getName()])) $object->{$property->getName()} = $value[$property->getName()];
}
elseif($property->getType()->getName() == 'bool'){
$object->{$property->getName()} = (bool)$value[$property->getName()];
}
elseif(isset($value[$property->getName()])){
$object->{$property->getName()} = $value[$property->getName()];
}
}
}
self::$stack[$object::class." #".spl_object_id($object)]['properties'] = $prop ?? [];
self::$stack[$object::class." #".spl_object_id($object)]['values'] = $value;
self::$stack[$object::class." #".spl_object_id($object)]['object'] = $object;
return $object;
}
catch (ReflectionException $exception) {
throw new Exception($exception->getMessage());
}
}
/**
* @throws ReflectionException
*/
private static function isEmptyAvailable(string $class) : bool {
if(isset(self::$constructorEmptyAvailableClasses[$class])) return self::$constructorEmptyAvailableClasses[$class];
if(!$constructor = (new \ReflectionClass($class))->getConstructor()) return self::$constructorEmptyAvailableClasses[$class] = false;
foreach($constructor->getParameters() as $param){
if(!$param->isDefaultValueAvailable()){
return self::$constructorEmptyAvailableClasses[$class] = false;
}
}
return self::$constructorEmptyAvailableClasses[$class] = true;
}
/**
* @return array
*/
protected function getFillObjectStack() : array {
return self::$stack;
}
}

View File

@@ -5,10 +5,35 @@ namespace Rmphp\Storage\Entity;
abstract class AbstractEntity implements EntityInterface {
/**
* @return int|null
* @return mixed
*/
public function getId(): mixed {
return (isset($this->id)) ? (($this->id instanceof ValueObjectInterface) ? $this->id->get() : $this->id) : null;
return (isset($this->id)) ? (($this->id instanceof ValueObjectInterface) ? $this->id->getValue() : $this->id) : null;
}
/**
* @param string $name
* @param $value
* @return void
*/
public function __set(string $name, $value): void {
$this->$name = $value;
}
/**
* @param string $name
* @return string
*/
public function __get(string $name) {
return $this->$name ?? "";
}
/**
* @param string $name
* @return bool
*/
public function __isset(string $name): bool {
return isset($this->$name);
}
}

View File

@@ -11,7 +11,7 @@ namespace Rmphp\Storage\Entity;
interface EntityInterface {
/**
* @return int|null
* @return mixed
*/
public function getId(): mixed;

View File

@@ -4,7 +4,7 @@ namespace Rmphp\Storage\Entity;
interface ValueObjectInterface {
public function get();
public function getValue();
public function __toString(): string;
}

View File

@@ -1,6 +1,6 @@
<?php
namespace Rmphp\Storage;
namespace Rmphp\Storage\Exception;
use Throwable;

View File

@@ -9,8 +9,8 @@
namespace Rmphp\Storage\Mysql;
use Rmphp\Storage\Entity\EntityInterface;
use Rmphp\Storage\RepositoryException;
use Rmphp\Storage\RepositoryInterface;
use Rmphp\Storage\Exception\RepositoryException;
use Rmphp\Storage\Repository\RepositoryInterface;
interface MysqlRepositoryInterface extends RepositoryInterface {
@@ -33,35 +33,76 @@ interface MysqlRepositoryInterface extends RepositoryInterface {
public function createListFromResult(string $class, bool|MysqlResultData $result, callable $function = null): array;
/**
* @throws RepositoryException
*/
public function getEntityById(int $id, $require = false);
/**
* @param EntityInterface $object
* @param int $id
* @param string|null $table
* @return mixed
* @throws RepositoryException
*/
public function saveEntity(EntityInterface $object) : mixed;
/**
* @param array $objects
* @return array
* @throws RepositoryException
*/
public function saveGroup(array $objects): array;
public function getEntityById(int $id, string $table = null): mixed;
/**
* @param EntityInterface $object
* @param string|null $table
* @return mixed
* @throws RepositoryException
*/
public function saveEntity(EntityInterface $object, string $table = null) : mixed;
/**
* @param array $data
* @param string|null $table
* @param string $primaryKey
* @return mixed
* @throws RepositoryException
*/
public function saveData(array $data, string $table = null, string $primaryKey = 'id') : mixed;
/**
* @param array $objects
* @param string|null $table
* @return array
* @throws RepositoryException
*/
public function saveEntityGroup(array $objects, string $table = null): array;
/**
* @param array $objects
* @param string|null $table
* @param string $primaryKey
* @return array
* @throws RepositoryException
*/
public function saveDataGroup(array $objects, string $table = null, string $primaryKey = 'id'): array;
/**
* @param EntityInterface $object
* @param string|null $table
* @return bool
* @throws RepositoryException
*/
public function deleteEntity(EntityInterface $object) : bool;
public function deleteEntity(EntityInterface $object, string $table = null) : bool;
/**
* @return array
*/
public function getStorageLogs() : array;
/**
* @param string $table
* @return void
*/
public function setTable(string $table) : void;
/**
* @param string $entity
* @return void
*/
public function setEntity(string $entity) : void;
/**
* @param bool $debug
* @return void
*/
public function setDebug(bool $debug) : void;
}

View File

@@ -15,17 +15,24 @@ class MysqlStorage implements MysqlStorageInterface {
/**
* Внутренний конструктор подключения к БД
* Mysql constructor.
* @param array $params
* @param object $params
* @throws Exception
*/
public function __construct(array $params) {
$this->mysqli = new mysqli($params['host'], $params['user'], $params['pass'], $params['base']);
public function __construct(
private readonly object $params
) {
$this->mysqli = new mysqli(
$this->params->host,
$this->params->user,
$this->params->pass,
$this->params->base
);
// выводим ошибку при неудачном подключении
if ($this->mysqli->connect_errno) {
throw new Exception($this->mysqli->connect_errno);
}
$this->mysqli->set_charset("utf8");
if(!empty($params['logsEnable'])) $this->logsEnabled = true;
if(!empty($this->params->logsEnable)) $this->logsEnabled = true;
}
/** @inheritDoc */

View File

@@ -0,0 +1,90 @@
<?php
namespace Rmphp\Storage\Repository;
use Exception;
use ReflectionClass;
use ReflectionException;
use Rmphp\Storage\Component\AbstractDataObject;
use Rmphp\Storage\Entity\ValueObjectInterface;
use Rmphp\Storage\Exception\RepositoryException;
abstract class AbstractRepository extends AbstractDataObject implements RepositoryInterface {
private static array $classes = [];
/** @inheritDoc */
public function getProperties(object $object, callable $method = null) : array {
try{
$class = get_class($object);
if(!isset(self::$classes[$class])) self::$classes[$class] = new ReflectionClass($class);
$fieldValue = [];
foreach(self::$classes[$class]->getProperties() as $property){
if(!$property->isInitialized($object) || is_array($property->getValue($object))) continue;
if(self::$classes[$class]->hasMethod('get'.ucfirst($property->getName()))){
$fieldValue[$property->getName()] = $object->{'get'.ucfirst($property->getName())}($property->getValue($object));
}
elseif($property->hasType() && class_exists($property->getType()->getName()) && $property->getValue($object) instanceof ValueObjectInterface){
$value = $property->getValue($object)->getValue();
if(isset($value)) $fieldValue[$property->getName()] = $value;
}
elseif(is_bool($property->getValue($object))){
$fieldValue[$property->getName()] = (int) $property->getValue($object);
}
else {
$fieldValue[$property->getName()] = $property->getValue($object);
}
if(array_key_exists($property->getName(), $fieldValue) && false !== $fieldValue[$property->getName()]) {
$out[strtolower(preg_replace("'([A-Z])'", "_$1", $property->getName()))] = $fieldValue[$property->getName()];
}
}
return (isset($method)) ? array_map($method, $out ?? []) : $out ?? [];
}
catch (ReflectionException $exception) {
throw new RepositoryException($exception->getMessage());
}
}
/** @inheritDoc */
public function createFromData(string $class, array|object $data) : object {
try {
if(!isset(self::$classes[$class])) self::$classes[$class] = new ReflectionClass($class);
return self::fillObject(self::$classes[$class], new $class, (is_object($data)) ? get_object_vars($data) : $data);
}
catch (Exception $exception) {
throw new RepositoryException($exception->getMessage());
}
}
/** @inheritDoc */
public function updateFromData(object $object, array|object $data) : object {
try {
$class = get_class($object);
if(!isset(self::$classes[$class])) self::$classes[$class] = new ReflectionClass($class);
return self::fillObject(self::$classes[$class], clone $object, (is_object($data)) ? get_object_vars($data) : $data, true);
}
catch (Exception $exception) {
throw new RepositoryException($exception->getMessage());
}
}
/**
* @return array
*/
public function getRepositoryStack() : array {
return $this->getFillObjectStack();
}
/**
* @return array
*/
public function getClassesCash() : array {
return self::$classes;
}
}

View File

@@ -0,0 +1,48 @@
<?php
/**
* Created by PhpStorm.
* User: Zuev Yuri
* Date: 12.01.2025
* Time: 21:48
*/
namespace Rmphp\Storage\Repository;
use Rmphp\Storage\Exception\RepositoryException;
interface RepositoryInterface {
/**
* @param object $object
* @param callable|null $method
* @return array
* @throws RepositoryException
*/
public function getProperties(object $object, callable $method = null) : array;
/**
* @param string $class
* @param array|object $data
* @return mixed
* @throws RepositoryException
*/
public function createFromData(string $class, array|object $data) : mixed;
/**
* @param object $object
* @param array|object $data
* @return mixed
* @throws RepositoryException
*/
public function updateFromData(object $object, array|object $data) : mixed;
/**
* @return array
*/
public function getRepositoryStack() : array;
}

View File

@@ -1,39 +0,0 @@
<?php
/**
* Created by PhpStorm.
* User: Zuev Yuri
* Date: 12.01.2025
* Time: 21:48
*/
namespace Rmphp\Storage;
use Rmphp\Storage\Entity\EntityInterface;
interface RepositoryInterface {
/**
* @param string $class
* @param $data
* @return object
* @throws RepositoryException
*/
public function createFromData(string $class, $data) : mixed;
/**
* @param object $class
* @param callable|null $method
* @return array
*/
public function getAllProperties(object $class, callable $method = null) : array;
/**
* @param object $class
* @param callable|null $method
* @return array
*/
public function getProperties(object $class, callable $method = null) : array;
}