php_db_components_pack/sources/classes/Database.php

<?php
    
    /**
     * @noinspection SqlNoDataSourceInspection
     */
    
    namespace goodboyalex\php_db_components_pack\classes;
    
    use Closure;
    use goodboyalex\php_db_components_pack\enums\DBDriver;
    use goodboyalex\php_db_components_pack\models\DBConfig;
    use goodboyalex\php_db_components_pack\traits\Database\DatabaseCountExist;
    use goodboyalex\php_db_components_pack\traits\Database\DatabaseGet;
    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\DatabaseTransactions;
    use goodboyalex\php_db_components_pack\traits\Database\DatabaseUpdate;
    use PDO;
    use PDOException;
    
    /**
     * Класс для работы с базой данных.
     *
     *  Используется класс PDO для подключения к базе данных.
     *
     * @author Александр Бабаев
     * @package php_db_components_pack
     * @version 1.0
     * @since 1.0
     * @see PDO
     */
    final class Database
    {
        
        /**
         * @var PDO|null $DataBaseHandle Переменная, хранящая класс PDO.
         */
        private ?PDO $DataBaseHandle;
        
        /**
         * @var string $DBSignOpen Символ открытия для подстановки в запросы к базе.
         */
        private string $DBSignOpen;
        
        /**
         * @var string $DBSignСlose Символ закрытия для подстановки в запросы к базе.
         */
        private string $DBSignClose;
        
        /**
         * @var Closure $OnException Обработчик исключений. Анонимная функция формата:
         *
         *      function (Exception $e, bool $isTerminate): void
         */
        private Closure $OnException;
        
        /**
         * @var DBConfig $Config Конфигурация подключения к базе данных.
         */
        private DBConfig $Config;
        
        /**
         * Конструктор.
         *
         * @param DBConfig $config Конфигурация подключения к базе данных.
         * @param callable $onException Обработчик исключений. Анонимная функция формата:
         *
         *       function (Exception $e, bool $isTerminate): void
         */
        public function __construct (DBConfig $config, callable $onException)
        {
            // Задаю конфигурацию
            $this->Config = $config;
            
            // Устанавливаю обработчик исключений
            $this->OnException = $onException;
            
            try {
                // Загружаю параметры подключения
                // - хост
                $host = $this->Config->Host;
                // - порт
                $port = $this->Config->Port;
                // - имя базы данных
                $dbname = $this->Config->Name;
                // - пользователь
                $user = $this->Config->UserName;
                // - пароль
                $password = $this->Config->Password;
                
                // Создаю dsn
                $dsn = match ($this->Config->Driver) {
                    DBDriver::MySQL => "mysql:host=$host;port=$port;dbname=$dbname",
                    DBDriver::MSSQL => "sqlsrv:Server=$host,$port;Database=$dbname;Encrypt=false;",
                    DBDriver::PostgreSQL => "pgsql:host=$host;port=$port;dbname=$dbname;",
                    DBDriver::OracleDB => "oci:dbname=$host:$port/$dbname",
                    DBDriver::SQLite => "sqlite:$dbname"
                };
                
                // Задаю DBSign
                // - Open
                $this->DBSignOpen = match ($this->Config->Driver) {
                    DBDriver::MySQL, DBDriver::SQLite => '`',
                    DBDriver::MSSQL => '[',
                    DBDriver::PostgreSQL, DBDriver::OracleDB => '"'
                };
                
                // - Close
                $this->DBSignClose = match ($this->Config->Driver) {
                    DBDriver::MySQL, DBDriver::SQLite => '`',
                    DBDriver::MSSQL => ']',
                    DBDriver::PostgreSQL, DBDriver::OracleDB => '"'
                };
                
                // Создаю объект для связи с базой данных
                $this->DataBaseHandle = new PDO($dsn, username: $user, password: $password);
                
                // Устанавливаю уровень ошибок
                $this->DataBaseHandle->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
            }
            catch (PDOException $e) {
                $this->HandleException($e);
            }
        }
        
        /**
         * Деструктор. Закрывает соединение с базой данных
         */
        public function __destruct ()
        {
            $this->DataBaseHandle = null;
        }
        
        // Транзакции
        use DatabaseTransactions;
        
        // Запросы Query и Execute
        use DatabaseQueryExecute;
        
        // Вставка данных
        use DatabaseInsert;
        
        // Получение данных
        use DatabaseGet;
        
        // Проверка существования и получение количества строк
        use DatabaseCountExist;
        
        // Обновление записей
        use DatabaseUpdate;
        
        // Приватные методы
        use DatabaseSpecial;
        
        /**
         * Удаляет строки по условию.
         *
         * @param string $table Имя таблицы
         * @param array $where Массив условий
         *
         * @return bool Результат выполнения
         */
        public function Delete (string $table, array $where = []): bool
        {
            // Обработанные параметры
            $params = [];
            
            // Строковая интерпретация массива условий
            $sql_where = $this->PrepareQueryWhere(where: $where, params: $params);
            
            // Создаю запрос
            $sql = "DELETE FROM $this->DBSignOpen$table$this->DBSignClose";
            
            // Если заданы where-параметры
            if (count($where) > 0) {
                // - то добавляю их
                $sql .= " WHERE $sql_where";
            }
            
            // Выполняю запрос
            $count = $this->Execute($sql, $params);
            
            // Если результат - false
            if ($count === false)
                // - то и общий результат - false
                return false;
            
            // Если изменено 0 строк
            if ($count === 0)
                // - то и общий результат - false
                return false;
            
            // Вывожу результат -- успех
            return true;
        }
    }