20250730

README.md

@@ -2,6 +2,4 @@
 
 [RU] Набор компонентов для сайта на PHP для работы с базами данных
 
-
-
 [EN] A set of components for PHP website for work with database

sources/attributes/ConvertToDB.php

@@ -0,0 +1,45 @@
+<?php
+    /**
+     * Отключаю несущественные инспекции (из-за Attribute)
+     *
+     * @noinspection PhpMultipleClassDeclarationsInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\attributes;
+    
+    use Attribute;
+    use Closure;
+    
+    /**
+     * Атрибут указания методов конвертации из/в тип для заполнения таблицы базы данных.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    #[Attribute(flags: Attribute::TARGET_PROPERTY)]
+    final readonly class ConvertToDB
+    {
+        /**
+         * @var Closure|null Метод конвертации из типа для заполнения таблицы базы данных.
+         */
+        public ?Closure $ConvertToDB;
+        
+        /**
+         * @var Closure|null Метод конвертации в тип для заполнения таблицы базы данных.
+         */
+        public ?Closure $ConvertFromDB;
+        
+        /**
+         * Конструктор.
+         *
+         * @param callable|null $fromType Метод конвертации из типа для заполнения таблицы базы данных.
+         * @param callable|null $toType Метод конвертации в тип для заполнения таблицы базы данных.
+         */
+        public function __construct (?callable $fromType = null, ?callable $toType = null)
+        {
+            $this->ConvertToDB = $fromType;
+            $this->ConvertFromDB = $toType;
+        }
+    }

sources/attributes/IgnoredInDB.php

@@ -0,0 +1,47 @@
+<?php
+    /**
+     * Отключаю несущественные инспекции (из-за Attribute)
+     *
+     * @noinspection PhpMultipleClassDeclarationsInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\attributes;
+    
+    use Attribute;
+    use goodboyalex\php_components_pack\classes\ObjectArray;
+    use goodboyalex\php_db_components_pack\enums\DBOperation;
+    
+    /**
+     * Атрибут указывающий, что свойство должно игнорироваться при операции с БД.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    #[Attribute(flags: Attribute::TARGET_PROPERTY)]
+    final readonly class IgnoredInDB
+    {
+        /**
+         * @var ObjectArray Игнорируемые операции.
+         */
+        public ObjectArray $IgnoredOperations;
+        
+        /**
+         * Конструктор.
+         *
+         * @param DBOperation ...$ignoredOperations Список операций, которые игнорируем.
+         */
+        public function __construct (DBOperation ...$ignoredOperations)
+        {
+            // Если не указаны операции
+            if (count($ignoredOperations) === 0)
+                // - то по умолчанию игнорируем все операции
+                $ignoredOperations = [
+                    DBOperation::Insert, DBOperation::Get, DBOperation::Update, DBOperation::Delete, DBOperation::Count
+                ];
+            
+            // Инициализируем массив
+            $this->IgnoredOperations = new ObjectArray($ignoredOperations);
+        }
+    }

sources/attributes/PrimaryKey.php

@@ -0,0 +1,29 @@
+<?php
+    /**
+     * Отключаю несущественные инспекции (из-за Attribute)
+     *
+     * @noinspection PhpMultipleClassDeclarationsInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\attributes;
+    
+    use Attribute;
+    
+    /**
+     * Атрибут указания, что параметр является первичным ключом таблицы.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    #[Attribute(flags: Attribute::TARGET_PROPERTY)]
+    final readonly class PrimaryKey
+    {
+        /**
+         * Конструктор
+         */
+        public function __construct ()
+        {
+        }
+    }

sources/enums/DBOperation.php

@@ -0,0 +1,45 @@
+<?php
+    
+    namespace goodboyalex\php_db_components_pack\enums;
+    
+    use goodboyalex\php_components_pack\traits\EnumExtensionsTrait;
+    
+    /**
+     *Перечисление операций в БД.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     * @see \PDO
+     */
+    enum DBOperation: int
+    {
+        // Подключаем trait для работы с перечислениями
+        use EnumExtensionsTrait;
+        
+        /**
+         * Операция вставки.
+         */
+        case Insert = 0;
+        
+        /**
+         * Операция получения.
+         */
+        case Get = 1;
+        
+        /**
+         * Операция обновления.
+         */
+        case Update = 2;
+        
+        /**
+         * Операция удаления.
+         */
+        case Delete = 3;
+        
+        /**
+         * Операция подсчета количества.
+         */
+        case Count = 4;
+    }