Home Original page

Db Query

Описание

Конструктор SQL запросов

Настройка

Нет

Использование

Пример использования конструктора Select():

use \Bluz\Db\Query;
/* @var \Bluz\Db $db */
$builder = new Query\Select();
$builder->select('u.*', 'g.name AS groupName')      // SELECT u.*, g.name AS groupName
   ->from('users', 'u')                             // FROM users AS u
   ->join('u', 'group', 'g', 'g.id = u.id')         // LEFT JOIN group AS g ON g.id = u.id
   ->where('u.status = ?', 'active')                // u.status = 'active'
   ->andWhere('u.address IS NULL')                  // AND u.address IS NULL
   ->andWhere('u.role IN (?)', ['user', 'moderator']);   // AND u.role IN ('user', 'moderator')
   ->andWhere('g.id = ? OR g.id = ?', 1, 2)         // AND (g.id = 1 OR g.id = 2)
   ->andWhere('u.name LIKE (?)', 'A%')              // AND u.name LIKE 'A%'
   ->orderBy('u.name', 'ASC')                       // ORDER BY u.name ASC
   ->limit(10)                                      // LIMIT 10 OFFSET 0

Примеры: доступны в скелетоне в контроллере /test/query

Список примесей trait по отношению к методам:

       | select() | insert() | update() | delete()
select |    x     |          |          |
insert |          |     x    |          | 
update |          |          |     x    | 
delete |          |          |          |    x
from   |    x     |          |     -    |    -
join   |    x     |          |     -    |    -
where  |    x     |          |     x    |    x
group  |    x     |          |          |
having |    x     |          |          |
order  |    x     |          |          |    x
limit  |    x     |          |     x    |    x
set    |          |     x    |     x    |

Методы

Следующие методы являются общими для всех конструкторов запросов:

  • execute() - сгенерировать и выполнить запрос
  • getSql() - генерирует и возвращает SQL запрос
  • getQuery() - генерирует и возвращает SQL запрос с подстановками, необходим для проверки результата
  • setParam($key, $value, $type = \PDO::PARAM_STR) - устанавливает параметр для подстановки в запрос
  • setParams(array $params, array $types = array()) - устанавливает все параметры за раз (! вызов данного метода перетирает все параметры, которые были явно или неявно добавлены к запросу)
  • getParam($key) - возвращает параметр из подстановки
  • getParams() - возвращает все параметры из подстановки
  • __toString() - вызывает getSql()

Select

Конструктор запросов SELECT содержит следующие методы:

  • select($field [, $field[, $field .. ]]) - перечисляем параметры, которые будут подставлены в SELECT $field, .. FROM ..
  • addSelect($field [, $field[, $field .. ]]) - метод аналогичный описанному выше, но дополняет select часть, а не замещает
  • getSelect() - возвращает текущие настройки select
  • from($table, $alias) - подстановка в .. FROM $table AS $alias ..
  • join($fromAlias, $table, $alias, $condition) - подстановка в .. JOIN $table AS $alias ON $condition ..
  • leftJoin($fromAlias, $table, $alias, $condition)
  • rightJoin($fromAlias, $table, $alias, $condition)
  • innerJoin($fromAlias, $table, $alias, $condition)
  • where($condition [,$value [, $value ... ]]) - устанавливает параметры WHERE
  • andWhere($condition [,$value [, $value ... ]]) - добавляет условие в WHERE через AND
  • orWhere($condition [,$value [, $value ... ]]) - добавляет условие в WHERE через OR
  • orderBy($field, $order = 'ASC') - устанавливает сортировку (перетирает предыдущую)
  • addOrderBy($field, $order = 'ASC') - добавляет правило сортировки
  • groupBy($field) - устанавливает группировку (перетирает предыдущую)
  • addGroupBy($field) - добавляет группировку
  • limit($limit, $offset = 0) - обёртка для формирования LIMIT 100 OFFSET 200
  • setLimit($limit)
  • setOffset($offset)
  • setPage($page) - обёртка для формирования LIMIT 100 OFFSET 200, для использования должен быть установлено ограничение с использованием setLimit($limit)
  • havingBy($condition [,$value [, $value ... ]]) - обёртка для формирования HAVING
  • andHavingBy($condition [,$value [, $value ... ]])
  • orHavingBy($condition [,$value [, $value ... ]])
  • setFetchType($type) - установка формата возвращаемых данных, может быть \PDO::FETCH_CLASS, \PDO::FETCH_ASSOC или имя класса, к примеру \Application\Pages\Row, по умолчанию: \PDO::FETCH_ASSOC

Комплексный пример вы найдёте чуть выше.

Insert

Конструктор запросов INSERT, содержит следующие методы:

  • insert($table)
  • set($key, $value)

Update

Конструктор запросов UPDATE, содержит следующие методы:

  • update($table)
  • set($key, $value)
  • where($condition [,$value [, $value ... ]]) - устанавливает параметры WHERE
  • andWhere($condition [,$value [, $value ... ]]) - добавляет условие через AND
  • orWhere($condition [,$value [, $value ... ]]) - добавляет условие через OR
  • limit($limit, $offset = 0) - обёртка для формирования LIMIT 100 OFFSET 200
  • setLimit($limit)
  • setOffset($offset)

DeleteBuilder

Конструктор запросов DELETE, содержит следующие методы:

  • delete($table)
  • where($condition [,$value [, $value ... ]]) - устанавливает параметры WHERE
  • andWhere($condition [,$value [, $value ... ]]) - добавляет условие через AND
  • orWhere($condition [,$value [, $value ... ]]) - добавляет условие через OR
  • limit($limit, $offset = 0) - обёртка для формирования LIMIT 100
  • setLimit($limit)
  • setOffset($offset) - рудимент, в формировании запроса не участвует