20250729

sources/traits/Database/DatabaseQueryExecute.php

@@ -0,0 +1,182 @@
+<?php
+    
+    /**
+     * @noinspection SqlNoDataSourceInspection
+     */
+    
+    namespace goodboyalex\php_db_components_pack\traits\Database;
+    
+    use PDO;
+    use PDOException;
+    
+    /**
+     * Трейт для работы с запросами к базе данных типа Query и Execute.
+     *
+     * @author Александр Бабаев
+     * @package php_components_pack
+     * @version 1.0
+     * @since 1.0
+     * @see PDO
+     */
+    trait DatabaseQueryExecute
+    {
+        /**
+         * Запрос строк из базы данных.
+         *
+         * @param string $query Запрос
+         * @param array $params Параметры запроса
+         *
+         * @return false|array Ассоциированный массив с результатом запроса или false в случае ошибки
+         */
+        public function Query (string $query, array $params = []): false|array
+        {
+            // По умолчанию, результат пуст
+            $result = false;
+            
+            try {
+                // Подготавливаю запрос
+                $STH = $this->DataBaseHandle->prepare($query, [PDO::ATTR_CURSOR => PDO::CURSOR_FWDONLY]);
+                
+                // Выполняю запрос
+                $STH->execute($params);
+                
+                // Указываю, что данные, которые я хочу получить, должны быть в ассоциативном массиве
+                $STH->setFetchMode(PDO::FETCH_ASSOC);
+                
+                // Получаю все данные
+                $result = $STH->fetchAll();
+            }
+            catch (PDOException $e) {
+                $this->HandleException($e);
+            }
+            
+            // Вывожу результат
+            return $result;
+        }
+        
+        /**
+         * Выполняем запрос на получение одной строки (аналог QueryFirst)
+         *
+         * @param string $query Запрос
+         * @param array $params Параметры запроса
+         *
+         * @return false|array Строка в формате массива или false в случае ошибки
+         *
+         * @see Query
+         * @see QueryFirst
+         * @see QueryLast
+         * @see GetRow
+         */
+        public function QueryScalar (string $query, array $params = []): false|array
+        {
+            return $this->QueryFirst($query, $params);
+        }
+        
+        /**
+         * Выполняем запрос на получение первой строки
+         *
+         * @param string $query Запрос
+         * @param array $params Параметры запроса
+         *
+         * @return false|array Строка в формате массива или false в случае ошибки
+         *
+         * @see Query
+         * @see QueryLast
+         * @see QueryScalar
+         */
+        public function QueryFirst (string $query, array $params = []): false|array
+        {
+            // Выполняю запрос
+            $result = $this->Query($query, $params);
+            
+            // Если в результате запроса получили ошибку или количество строк = 0
+            if ($result === false || count($result) == 0)
+                // - то возвращаем ошибку
+                return false;
+            
+            // Получаю первый ключ массива
+            $firstKey = array_key_first($result);
+            
+            // Возвращаем первую строку
+            return $result[$firstKey];
+        }
+        
+        /**
+         * Выполняем запрос на получение последней строки
+         *
+         * @param string $query Запрос
+         * @param array $params Параметры запроса
+         *
+         * @return false|array Строка в формате массива или false в случае ошибки
+         *
+         * @see Query
+         * @see QueryFirst
+         * @see QueryScalar
+         */
+        public function QueryLast (string $query, array $params = []): false|array
+        {
+            // Выполняю запрос
+            $result = $this->Query($query, $params);
+            
+            // Если в результате запроса получили ошибку или количество строк = 0
+            if ($result === false || count($result) == 0)
+                // - то возвращаем ошибку
+                return false;
+            
+            // Получаю последний ключ массива
+            $lastKey = array_key_last($result);
+            
+            // Возвращаем первую строку
+            return $result[$lastKey];
+        }
+        
+        
+        /**
+         * Выполнение запроса. Обычно используется для операций,
+         * которые не возвращают никаких данных, кроме количества
+         * затронутых ими записей. Например,
+         *
+         * <code>$db->Execute('DELETE FROM table WHERE id=1');</code>
+         *
+         * @param string $query Запрос
+         * @param array $params Параметры запроса
+         *
+         * @return int|false Количество затронутых строк или false в случае ошибки
+         */
+        public function Execute (string $query, array $params = []): int|false
+        {
+            // По умолчанию результат false
+            $result = false;
+            try {
+                // Если параметры не заданы
+                if (count($params) == 0) {
+                    // - то выполняю запрос
+                    $result = $this->DataBaseHandle->exec($query);
+                }
+                else {
+                    // - в противном случае
+                    // -- подготавливаю запрос
+                    $STH = $this->DataBaseHandle->prepare($query, [PDO::ATTR_CURSOR => PDO::CURSOR_FWDONLY]);
+                    
+                    // -- выполняю запрос
+                    $opResult = $STH->execute($params);
+                    
+                    // -- и если выполнение успешное,
+                    if ($opResult)
+                        // --- то в результат пойдёт количество строк
+                        $result = $STH->rowCount();
+                }
+            }
+            catch (PDOException $e) {
+                $this->HandleException($e);
+            }
+            
+            // Если в результате false
+            if ($result === false)
+                // - то возвращаю его
+                return false;
+            
+            // Возвращаю результат
+            return $result;
+        }
+    }