20250804

sources/attributes/AutoIncrement.php

@@ -0,0 +1,30 @@
+<?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 AutoIncrement
+    {
+        /**
+         * Конструктор
+         */
+        public function __construct ()
+        {
+        }
+    }

sources/attributes/Check.php

@@ -0,0 +1,38 @@
+<?php
+    /**
+     * Отключаю несущественные инспекции (из-за Attribute)
+     *
+     * @noinspection PhpMultipleClassDeclarationsInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\attributes;
+    
+    use Attribute;
+    use goodboyalex\php_db_components_pack\classes\ConditionBuilder;
+    
+    /**
+     * Атрибут указывающий условие, которое нужно проверять при добавлении строки в БД.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    #[Attribute(flags: Attribute::TARGET_PROPERTY)]
+    final readonly class Check
+    {
+        /**
+         * @var ConditionBuilder $Condition Условие, которое нужно проверять при добавлении строки в БД.
+         */
+        public ConditionBuilder $Condition;
+        
+        /**
+         * Конструктор.
+         *
+         * @param ConditionBuilder $condition Условие, которое нужно проверять при добавлении строки в БД.
+         */
+        public function __construct (ConditionBuilder $condition)
+        {
+            $this->Condition = $condition;
+        }
+    }

sources/attributes/DataType.php

@@ -0,0 +1,45 @@
+<?php
+    /**
+     * Отключаю несущественные инспекции (из-за Attribute)
+     *
+     * @noinspection PhpMultipleClassDeclarationsInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\attributes;
+    
+    use Attribute;
+    use goodboyalex\php_db_components_pack\enums\DBType;
+    
+    /**
+     * Атрибут указывающий тип данных поля в БД.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    #[Attribute(flags: Attribute::TARGET_PROPERTY)]
+    final readonly class DataType
+    {
+        /**
+         * @var DBType $Type Тип данных поля.
+         */
+        public DBType $Type;
+        
+        /**
+         * @var int $Size Размер поля (если это тип STRING)
+         */
+        public int $Size;
+        
+        /**
+         * Конструктор.
+         *
+         * @param DBType $type Тип данных поля.
+         * @param int $size Размер строкового значения (0 - MAX). Работает только для типа STRING. По умолчанию, 0.
+         */
+        public function __construct (DBType $type, int $size = 0)
+        {
+            $this->Type = $type;
+            $this->Size = $size;
+        }
+    }

sources/attributes/DefaultValue.php

@@ -0,0 +1,37 @@
+<?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 DefaultValue
+    {
+        /**
+         * @var mixed $Value Значение по умолчанию.
+         */
+        public mixed $Value;
+        
+        /**
+         * Конструктор.
+         *
+         * @param mixed $value Значение по умолчанию.
+         */
+        public function __construct (mixed $value)
+        {
+            $this->Value = $value;
+        }
+    }

sources/attributes/ForeignKey.php

@@ -0,0 +1,44 @@
+<?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 ForeignKey
+    {
+        /**
+         * @var string $TableName Имя таблицы.
+         */
+        public string $TableName;
+        
+        /**
+         * @var string $FieldName Имя связываемого поля.
+         */
+        public string $FieldName;
+        
+        /**
+         * Конструктор.
+         *
+         * @param string $table Имя таблицы.
+         * @param string $fieldName Имя связываемого поля.
+         */
+        public function __construct (string $table, string $fieldName)
+        {
+            $this->TableName = $table;
+            $this->FieldName = $fieldName;
+        }
+    }

sources/attributes/NotNull.php

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

sources/attributes/Unique.php

@@ -0,0 +1,30 @@
+<?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 Unique
+    {
+        /**
+         * Конструктор
+         */
+        public function __construct ()
+        {
+        }
+    }

sources/classes/DBItemProperty.php

@@ -31,9 +31,9 @@
         public string $FieldName;
         
         /**
-         * @var bool $IsPrimaryKey Признак того, что свойство является первичным ключом.
+         * @var DataBaseHeadItem $Column Информация об ячейке.
          */
