shasoft / sql-query-builder
Package for generating SQL queries to the database
v1.0.2
2024-01-22 18:01 UTC
Requires
- psr/cache: ^3
- shasoft/db-schema: *
Requires (Dev)
README
Особенности:
- Работа напрямую с драйвером PDO (mysql и pgsql)
- Поддержка SELECT, INSERT, UPDATE, DELETE
- Соединения JOIN (INNER, LEFT, RIGHT)
- Подзапросы в условиях фильтрации (в том числе многостолбцовые подзапросы)
- Исключение дубликатов, DISTINCT
- Сортировка, оператор ORDER BY
- Группировка, оператор GROUP BY
- Агрегатные функции
- Оператор HAVING
- Ограничение выборки, оператор LIMIT
- Поддержка пагинации (возвращается объект пагинации который содержит всю информацию (текущая страница, общее количество страниц и т.д.))
- Поддержка выборки данных с использованием КЭШирования
Результирующая выборка конвертирует выбранные данные в типы данных, определенные в миграциях через пакет версионирования shasoft/db-schema.
// Создать построитель запросов $builder = new Builder( // PDO драйвер соединения с БД \PDO $pdo, // Состояние БД StateDatabase $stateDatabase ); // Сгенерировать и выполнить запрос $builder->select(User::class, ['id', 'name']) ->where(function (Where $where) { $where ->cond('id', '>', 1) ->inSelect( ['id', 'name'], UserInfo::class, ['id', 'description'] ); }) ->join(function (Join $join) { $join->left(Article::class, ['userId' => 'id'], ['sum(rate) as rate']) ->having('SUM(rate)', '>', 100); }) ->limit(2)->orderBy('name') ->groupBy('id')->groupBy('name') ->get();
Сгенерированный запрос
SELECT `U`.`id`, `U`.`name`, SUM(`B`.`rate`) AS `rate` FROM `user` `U` LEFT JOIN `article` `B` ON `B`.`userId` = `U`.`id` WHERE (`U`.`id` > 1 AND(`U`.`id`, `U`.`name`) IN( SELECT `A`.`id`, `A`.`description` FROM `userinfo` `A` ) ) GROUP BY `U`.`id`, `U`.`name` HAVING SUM(`B`.`rate`) > 100 ORDER BY `U`.`name` ASC LIMIT 2