shasoft/sql-query-builder

Package for generating SQL queries to the database

v1.0.2 2024-01-22 18:01 UTC

This package is auto-updated.

Last update: 2024-12-22 19:58:39 UTC


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

Стандартные примеры Примеры функции заполнения