-        public bool $IsPrimaryKey;
+        public DataBaseHeadItem $Column;
         
         /**
          * @var bool $IsIgnored Признак того, что свойство игнорируется при сохранении в / загрузке из БД.
@@ -61,14 +61,14 @@
          * @param string $name Имя свойства.
          * @param mixed|null $value Значение свойства (ещё не конвертированное!).
          * @param string $fieldName Имя поля в таблице БД.
-         * @param bool $isPrimaryKey Признак того, что свойство является первичным ключом.
+         * @param DataBaseHeadItem $column Информация об ячейке.
          * @param bool $isIgnored Признак того, что свойство игнорируется при сохранении в / загрузке из БД.
          * @param callable|null $ConvertToDB Конвертер значения свойства в значение поля БД.
          * @param Closure|null $ConvertFromDB Конвертер значения поля БД в значение свойства.
          * @param Closure|null $Compare Функция сравнения значений свойства.
          */
         public function __construct (string $name = '', mixed $value = null, string $fieldName = '',
-            bool $isPrimaryKey = false, bool $isIgnored = false, ?callable $ConvertToDB = null,
+            DataBaseHeadItem $column = new DataBaseHeadItem(), bool $isIgnored = false, ?callable $ConvertToDB = null,
             ?Closure $ConvertFromDB = null, ?Closure $Compare = null)
         {
             // Установка значений
@@ -78,8 +78,8 @@
             $this->Value = $value;
             // - установка имени поля в таблице БД
             $this->FieldName = StringExtension::IsNullOrWhitespace($fieldName) ? $name : $fieldName;
-            // - установка признака того, что свойство является первичным ключом
+            // - установка свойств столбца
-            $this->IsPrimaryKey = $isPrimaryKey;
+            $this->Column = $column;
             // - установка признака того, что свойство игнорируется при сохранении в / загрузке из БД
             $this->IsIgnored = $isIgnored;
             // - установка конвертеров значения свойства в значение поля БД

sources/classes/DataBaseHeadItem.php

@@ -0,0 +1,94 @@
+<?php
+    
+    namespace goodboyalex\php_db_components_pack\classes;
+    
+    use goodboyalex\php_components_pack\classes\Tuple;
+    use goodboyalex\php_db_components_pack\enums\DBType;
+    
+    /**
+     * Класс, описывающий структуру колонки.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    final class DataBaseHeadItem
+    {
+        /**
+         * @var string $Name Имя колонки.
+         */
+        public string $Name;
+        
+        /**
+         * @var Tuple $Type Тип данных (DBType тип, int максимальная длина).
+         */
+        public Tuple $Type;
+        
+        /**
+         * @var bool $IsNotNull Запрещено ли вставлять пустые (NULL) значения в указанное поле.
+         */
+        public bool $IsNotNull;
+        
+        /**
+         * @var bool $IsUnique Обеспечивает уникальность каждого значения в данном поле.
+         */
+        public bool $IsUnique;
+        
+        /**
+         * @var bool $IsPrimaryKey Устанавливается на одно или несколько полей, гарантирующих уникальную идентификацию
+         *     каждой записи в таблице.
+         */
+        public bool $IsPrimaryKey;
+        
+        /**
+         * @var Tuple $ForeignWith Связь с другой таблицей (string имя_таблицы, string имя_поля).
+         */
+        public Tuple $ForeignWith;
+        
+        /**
+         * @var ConditionBuilder $Check Параметры проверки введённого значения на соблюдение некоторого условия.
+         */
+        public ConditionBuilder $Check;
+        
+        /**
+         * @var mixed $Default Задаёт значение по умолчанию.
+         */
+        public mixed $Default;
+        
+        /**
+         * @var bool $IsAutoIncrement Автоматически генерирует уникальное значение каждый раз при создании новой записи.
+         */
+        public bool $IsAutoIncrement;
+        
+        /**
+         * Конструктор.
+         *
+         * @param string $name Имя колонки.
+         * @param Tuple $type Тип данных (DBType тип, int максимальная длина).
+         * @param bool $isNotNull Запрещено ли вставлять пустые (NULL) значения в указанное поле.
+         * @param bool $isUnique Обеспечивает уникальность каждого значения в данном поле.
+         * @param bool $isPrimaryKey Устанавливается на одно или несколько полей, гарантирующих уникальную
+         *     идентификацию каждой записи в таблице.
+         * @param Tuple $foreignWith Связь с другой таблицей (string имя_таблицы, string имя_поля).
+         * @param ConditionBuilder $check Параметры проверки введённого значения на соблюдение некоторого условия.
+         * @param mixed|null $default Задаёт значение по умолчанию.
+         * @param bool $isAutoIncrement Автоматически генерирует уникальное значение каждый раз при создании новой
+         *     записи.
+         */
+        public function __construct (string $name = "", Tuple $type = new Tuple(DBType::STRING, 255),
+            bool $isNotNull = false, bool $isUnique = false, bool $isPrimaryKey = false,
+            Tuple $foreignWith = new Tuple(null, null), ConditionBuilder $check = new ConditionBuilder(),
+            mixed $default = null, bool $isAutoIncrement = false)
+        {
+            $this->Name = $name;
+            $this->Type = $type;
+            $this->IsNotNull = $isNotNull;
+            $this->IsUnique = $isUnique;
+            $this->IsPrimaryKey = $isPrimaryKey;
+            $this->ForeignWith = $foreignWith;
+            $this->Check = $check;
+            $this->Default = $default;
+            $this->IsAutoIncrement = $isAutoIncrement;
+        }
+    }

