20250802
This commit is contained in:
@@ -1,20 +1,20 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* @noinspection SqlNoDataSourceInspection
|
||||
*/
|
||||
|
||||
namespace goodboyalex\php_db_components_pack\traits\Database;
|
||||
|
||||
use Exception;
|
||||
use goodboyalex\php_components_pack\classes\ObjectArray;
|
||||
use goodboyalex\php_db_components_pack\classes\ConditionBuilder;
|
||||
use goodboyalex\php_db_components_pack\enums\DBOperation;
|
||||
use PDO;
|
||||
|
||||
/**
|
||||
* Трейт для работы с получением данных из базы данных.
|
||||
*
|
||||
* @author Александр Бабаев
|
||||
* @package php_components_pack
|
||||
* @package php_db_components_pack
|
||||
* @version 1.0
|
||||
* @since 1.0
|
||||
* @see PDO
|
||||
@@ -22,21 +22,59 @@
|
||||
trait DatabaseGet
|
||||
{
|
||||
/**
|
||||
* Получает первую строку в массиве данных, удовлетворяющую выборке
|
||||
* Извлекает одну запись из базы данных и создает соответствующий объект класса.
|
||||
*
|
||||
* @param string $table Имя таблицы
|
||||
* @param array $columns Колонки, которые нужно включить в запрос
|
||||
* @param ConditionBuilder $where Параметры выборки
|
||||
* @param string $table Название таблицы.
|
||||
* @param ConditionBuilder $where Условия выборки.
|
||||
* @param array $columns Колонки, которые нужно включить в запрос.
|
||||
* @param string $className Полное имя класса, реализуемого интерфейсом IDBItem.
|
||||
*
|
||||
* @return false|array Строка в формате массива или false в случае ошибки
|
||||
*
|
||||
* @see Query
|
||||
* @see QueryFirst
|
||||
* @see QueryLast
|
||||
* @see QueryScalar
|
||||
* @see GetRows
|
||||
* @return object|false Заполненный объект класса или <code>false</code> в случае ошибки.
|
||||
*/
|
||||
public function GetRowColumns (string $table, array $columns, ConditionBuilder $where): false|array
|
||||
public function GetRow (string $table, ConditionBuilder $where, array $columns = [],
|
||||
string $className = "\\StdClass"): object|false
|
||||
{
|
||||
// Задаю массив параметров
|
||||
$params = [];
|
||||
|
||||
// Формируем SQL-запрос
|
||||
$sql = $this->PrepareSQLForRowsQuery($table, $columns, $where, $params);
|
||||
|
||||
// Добавляю лимит
|
||||
$sql .= " LIMIT 1";
|
||||
|
||||
// Получаю строку
|
||||
$row = $this->Query($sql, $params);
|
||||
|
||||
// Если не получено
|
||||
if ($row === false)
|
||||
// - то вывожу false
|
||||
return false;
|
||||
|
||||
// Получаю объект
|
||||
$item = $this->RestoreItem($row, $className, DBOperation::Get);
|
||||
|
||||
// Если при получении возникла ошибка
|
||||
if ($item === null)
|
||||
// - то возвращаю false
|
||||
return false;
|
||||
|
||||
// Возвращаю элемент
|
||||
return $item;
|
||||
}
|
||||
|
||||
/**
|
||||
* Получает набор строк в массиве данных, удовлетворяющий выборке.
|
||||
*
|
||||
* @param string $table Имя таблицы.
|
||||
* @param ConditionBuilder $where Where-условия выборки.
|
||||
* @param array $columns Колонки, которые нужно включить в запрос.
|
||||
* @param string $className Полное имя класса, реализуемого интерфейсом IDBItem.
|
||||
*
|
||||
* @return false|ObjectArray Массив найденных классов или <code>false</code> в случае ошибки.
|
||||
*/
|
||||
public function GetRows (string $table, ConditionBuilder $where, array $columns = [],
|
||||
string $className = "\\StdClass"): false|ObjectArray
|
||||
{
|
||||
// Задаю массив параметров
|
||||
$params = [];
|
||||
@@ -44,78 +82,99 @@
|
||||
// Получаю SQL запрос
|
||||
$sql = $this->PrepareSQLForRowsQuery($table, $columns, $where, $params);
|
||||
|
||||
// Получаю строку на основании запроса
|
||||
return $this->QueryScalar($sql, $params);
|
||||
// Получаю строки на основании запроса
|
||||
$queryResult = $this->Query($sql, $params);
|
||||
|
||||
// Если строки не получены
|
||||
if ($queryResult === false)
|
||||
// - то выдаю ошибку
|
||||
return false;
|
||||
|
||||
// Создаю массив объектов
|
||||
$result = new ObjectArray();
|
||||
|
||||
// Для каждого элемента
|
||||
foreach ($queryResult as $row) {
|
||||
// - пытаюсь восстановить объект
|
||||
$item = $this->RestoreItem($row, $className, DBOperation::Get);
|
||||
|
||||
// - если не получилось
|
||||
if ($item === null)
|
||||
// -- то пропускаю элемент
|
||||
continue;
|
||||
|
||||
// - добавляю элемент в массив
|
||||
$result[] = $item;
|
||||
}
|
||||
|
||||
// Выдаю массив объектов
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Извлекает одну запись из базы данных и создает соответствующий объект класса
|
||||
* Получает колонку в массиве данных.
|
||||
*
|
||||
* @param string $table Название таблицы
|
||||
* @param ConditionBuilder $condition Условия выборки
|
||||
* @param string $className Полное имя класса, реализуемого интерфейсом IDBItem
|
||||
* @param string $table Имя таблицы.
|
||||
* @param string $column Имя колонки.
|
||||
* @param ConditionBuilder $where Параметры запроса.
|
||||
*
|
||||
* @return object Заполненный объект класса
|
||||
* @return false|array Ассоциированный массив с результатом запроса или false в случае ошибки.
|
||||
*
|
||||
* @see Query
|
||||
*/
|
||||
public function GetRow (string $table, ConditionBuilder $condition, string $className): object
|
||||
public function GetCol (string $table, string $column, ConditionBuilder $where): false|array
|
||||
{
|
||||
try {
|
||||
// Строим условие WHERE для SQL-запроса
|
||||
$whereClause = $condition->Build();
|
||||
|
||||
// Формируем SQL-запрос
|
||||
$sql = "SELECT * FROM $table WHERE $whereClause LIMIT 1;";
|
||||
|
||||
// Подготовленное выражение
|
||||
$stmt = $this->pdo->prepare($sql);
|
||||
|
||||
// Присваивание параметров
|
||||
foreach ($params as $col => $val) {
|
||||
$stmt->bindParam(":$col", $val);
|
||||
}
|
||||
|
||||
// Выполнение запроса
|
||||
$stmt->execute();
|
||||
|
||||
// Получаем первую строку результатов
|
||||
$row = $stmt->fetch(PDO::FETCH_ASSOC);
|
||||
|
||||
if (!$row) {
|
||||
throw new Exception("No data found with the given conditions.");
|
||||
}
|
||||
|
||||
// Создание объекта желаемого класса
|
||||
$obj = new $className();
|
||||
|
||||
// Заполняем поля объекта соответствующими значениями из БД
|
||||
foreach ($row as $column => $value) {
|
||||
// Анализируем свойства класса и находим соответствующее свойство
|
||||
$properties = (new ReflectionClass($obj))->getProperties(ReflectionProperty::IS_PUBLIC);
|
||||
foreach ($properties as $prop) {
|
||||
// Проверяем, соответствует ли данное свойство указанному полю
|
||||
$attributes = $prop->getAttributes(FieldName::class);
|
||||
if ($attributes && $attributes[0]->getArguments()['name'] === $column) {
|
||||
// Применяем процедуру конвертации (если указана)
|
||||
$convertAttrs = $prop->getAttributes(ConvertToDB::class);
|
||||
if ($convertAttrs) {
|
||||
$converter = $convertAttrs[0]->getArguments()['fromDb'];
|
||||
if ($converter !== null) {
|
||||
$value = call_user_func($converter, $value);
|
||||
}
|
||||
}
|
||||
|
||||
// Устанавливаем значение свойства
|
||||
$obj->{$prop->getName()} = $value;
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $obj;
|
||||
}
|
||||
catch (\PDOException|\Exception $e) {
|
||||
error_log("Error fetching data: " . $e->getMessage());
|
||||
return null;
|
||||
}
|
||||
/**
|
||||
* Интерпретирую условия.
|
||||
*
|
||||
* @var string $sql_where Строка запроса.
|
||||
* @var array $params Массив параметров строки запроса.
|
||||
*/
|
||||
[$sql_where, $params] = $where->Build();
|
||||
|
||||
// Создаю запрос
|
||||
$sql = "SELECT $this->DBSignOpen$column$this->DBSignClose FROM $this->DBSignOpen$table$this->DBSignClose";
|
||||
|
||||
// Если заданы where-параметры
|
||||
if ($where->Count() > 0)
|
||||
// - то добавляю их
|
||||
$sql .= " WHERE $sql_where";
|
||||
|
||||
// Получаю столбец на основании запроса
|
||||
$queryResult = $this->Query($sql, $params);
|
||||
|
||||
// Если строка не получена или пуста
|
||||
if ($queryResult === false)
|
||||
// - то выдаю ошибку
|
||||
return false;
|
||||
|
||||
// Создаю результат
|
||||
$result = [];
|
||||
|
||||
// Для каждого результата запроса
|
||||
foreach ($queryResult as $row)
|
||||
// - передаю его в результат
|
||||
$result[] = $row[$column];
|
||||
|
||||
// Вывожу результат
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Получение значение единичного поля.
|
||||
*
|
||||
* @param string $table Имя таблицы.
|
||||
* @param string $column Требуемый столбец.
|
||||
* @param ConditionBuilder $where Параметры запроса.
|
||||
*
|
||||
* @return mixed|null Результат запроса или <code>null</code> в случае ошибки.
|
||||
*/
|
||||
public function GetValue (string $table, string $column, ConditionBuilder $where): mixed
|
||||
{
|
||||
// Получаю колонку по условию из таблицы
|
||||
$result = $this->GetCol($table, $column, $where);
|
||||
|
||||
// Если результат получен, то выдаю первый элемент, а если нет, то null
|
||||
return $result[0] ?? null;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user