sources/classes/DataBaseHeader.php

@@ -0,0 +1,29 @@
+<?php
+    
+    namespace goodboyalex\php_db_components_pack\classes;
+    
+    use goodboyalex\php_components_pack\classes\ObjectArray;
+    
+    /**
+     * Класс, описывающий структуру столбцов базы данных.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    final class DataBaseHeader
+    {
+        /**
+         * @var ObjectArray $Container Столбцы таблицы.
+         */
+        private ObjectArray $Container;
+        
+        /**
+         * Конструктор.
+         */
+        public function __construct ()
+        {
+            $this->Container = new ObjectArray();
+        }
+    }

sources/classes/Database.php

@@ -1,9 +1,5 @@
 <?php
     
-    /**
-     * @noinspection SqlNoDataSourceInspection
-     */
-    
     namespace goodboyalex\php_db_components_pack\classes;
     
     use Closure;
@@ -15,6 +11,7 @@
     use goodboyalex\php_db_components_pack\traits\Database\DatabaseInsert;
     use goodboyalex\php_db_components_pack\traits\Database\DatabaseQueryExecute;
     use goodboyalex\php_db_components_pack\traits\Database\DatabaseSpecial;
+    use goodboyalex\php_db_components_pack\traits\Database\DatabaseTableManagement;
     use goodboyalex\php_db_components_pack\traits\Database\DatabaseTransactions;
     use goodboyalex\php_db_components_pack\traits\Database\DatabaseUpdate;
     use PDO;
@@ -154,6 +151,9 @@
         // Удаление записей
         use DatabaseDelete;
         
+        // Управление таблицами баз данных
+        use DatabaseTableManagement;
+        
         // Приватные методы
         use DatabaseSpecial;
     }

sources/classes/tm_drivers/MSSQLTableManager.php

@@ -0,0 +1,52 @@
+<?php
+    /**
+     * @noinspection SqlNoDataSourceInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\classes\tm_drivers;
+    
+    use goodboyalex\php_db_components_pack\classes\DataBaseHeader;
+    use goodboyalex\php_db_components_pack\interfaces\ITableManager;
+    use PDO;
+    
+    /**
+     * Система менеджмента таблицами базы данных MS SQL.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    final class MSSQLTableManager implements ITableManager
+    {
+        /**
+         * @inheritDoc
+         */
+        public function IsTableExist (PDO $handle, string $tableName): bool
+        {
+            // Создаю SQL-запрос
+            $sql = "SELECT CASE WHEN OBJECT_ID(:tableName, 'U') IS NOT NULL THEN 1 ELSE 0 END";
+            
+            // Подготавливаю данные
+            $stmt = $handle->prepare($sql);
+            
+            // Выполняю запрос
+            $stmt->execute(['tableName' => $tableName]);
+            
+            // Получаю количество таблиц и вывожу true или false
+            return $stmt->fetchColumn() === '1';
+        }
+        
+        public function CreateTable (PDO $handle, string $tableName, DataBaseHeader $columns): bool
+        {
+            // TODO: Implement CreateTable() method.
+            
+            return false;
+        }
+        
+        public function DropTable (PDO $handle, string $tableName): bool
+        {
+            // TODO: Implement DropTable() method.
+            return false;
+        }
+    }

sources/classes/tm_drivers/MySQLTableManager.php

@@ -0,0 +1,53 @@
+<?php
+    /**
+     * @noinspection SqlNoDataSourceInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\classes\tm_drivers;
+    
+    use goodboyalex\php_db_components_pack\classes\DataBaseHeader;
+    use goodboyalex\php_db_components_pack\interfaces\ITableManager;
+    use PDO;
+    
+    /**
+     * Система менеджмента таблицами базы данных MySQL.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    final class MySQLTableManager implements ITableManager
+    {
+        /**
+         * @inheritDoc
+         */
+        public function IsTableExist (PDO $handle, string $tableName): bool
+        {
+            // Создаю SQL-запрос
+            $sql = "SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES 
+                WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = :tableName";
+            
+            // Подготавливаю данные
+            $stmt = $handle->prepare($sql);
+            
+            // Выполняю запрос
+            $stmt->execute(['tableName' => $tableName]);
+            
+            // Получаю количество таблиц, если > 0, то вывожу true, иначе - false
+            return $stmt->fetchColumn() > 0;
+        }
+        
+        public function CreateTable (PDO $handle, string $tableName, DataBaseHeader $columns): bool
+        {
+            // TODO: Implement CreateTable() method.
+            
+            return false;
+        }
+        
+        public function DropTable (PDO $handle, string $tableName): bool
+        {
+            // TODO: Implement DropTable() method.
+            return false;
+        }
+    }

sources/classes/tm_drivers/OracleDBTableManager.php

@@ -0,0 +1,52 @@
+<?php
+    /**
+     * @noinspection SqlNoDataSourceInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\classes\tm_drivers;
+    
+    use goodboyalex\php_db_components_pack\classes\DataBaseHeader;
+    use goodboyalex\php_db_components_pack\interfaces\ITableManager;
+    use PDO;
+    
+    /**
+     * Система менеджмента таблицами базы данных Oracle DB.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    final class OracleDBTableManager implements ITableManager
+    {
+        /**
+         * @inheritDoc
+         */
+        public function IsTableExist (PDO $handle, string $tableName): bool
+        {
+            // Создаю SQL-запрос
+            $sql = "SELECT COUNT(*) FROM USER_TABLES WHERE TABLE_NAME = UPPER(:tableName)";
+            
+            // Подготавливаю данные
+            $stmt = $handle->prepare($sql);
+            
+            // Выполняю запрос
+            $stmt->execute(['tableName' => $tableName]);
+            
+            // Получаю количество таблиц, если >0, то вывожу true, иначе - false
+            return $stmt->fetchColumn() > 0;
+        }
+        
+        public function CreateTable (PDO $handle, string $tableName, DataBaseHeader $columns): bool
+        {
+            // TODO: Implement CreateTable() method.
+            
+            return false;
+        }
+        
+        public function DropTable (PDO $handle, string $tableName): bool
+        {
+            // TODO: Implement DropTable() method.
+            return false;
+        }
+    }

sources/classes/tm_drivers/PostgreSQLTableManager.php

@@ -0,0 +1,56 @@
+<?php
+    /**
+     * @noinspection SqlNoDataSourceInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\classes\tm_drivers;
+    
+    use goodboyalex\php_db_components_pack\classes\DataBaseHeader;
+    use goodboyalex\php_db_components_pack\interfaces\ITableManager;
+    use PDO;
+    
+    /**
+     * Система менеджмента таблицами базы данных PostgreSQL.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    final class PostgreSQLTableManager implements ITableManager
+    {
+        /**
+         * @inheritDoc
+         */
+        public function IsTableExist (PDO $handle, string $tableName): bool
+        {
+            // Создаю SQL-запрос
+            $sql = "SELECT EXISTS(
+                  SELECT 1 
+                  FROM   pg_tables 
+                  WHERE  schemaname = current_schema() 
+                     AND tablename = :tableName)";
+            
+            // Подготавливаю данные
+            $stmt = $handle->prepare($sql);
+            
+            // Выполняю запрос
+            $stmt->execute(['tableName' => $tableName]);
+            
+            // Получаю количество таблиц, если = "true", то вывожу true, иначе - false
+            return $stmt->fetchColumn() === 'true';
+        }
+        
+        public function CreateTable (PDO $handle, string $tableName, DataBaseHeader $columns): bool
+        {
+            // TODO: Implement CreateTable() method.
+            
+            return false;
+        }
+        
+        public function DropTable (PDO $handle, string $tableName): bool
+        {
+            // TODO: Implement DropTable() method.
+            return false;
+        }
+    }

sources/classes/tm_drivers/SQLiteTableManager.php

@@ -0,0 +1,52 @@
+<?php
+    /**
+     * @noinspection SqlNoDataSourceInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\classes\tm_drivers;
+    
+    use goodboyalex\php_db_components_pack\classes\DataBaseHeader;
+    use goodboyalex\php_db_components_pack\interfaces\ITableManager;
+    use PDO;
+    
+    /**
+     * Система менеджмента таблицами базы данных SQLite.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0
+     * @since 1.0
+     */
+    final class SQLiteTableManager implements ITableManager
+    {
+        /**
+         * @inheritDoc
+         */
+        public function IsTableExist (PDO $handle, string $tableName): bool
+        {
+            // Создаю SQL-запрос
+            $sql = "SELECT COUNT(*) FROM sqlite_master WHERE type='table' AND name=:tableName";
+            
+            // Подготавливаю данные
+            $stmt = $handle->prepare($sql);
+            
+            // Выполняю запрос
+            $stmt->execute(['tableName' => $tableName]);
+            
+            // Получаю количество таблиц, если >0, то вывожу true, иначе - false
+            return $stmt->fetchColumn() > 0;
+        }
+        
+        public function CreateTable (PDO $handle, string $tableName, DataBaseHeader $columns): bool
+        {
+            // TODO: Implement CreateTable() method.
+            
+            return false;
+        }
+        
+        public function DropTable (PDO $handle, string $tableName): bool
+        {
+            // TODO: Implement DropTable() method.
+            return false;
+        }
+    }

sources/enums/DBType.php

@@ -0,0 +1,49 @@
+<?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
+     */
+    enum DBType: int
+    {
+        // Подключаем trait для работы с перечислениями
+        use EnumExtensionsTrait;
+        
+        /**
+         * Тип целых чисел.
+         */
+        case INT = 0;
+        
+        /**
+         * Тип чисел с плавающей точкой.
+         */
+        case FLOAT = 1;
+        
+        /**
+         * Тип строк.
+         */
+        case STRING = 2;
+        
+        /**
+         * Тип булевых значений.
+         */
+        case BOOL = 3;
+        
+        /**
+         * Тип даты.
+         */
+        case DATE = 4;
+        
+        /**
+         * Массив/объект.
+         */
+        case ARRAY = 5;
+    }

sources/interfaces/IDBItem.php

@@ -10,23 +10,4 @@
      * @version 1.0.0
      * @since 1.0
      */
-    interface IDBItem
+    interface IDBItem {}
-    {
-        /**
-         * Вывод параметров добавления/обновления данных в базу данных.
-         *
-         * @param bool $withId Нужно ли добавлять Id в массив
-         *
-         * @return array Массив параметров
-         */
-        public function ToSQL (bool $withId = true): array;
-        
-        /**
-         * Преобразование данных из базы данных в модель, класс.
-         *
-         * @param array $sqlData Данные из базы данных
-         *
-         * @return self Класс модели с заполненными данными из базы данных
-         */
-        public function FromSQL (array $sqlData): self;
-    }

sources/interfaces/ITableManager.php

@@ -0,0 +1,48 @@
+<?php
+    
+    namespace goodboyalex\php_db_components_pack\interfaces;
+    
+    use goodboyalex\php_db_components_pack\classes\DataBaseHeader;
+    use PDO;
+    
+    /**
+     * Интерфейс классов драйверов баз данных для управления таблицами данных.
+     *
+     * @author Александр Бабаев
+     * @package php_db_components_pack
+     * @version 1.0.0
+     * @since 1.0
+     */
+    interface ITableManager
+    {
+        /**
+         * Проверяет существование таблицы в базе данных.
+         *
+         * @param PDO $handle Представляет соединение между PHP и сервером базы данных.
+         * @param string $tableName Имя таблицы.
+         *
+         * @return bool Возвращает <code>true</code>, если таблица существует, иначе возвращает <code>false</code>.
+         */
+        public function IsTableExist (PDO $handle, string $tableName): bool;
+        
+        /**
+         * Создает таблицу в базе данных.
+         *
+         * @param PDO $handle Представляет соединение между PHP и сервером базы данных.
+         * @param string $tableName Имя таблицы.
+         * @param DataBaseHeader $columns Колонки таблицы.
+         *
+         * @return bool Возвращает <code>true</code>, если таблица успешно создана, иначе возвращает <code>false</code>.
+         */
+        public function CreateTable (PDO $handle, string $tableName, DataBaseHeader $columns): bool;
+        
+        /**
+         * Удаляет таблицу из базы данных.
+         *
+         * @param PDO $handle Представляет соединение между PHP и сервером базы данных.
+         * @param string $tableName Имя таблицы.
+         *
+         * @return bool Возвращает <code>true</code>, если таблица успешно удалена, иначе возвращает <code>false</code>.
+         */
+        public function DropTable (PDO $handle, string $tableName): bool;
+    }

sources/traits/Database/DatabaseSpecial.php

@@ -8,13 +8,23 @@
     
     use Exception;
     use goodboyalex\php_components_pack\classes\ObjectArray;
+    use goodboyalex\php_components_pack\classes\Tuple;
+    use goodboyalex\php_db_components_pack\attributes\AutoIncrement;
+    use goodboyalex\php_db_components_pack\attributes\Check;
     use goodboyalex\php_db_components_pack\attributes\ConvertToDB;
+    use goodboyalex\php_db_components_pack\attributes\DataType;
+    use goodboyalex\php_db_components_pack\attributes\DefaultValue;
     use goodboyalex\php_db_components_pack\attributes\FieldName;
+    use goodboyalex\php_db_components_pack\attributes\ForeignKey;
     use goodboyalex\php_db_components_pack\attributes\IgnoredInDB;
+    use goodboyalex\php_db_components_pack\attributes\NotNull;
     use goodboyalex\php_db_components_pack\attributes\PrimaryKey;
+    use goodboyalex\php_db_components_pack\attributes\Unique;
     use goodboyalex\php_db_components_pack\classes\ConditionBuilder;
+    use goodboyalex\php_db_components_pack\classes\DataBaseHeadItem;
     use goodboyalex\php_db_components_pack\classes\DBItemProperty;
     use goodboyalex\php_db_components_pack\enums\DBOperation;
+    use goodboyalex\php_db_components_pack\enums\DBType;
     use goodboyalex\php_db_components_pack\interfaces\IDBItem;
     use PDO;
     use ReflectionClass;
@@ -68,11 +78,11 @@
                     continue;
                 
                 // - получаю рефлексию класса
-                $reflectedClass = new ReflectionClass(get_class($source));
+                $class = new ReflectionClass(get_class($source));
                 
                 try {
                     // - получаю рефлексию свойства
-                    $reflectionProperty = $reflectedClass->getProperty($key);
+                    $property = $class->getProperty($key);
                 }
                 catch (ReflectionException) {
                     // - если ошибка, то вывожу пустой массив
@@ -80,22 +90,12 @@
                 }
                 
                 // - пропускаю не публичные свойства
-                if (!$reflectionProperty->isPublic())
+                if (!$property->isPublic())
                     // -- пропускаю
                     continue;
                 
                 // - получаю атрибуты
-                $attributes = $reflectionProperty->getAttributes();
+                $attributes = $property->getAttributes();
-                
-                /**
-                 * Фильтруем поля, игнорируемые для данной операции
-                 *
-                 * @var PrimaryKey|null $pkAttr Атрибут первичного ключа.
-                 */
-                $pkAttr = self::FindAttribute($attributes, PrimaryKey::class);
-                
-                // - это первичный ключ?
-                $isPrimary = $pkAttr !== null;
                 
                 /**
                  * Фильтруем поля, игнорируемые для данной операции
@@ -131,8 +131,100 @@
                 $converterFromDB = $convertAttr?->ConvertFromDB;
                 $compareFunc = $convertAttr?->Compare;
                 
+                // - получаем свойства столбца
+                /**
+                 * Атрибут первичного ключа.
+                 *
+                 * @var PrimaryKey|null $pkAttr Атрибут первичного ключа.
+                 */
+                $pkAttr = self::FindAttribute($attributes, PrimaryKey::class);
+                
+                // -- это первичный ключ?
+                $isPrimary = $pkAttr !== null;
+                
+                /**
+                 * Тип данных поля.
+                 *
+                 * @var DataType|null $dtAttr Атрибут типа данных
+                 */
+                $dtAttr = self::FindAttribute($attributes, DataType::class);
+                
+                // - тип данных
+                $dataType = $dtAttr !== null
+                    ? new Tuple($dtAttr->Type, $dtAttr->Size)
+                    : new Tuple(self::GetDBTypeForType($property->getType()->getName()), 0);
+                
+                /**
+                 * Атрибут "не пустое значение".
+                 *
+                 * @var NotNull|null $nnAttr Атрибут нет пустому значению.
+                 */
+                $nnAttr = self::FindAttribute($attributes, NotNull::class);
+                
+                // -- это первичный ключ?
+                $isNotNull = $nnAttr !== null;
+                
+                /**
+                 * Атрибут "уникальное значение".
+                 *
+                 * @var Unique|null $unqAttr Атрибут уникального значения.
+                 */
+                $unqAttr = self::FindAttribute($attributes, Unique::class);
+                
+                // -- это уникальный ключ?
+                $isUnique = $unqAttr !== null;
+                
+                /**
+                 * Ключ для связывания поля.
+                 *
+                 * @var ForeignKey|null $chkAttr Атрибут связывания.
+                 */
+                $chkAttr = self::FindAttribute($attributes, ForeignKey::class);
+                
+                // - связывание с другой таблицей
+                $foreignWith = $chkAttr !== null
+                    ? new Tuple($chkAttr->TableName, $chkAttr->FieldName)
+                    : new Tuple(null, null);
+                
+                /**
+                 * Атрибут проверки поля.
+                 *
+                 * @var Check|null $chkAttr Атрибут проверки поля.
+                 */
+                $chkAttr = self::FindAttribute($attributes, Check::class);
+                
+                // - проверка данных поля
+                $checkFunc = $chkAttr !== null
+                    ? $chkAttr->Condition
+                    : new ConditionBuilder();
+                
+                /**
+                 * Атрибут значения по умолчанию поля.
+                 *
+                 * @var DefaultValue|null $dvAttr Атрибут значения по умолчанию поля.
+                 */
+                $dvAttr = self::FindAttribute($attributes, DefaultValue::class);
+                
+                // - значение по умолчанию
+                $default = $dvAttr?->Value;
+                
+                /**
+                 * Атрибут "автоматической генерации".
+                 *
+                 * @var AutoIncrement|null $aiAttr Атрибут "автоматической генерации".
+                 */
+                $aiAttr = self::FindAttribute($attributes, AutoIncrement::class);
+                
+                // -- это атрибут "автоматической генерации"?
+                $isAutoIncrement = $aiAttr !== null;
+                
+                // - создаю заголовок
+                $columnHeader = new DataBaseHeadItem($fieldName, $dataType, $isNotNull, $isUnique, $isPrimary,
+                    $foreignWith, $checkFunc, $default, $isAutoIncrement);
+                
+                
                 // - создаю объект свойства
-                $item = new DBItemProperty($key, $value, $fieldName, $isPrimary, $isIgnore, $converterToDB,
+                $item = new DBItemProperty($key, $value, $fieldName, $columnHeader, $isIgnore, $converterToDB,
                     $converterFromDB, $compareFunc);
                 
                 // - добавляю в массив
@@ -143,6 +235,28 @@
             return $result;
         }
         
+        /**
+         * Получает тип из базы данных по типу переменной.
+         *
+         * @param string $type Тип.
+         *
+         * @return DBType Тип из базы данных.
+         */
+        private static function GetDBTypeForType (string $type): DBType
+        {
+            /**
+             * @noinspection SpellCheckingInspection Отключаю проверку из-за того, что многие типы будут в lower case
+             */
+            return match (strtolower($type)) {
+                "int", "integer" => DBType::INT,
+                "float", "double" => DBType::FLOAT,
+                "bool", "boolean" => DBType::BOOL,
+                "dateonly", "timeonly", "datetime", "datetimeimmutable" => DBType::DATE,
+                "array" => DBType::ARRAY,
+                default => DBType::STRING
+            };
+        }
+        
         /**
          * Подготавливает массив параметров
          *

sources/traits/Database/DatabaseTableManagement.php

@@ -0,0 +1,49 @@
+<?php
+    
+    /**
+     * @noinspection SqlNoDataSourceInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\traits\Database;
+    
+    use goodboyalex\php_db_components_pack\classes\tm_drivers\MSSQLTableManager;
+    use goodboyalex\php_db_components_pack\classes\tm_drivers\MySQLTableManager;
+    use goodboyalex\php_db_components_pack\classes\tm_drivers\OracleDBTableManager;
+    use goodboyalex\php_db_components_pack\classes\tm_drivers\PostgreSQLTableManager;
+    use goodboyalex\php_db_components_pack\classes\tm_drivers\SQLiteTableManager;
+    use goodboyalex\php_db_components_pack\enums\DBDriver;
+    use PDO;
+    
+    /**
+     * Трейт для управления таблицами базы данных.
+     *
+     * @author Александр Бабаев
+     * @package php_components_pack
+     * @version 1.0
+     * @since 1.0
+     * @see PDO
+     */
+    trait DatabaseTableManagement
+    {
+        /**
+         * Проверяет, существует ли таблица.
+         *
+         * @param string $tableName Имя таблицы.
+         *
+         * @return bool Результат проверки: <code>true</code> - таблица существует, <code>false</code> - не существует.
+         */
+        public function IsTableExist (string $tableName): bool
+        {
+            // Получаю систему управления таблицами БД
+            $dbDrv = match ($this->Config->Driver) {
+                DBDriver::MySQL => new MySQLTableManager(),
+                DBDriver::MSSQL => new MSSQLTableManager(),
+                DBDriver::PostgreSQL => new PostgreSQLTableManager(),
+                DBDriver::OracleDB => new OracleDBTableManager(),
+                DBDriver::SQLite => new SQLiteTableManager()
+            };
+            
+            // Проверяю существование таблицы, вывожу результат
+            return $dbDrv->isTableExist($this->DataBaseHandle, $tableName);
+        }
+    }