Spec-Zone.ru › Laravel 5.2

Строитель

класс Builder (Просмотреть исходный код)

Трейты

Macroable

Свойства

static protected array $macros Зарегистрированные макросы строк. from Macroable
protected Connection $connection Экземпляр соединения с базой данных.
protected Grammar $grammar Экземпляр грамматики запросов к базе данных.
protected Processor $processor Экземпляр постпроцессора запросов к базе данных.
protected array $bindings Текущие значения связей запроса.
array $aggregate Функция агрегирования и столбец для выполнения.
array $columns Столбцы, которые должны быть возвращены.
bool $distinct Указывает, возвращает ли запрос уникальные результаты.
string $from Таблица, на которую нацелен запрос.
array $joins Соединения таблиц для запроса.
array $wheres Условие where для запроса.
array $groups Группировки для запроса.
array $havings Условие having для запроса.
array $orders Сортировка для запроса.
int $limit Максимальное количество записей для возврата.
int $offset Количество записей для пропуска.
array $unions Объединения запросов.
int $unionLimit Максимальное число записей объединения для возврата.
int $unionOffset Число записей объединения, которые нужно пропустить.
array $unionOrders Порядок сортировки для запроса объединения.
string|bool $lock Указывает, используется ли блокировка строк.
protected array $backups Текущие резервные копии полей.
protected array $bindingBackups Текущие резервные копии привязок.
protected array $operators Все доступные операторы для условий.
protected bool $useWritePdo Использовать ли pdo для записи при выборке.

Методы

static void macro(string $name, callable $macro)

Зарегистрировать пользовательскую макрокоманду.

from Macroable
static bool hasMacro(string $name)

Проверить, зарегистрирована ли макрокоманда.

from Macroable
static mixed __callStatic(string $method, array $parameters)

Динамически обработать вызовы класса.

from Macroable
mixed __call(string $method, array $parameters)

Обработать динамические вызовы методов.

void __construct(ConnectionInterface $connection, Grammar $grammar = null, Processor $processor = null)

Создать новый экземпляр билдера запросов.

$this select(array|mixed $columns = ['*'])

Установить столбцы для выбора.

Builder|Builder selectRaw(string $expression, array $bindings = [])

Добавить новое выражение "raw" для выбора в запрос.

Builder|Builder selectSub(Closure|Builder|string $query, string $as)

Добавить подзапрос в запрос.

$this addSelect(array|mixed $column)

Добавить новый столбец для выбора в запрос.

$this distinct()

Принудительно возвращать только уникальные результаты.

$this from(string $table)

Указать таблицу, на которую направлен запрос.

$this join(string $table, string $one, string $operator = null, string $two = null, string $type = 'inner', bool $where = false)

Добавить условие объединения в запрос.

Builder|Builder joinWhere(string $table, string $one, string $operator, string $two, string $type = 'inner')

Добавить условие «join where» в запрос.

Builder|Builder leftJoin(string $table, string $first, string $operator = null, string $second = null)

Добавить левое объединение в запрос.

Builder|Builder leftJoinWhere(string $table, string $one, string $operator, string $two)

Добавить условие «join where» в левое объединение.

Builder|Builder rightJoin(string $table, string $first, string $operator = null, string $second = null)

Добавить правое соединение к запросу.

Builder|Builder rightJoinWhere(string $table, string $one, string $operator, string $two)

Добавить условие «правое соединение, где» к запросу.

Builder|Builder crossJoin(string $table, string $first = null, string $operator = null, string $second = null)

Добавить условие «внешнее соединение» к запросу.

Builder when(bool $value, Closure $callback)

Применить изменения запроса из обратного вызова, если заданное «значение» истинно.

$this where(string|array|Closure $column, string $operator = null, mixed $value = null, string $boolean = 'and')

Добавить базовое условие «где» к запросу.

$this addArrayOfWheres(array $column, string $boolean, string $method = 'where')

Добавить массив условий «где» к запросу.

bool invalidOperatorAndValue(string $operator, mixed $value)

Определить, является ли данная комбинация оператора и значения допустимой.

Builder|Builder orWhere(string $column, string $operator = null, mixed $value = null)

Добавить условие "или где" к запросу.

Builder|Builder whereColumn(string|array $first, string|null $operator = null, string|null $second = null, string|null $boolean = 'and')

Добавить условие "где", сравнивая две колонки, к запросу.

Builder|Builder orWhereColumn(string|array $first, string|null $operator = null, string|null $second = null)

Добавить условие "или где", сравнивая две колонки, к запросу.

$this whereRaw(string $sql, array $bindings = [], string $boolean = 'and')

Добавить сырое условие "где" к запросу.

Builder|Builder orWhereRaw(string $sql, array $bindings = [])

Добавить сырое условие "или где" к запросу.

$this whereBetween(string $column, array $values, string $boolean = 'and', bool $not = false)

Добавить условие "между" к запросу.

Builder|Builder orWhereBetween(string $column, array $values)

Добавить условие "или между" к запросу.

Builder|Builder whereNotBetween(string $column, array $values, string $boolean = 'and')

Добавить условие where not between в запрос.

Builder|Builder orWhereNotBetween(string $column, array $values)

Добавить условие or where not between в запрос.

Builder|Builder whereNested(Closure $callback, string $boolean = 'and')

Добавить вложенное условие where в запрос.

Builder forNestedWhere()

Создать новый экземпляр запроса для вложенного условия where.

$this addNestedWhereQuery(Builder|Builder $query, string $boolean = 'and')

Добавить другой объект Query Builder как вложенное условие where в Query Builder.

$this whereSub(string $column, string $operator, Closure $callback, string $boolean)

Добавить полное подзапросное условие в запрос.

$this whereExists(Closure $callback, string $boolean = 'and', bool $not = false)

Добавить условие exists в запрос.

Builder|Builder orWhereExists(Closure $callback, bool $not = false)

Добавить условие «или существует» к запросу.

Builder|Builder whereNotExists(Closure $callback, string $boolean = 'and')

Добавить условие «где не существует» к запросу.

Builder|Builder orWhereNotExists(Closure $callback)

Добавить условие «или где не существует» к запросу.

$this addWhereExistsQuery(Builder $query, string $boolean = 'and', bool $not = false)

Добавить условие «существует» к запросу.

$this whereIn(string $column, mixed $values, string $boolean = 'and', bool $not = false)

Добавить условие «где в» к запросу.

Builder|Builder orWhereIn(string $column, mixed $values)

Добавить условие «или где в» к запросу.

Builder|Builder whereNotIn(string $column, mixed $values, string $boolean = 'and')

Добавить условие «где не в» к запросу.

Builder|Builder orWhereNotIn(string $column, mixed $values)

Добавить условие «или не содержится в» к запросу.

$this whereInSub(string $column, Closure $callback, string $boolean, bool $not)

Добавить условие «содержится в» с подзапросом к запросу.

$this whereInExistingQuery(string $column, Builder|Builder $query, string $boolean, bool $not)

Добавить внешний подзапрос к запросу.

$this whereNull(string $column, string $boolean = 'and', bool $not = false)

Добавить условие «где null» к запросу.

Builder|Builder orWhereNull(string $column)

Добавить условие «или где null» к запросу.

Builder|Builder whereNotNull(string $column, string $boolean = 'and')

Добавить условие «где не null» к запросу.

Builder|Builder orWhereNotNull(string $column)

Добавить условие «или где не null» к запросу.

Builder|Builder whereDate(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где дата" в запрос.

Builder|Builder orWhereDate(string $column, string $operator, int $value)

Добавить условие "или где дата" в запрос.

Builder|Builder whereTime(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где время" в запрос.

Builder|Builder orWhereTime(string $column, string $operator, int $value)

Добавить условие "или где время" в запрос.

Builder|Builder whereDay(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где день" в запрос.

Builder|Builder whereMonth(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где месяц" в запрос.

Builder|Builder whereYear(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где год" в запрос.

$this addDateBasedWhere(string $type, string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие на основе даты (год, месяц, день, время) в запрос.

$this dynamicWhere(string $method, string $parameters)

Обрабатывает динамические условия «where» в запросе.

void addDynamic(string $segment, string $connector, array $parameters, int $index)

Добавить отдельное динамическое условие «where» в запрос.

$this groupBy()

Добавить условие «group by» в запрос.

$this having(string $column, string $operator = null, string $value = null, string $boolean = 'and')

Добавить условие «having» в запрос.

Builder|Builder orHaving(string $column, string $operator = null, string $value = null)

Добавить условие «or having» в запрос.

$this havingRaw(string $sql, array $bindings = [], string $boolean = 'and')

Добавить необработанное условие «having» в запрос.

Builder|Builder orHavingRaw(string $sql, array $bindings = [])

Добавить необработанное условие «or having» в запрос.

$this orderBy(string $column, string $direction = 'asc')

Добавить условие «order by» в запрос.

Builder|Builder latest(string $column = 'created_at')

Добавить условие "упорядочить по" для отметки времени в запросе.

Builder|Builder oldest(string $column = 'created_at')

Добавить условие "упорядочить по" для отметки времени в запросе.

$this inRandomOrder(string $seed = '')

Вывести результаты запроса в случайном порядке.

$this orderByRaw(string $sql, array $bindings = [])

Добавить условие "упорядочить по" в виде исходного SQL-кода в запрос.

$this offset(int $value)

Установить значение "смещения" запроса.

Builder|Builder skip(int $value)

Псевдоним для установки значения "смещения" запроса.

$this limit(int $value)

Установить значение "ограничения" запроса.

Builder|Builder take(int $value)

Псевдоним для установки значения "ограничения" запроса.

Builder|Builder forPage(int $page, int $perPage = 15)

Установить ограничение и смещение для заданной страницы.

Builder|Builder forPageAfterId(int $perPage = 15, int $lastId, string $column = 'id')

Ограничить запрос следующей "страницей" результатов после заданного ID.

Builder|Builder union(Builder|Closure $query, bool $all = false)

Добавить оператор объединения к запросу.

Builder|Builder unionAll(Builder|Closure $query)

Добавить оператор объединения all к запросу.

$this lock(bool $value = true)

Заблокировать выбранные строки в таблице.

Builder lockForUpdate()

Заблокировать выбранные строки в таблице для обновления.

Builder sharedLock()

Заблокировать выбранные строки в таблице с использованием совместной блокировки.

string toSql()

Получить SQL представление запроса.

mixed|Builder find(int $id, array $columns = ['*'])

Выполнить запрос для одной записи по ID.

смешанный value(string $column)

Получить значение одного столбца из первого результата запроса.

смешанный|Builder first(array $columns = ['*'])

Выполнить запрос и получить первый результат.

массив|Builder[] get(array $columns = ['*'])

Выполнить запрос как оператор "select".

массив runSelect()

Выполнить запрос как оператор "select" на соединении.

LengthAwarePaginator paginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int|null $page = null)

Разбить заданный запрос на страницы с помощью простого пагинатора.

Paginator simplePaginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int|null $page = null)

Получить пагинатор, поддерживающий только простые ссылки "следующая" и "предыдущая".

целое число getCountForPagination(array $columns = ['*'])

Получить количество всех записей для пагинатора.

void backupFieldsForCount()

Создать резервную копию некоторых полей для подсчёта на странице.

массив clearSelectAliases(array $columns)

Удалить алиасы столбцов, так как они нарушают запросы на подсчёт.

void restoreFieldsForCount()

Восстановить некоторые поля после изменения количества страниц.

Generator cursor()

Получить генератор для заданного запроса.

bool chunk(int $count, callable $callback)

Разбить результаты запроса на куски.

bool chunkById(int $count, callable $callback, string $column = 'id', string $alias = null)

Разбить результаты запроса на куски, сравнивая числовые идентификаторы.

bool each(callable $callback, int $count = 1000)

Выполнить обратный вызов для каждого элемента, разбивая на куски.

array pluck(string $column, string|null $key = null)

Получить массив со значениями заданного столбца.

array lists(string $column, string|null $key = null) deprecated

Псевдоним для метода "pluck".

string|null stripTableForPluck(string $column)

Удалить имя таблицы или псевдоним из идентификатора столбца.

string implode(string $column, string $glue = '')

Склеить значения заданного столбца в строку.

bool exists()

Определить, существуют ли строки для текущего запроса.

int count(string $columns = '*')

Получить результат "count" запроса.

mixed min(string $column)

Получить минимальное значение заданного столбца.

mixed max(string $column)

Получить максимальное значение заданного столбца.

mixed sum(string $column)

Получить сумму значений заданного столбца.

mixed avg(string $column)

Получить среднее значение значений заданного столбца.

mixed average(string $column)

Псевдоним для метода "avg".

mixed aggregate(string $function, array $columns = ['*'])

Выполнить агрегационную функцию на базе данных.

float|int numericAggregate(string $function, array $columns = ['*'])

Выполнить числовую агрегационную функцию на базе данных.

bool insert(array $values)

Вставить новую запись в базу данных.

int insertGetId(array $values, string $sequence = null)

Вставить новую запись и получить значение первичного ключа.

int update(array $values)

Обновить запись в базе данных.

bool updateOrInsert(array $attributes, array $values = [])

Вставить или обновить запись, соответствующую атрибутам, и заполнить её значениями.

int increment(string $column, int $amount = 1, array $extra = [])

Увеличить значение столбца на заданное количество.

int decrement(string $column, int $amount = 1, array $extra = [])

Уменьшить значение столбца на заданную величину.

int delete(mixed $id = null)

Удалить запись из базы данных.

void truncate()

Выполнить операцию truncate для таблицы.

Builder newQuery()

Получить новую инстанцию билдера запросов.

void mergeWheres(array $wheres, array $bindings)

Объединить массив условий where и привязок.

array cleanBindings(array $bindings)

Удалить все выражения из списка привязок.

Expression raw(mixed $value)

Создать выражение для базы данных.

array getBindings()

Получить текущие привязки значений запроса в плоском массиве.

array getRawBindings()

Получить сырой массив привязок.

$this setBindings(array $bindings, string $type = 'where')

Установить привязки к билдеру запросов.

$this addBinding(mixed $value, string $type = 'where')

Добавить привязку к запросу.

$this mergeBindings(Builder $query)

Объединить массив привязок в наши привязки.

ConnectionInterface getConnection()

Получить экземпляр подключения к базе данных.

Processor getProcessor()

Получить экземпляр обработчика запросов базы данных.

Grammar getGrammar()

Получить экземпляр синтаксического анализатора запросов.

$this useWritePdo()

Использовать write pdo для запроса.

Подробности

static void macro(string $name, callable $macro)

Зарегистрировать пользовательское макро.

Параметры

string $name
callable $macro

Возвращаемое значение

void

static bool hasMacro(string $name)

Проверка регистрации макроса.

Параметры

string $name

Возвращаемое значение

bool

static mixed __callStatic(string $method, array $parameters)

Динамически обрабатывает вызовы класса.

Параметры

string $method
array $parameters

Значение возврата

mixed

Исключения

BadMethodCallException

mixed __call(string $method, array $parameters)

Обрабатывает динамические вызовы метода в метод.

Параметры

string $method
array $parameters

Значение возврата

mixed

Исключения

BadMethodCallException

void __construct(ConnectionInterface $connection, Grammar $grammar = null, Processor $processor = null)

Создать новый экземпляр билдера запросов.

Параметры

ConnectionInterface $connection
Grammar $grammar
Processor $processor

Значение возврата

void

$this select(array|mixed $columns = ['*'])

Установить столбцы для выбора.

Параметры

array|mixed $columns

Значение возврата

$this

Builder|Builder selectRaw(string $expression, array $bindings = [])

Добавить новое выражение "сырого" выбора в запрос.

Параметры

string $expression
array $bindings

Значение возврата

Builder|Builder

Builder|Builder selectSub(Closure|Builder|string $query, string $as)

Добавить выражение подзапроса в запрос.

Параметры

Closure|Builder|string $query
string $as

Значение возврата

Builder|Builder

Исключения

InvalidArgumentException

$this addSelect(array|mixed $column)

Добавить новый столбец выбора в запрос.

Параметры

array|mixed $column

Возвращаемое значение

$this

$this distinct()

Вынудить запрос возвращать только уникальные результаты.

Возвращаемое значение

$this

$this from(string $table)

Указать таблицу, на которую направлен запрос.

Параметры

string $table

Возвращаемое значение

$this

$this join(string $table, string $one, string $operator = null, string $two = null, string $type = 'inner', bool $where = false)

Добавить условие объединения в запрос.

Параметры

string $table
string $one
string $operator
string $two
string $type
bool $where

Возвращаемое значение

$this

Builder|Builder joinWhere(string $table, string $one, string $operator, string $two, string $type = 'inner')

Добавить условие "join where" к запросу.

Параметры

string $table
string $one
string $operator
string $two
string $type

Значение возврата

Builder|Builder

Builder|Builder leftJoin(string $table, string $first, string $operator = null, string $second = null)

Добавить левое соединение к запросу.

Параметры

string $table
string $first
string $operator
string $second

Значение возврата

Builder|Builder

Builder|Builder leftJoinWhere(string $table, string $one, string $operator, string $two)

Добавить условие "join where" к запросу.

Параметры

string $table
string $one
string $operator
string $two

Значение возврата

Builder|Builder

Builder|Builder rightJoin(string $table, string $first, string $operator = null, string $second = null)

Добавить правое соединение к запросу.

Параметры

string $table
string $first
string $operator
string $second

Возвращаемое значение

Builder|Builder

Builder|Builder rightJoinWhere(string $table, string $one, string $operator, string $two)

Добавить условие "правое соединение где" к запросу.

Параметры

string $table
string $one
string $operator
string $two

Возвращаемое значение

Builder|Builder

Builder|Builder crossJoin(string $table, string $first = null, string $operator = null, string $second = null)

Добавить условие "внешнее соединение" к запросу.

Параметры

string $table
string $first
string $operator
string $second

Возвращаемое значение

Builder|Builder

Builder when(bool $value, Closure $callback)

Применить изменения запроса обратного вызова, если заданное «значение» истинно.

Параметры

bool $value
Closure $callback

Возвращаемое значение

Builder

$this where(string|array|Closure $column, string $operator = null, mixed $value = null, string $boolean = 'and')

Добавить базовое условие where в запрос.

Параметры

string|array|Closure $column
string $operator
mixed $value
string $boolean

Возвращаемое значение

$this

Исключения

InvalidArgumentException

protected $this addArrayOfWheres(array $column, string $boolean, string $method = 'where')

Добавить массив условий where в запрос.

Параметры

array $column
string $boolean
string $method

Возвращаемое значение

$this

protected bool invalidOperatorAndValue(string $operator, mixed $value)

Определить, является ли данная комбинация оператора и значения законной.

Параметры

string $operator
mixed $value

Возвращаемое значение

bool

Builder|Builder orWhere(string $column, string $operator = null, mixed $value = null)

Добавить условие "или где" к запросу.

Параметры

string $column
string $operator
mixed $value

Возвращаемое значение

Builder|Builder

Builder|Builder whereColumn(string|array $first, string|null $operator = null, string|null $second = null, string|null $boolean = 'and')

Добавить условие "где" для сравнения двух столбцов в запрос.

Параметры

string|array $first
string|null $operator
string|null $second
string|null $boolean

Возвращаемое значение

Builder|Builder

Builder|Builder orWhereColumn(string|array $first, string|null $operator = null, string|null $second = null)

Добавить условие «или где» сравнивая два столбца к запросу.

Параметры

string|array $first
string|null $operator
string|null $second

Возвращаемое значение

Builder|Builder

$this whereRaw(string $sql, array $bindings = [], string $boolean = 'and')

Добавить сырое условие «где» к запросу.

Параметры

string $sql
array $bindings
string $boolean

Возвращаемое значение

$this

Builder|Builder orWhereRaw(string $sql, array $bindings = [])

Добавить сырое условие «или где» к запросу.

Параметры

string $sql
array $bindings

Возвращаемое значение

Builder|Builder

$this whereBetween(string $column, array $values, string $boolean = 'and', bool $not = false)

Добавить условие «между» в запрос.

Параметры

string $column
array $values
string $boolean
bool $not

Возвращаемое значение

$this

Builder|Builder orWhereBetween(string $column, array $values)

Добавить условие «или между» в запрос.

Параметры

string $column
array $values

Возвращаемое значение

Builder|Builder

Builder|Builder whereNotBetween(string $column, array $values, string $boolean = 'and')

Добавить условие «не между» в запрос.

Параметры

string $column
array $values
string $boolean

Возвращаемое значение

Builder|Builder

Builder|Builder orWhereNotBetween(string $column, array $values)

Добавить условие or where not between в запрос.

Параметры

string $column
array $values

Возвращаемое значение

Builder|Builder

Builder|Builder whereNested(Closure $callback, string $boolean = 'and')

Добавить вложенное условие where в запрос.

Параметры

Closure $callback
string $boolean

Возвращаемое значение

Builder|Builder

Builder forNestedWhere()

Создать новый экземпляр запроса для вложенного условия where.

Возвращаемое значение

Builder

$this addNestedWhereQuery(Builder|Builder $query, string $boolean = 'and')

Добавить другой конструктор запроса в качестве вложенного условия к конструктору запроса.

Параметры

Builder|Builder $query
string $boolean

Возвращаемое значение

$this

protected $this whereSub(string $column, string $operator, Closure $callback, string $boolean)

Добавить полное подзапросное условие к запросу.

Параметры

string $column
string $operator
Closure $callback
string $boolean

Возвращаемое значение

$this

$this whereExists(Closure $callback, string $boolean = 'and', bool $not = false)

Добавить условие exists к запросу.

Параметры

Closure $callback
string $boolean
bool $not

Возвращаемое значение

$this

Builder|Builder orWhereExists(Closure $callback, bool $not = false)

Добавить условие или существует в запросе.

Параметры

Closure $callback
bool $not

Значение, возвращаемое функцией

Builder|Builder

Builder|Builder whereNotExists(Closure $callback, string $boolean = 'and')

Добавить условие не существует в запросе.

Параметры

Closure $callback
string $boolean

Значение, возвращаемое функцией

Builder|Builder

Builder|Builder orWhereNotExists(Closure $callback)

Добавить условие не существует в запросе.

Параметры

Closure $callback

Значение, возвращаемое функцией

Builder|Builder

$this addWhereExistsQuery(Builder $query, string $boolean = 'and', bool $not = false)

Добавить условие существует в запросе.

Параметры

Builder $query
string $boolean
bool $not

Возвращаемое значение

$this

$this whereIn(string $column, mixed $values, string $boolean = 'and', bool $not = false)

Добавить условие "where in" в запрос.

Параметры

string $column
mixed $values
string $boolean
bool $not

Возвращаемое значение

$this

Builder|Builder orWhereIn(string $column, mixed $values)

Добавить условие "or where in" в запрос.

Параметры

string $column
mixed $values

Возвращаемое значение

Builder|Builder

Builder|Builder whereNotIn(string $column, mixed $values, string $boolean = 'and')

Добавить условие «не в» к запросу.

Параметры

string $column
mixed $values
string $boolean

Возвращаемое значение

Builder|Builder

Builder|Builder orWhereNotIn(string $column, mixed $values)

Добавить условие «или не в» к запросу.

Параметры

string $column
mixed $values

Возвращаемое значение

Builder|Builder

protected $this whereInSub(string $column, Closure $callback, string $boolean, bool $not)

Добавить условие «в» с подзапросом к запросу.

Параметры

string $column
Closure $callback
string $boolean
bool $not

Возвращаемое значение

$this

protected $this whereInExistingQuery(string $column, Builder|Builder $query, string $boolean, bool $not)

Добавить внешний подзапрос в запрос.

Параметры

string $column
Builder|Builder $query
string $boolean
bool $not

Возвращаемое значение

$this

$this whereNull(string $column, string $boolean = 'and', bool $not = false)

Добавить условие "где null" к запросу.

Параметры

string $column
string $boolean
bool $not

Возвращаемое значение

$this

Builder|Builder orWhereNull(string $column)

Добавить условие "или где null" к запросу.

Параметры

string $column

Возвращаемое значение

Builder|Builder

Builder|Builder whereNotNull(string $column, string $boolean = 'and')

Добавить условие "где не null" в запрос.

Параметры

string $column
string $boolean

Возвращаемое значение

Builder|Builder

Builder|Builder orWhereNotNull(string $column)

Добавить условие "или где не null" в запрос.

Параметры

string $column

Возвращаемое значение

Builder|Builder

Builder|Builder whereDate(string $column, string $operator, int $value, string $boolean = 'and')

Добавить оператор "где дата" в запрос.

Параметры

string $column
string $operator
int $value
string $boolean

Возвращаемое значение

Builder|Builder

Builder|Builder orWhereDate(string $column, string $operator, int $value)

Добавить условие "или где дата" к запросу.

Параметры

string $column
string $operator
int $value

Значение возврата

Builder|Builder

Builder|Builder whereTime(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где время" к запросу.

Параметры

string $column
string $operator
int $value
string $boolean

Значение возврата

Builder|Builder

Builder|Builder orWhereTime(string $column, string $operator, int $value)

Добавить условие "или где время" к запросу.

Параметры

string $column
string $operator
int $value

Значение возврата

Builder|Builder

Builder|Builder whereDay(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где день" в запрос.

Параметры

string $column
string $operator
int $value
string $boolean

Значение результата

Builder|Builder

Builder|Builder whereMonth(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где месяц" в запрос.

Параметры

string $column
string $operator
int $value
string $boolean

Значение результата

Builder|Builder

Builder|Builder whereYear(string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие "где год" в запрос.

Параметры

string $column
string $operator
int $value
string $boolean

Значение результата

Builder|Builder

protected $this addDateBasedWhere(string $type, string $column, string $operator, int $value, string $boolean = 'and')

Добавить условие, основанное на дате (год, месяц, день, время), в запрос.

Параметры

string $type
string $column
string $operator
int $value
string $boolean

Возвращаемое значение

$this

$this dynamicWhere(string $method, string $parameters)

Обрабатывает динамические условия "where" для запроса.

Параметры

string $method
string $parameters

Возвращаемое значение

$this

protected void addDynamic(string $segment, string $connector, array $parameters, int $index)

Добавить одно динамическое условие "where" в запрос.

Параметры

string $segment
string $connector
array $parameters
int $index

Возвращаемое значение

void

$this groupBy()

Добавить условие "group by" в запрос.

Возвращаемое значение

$this

$this having(string $column, string $operator = null, string $value = null, string $boolean = 'and')

Добавить условие "having" к запросу.

Параметры

string $column
string $operator
string $value
string $boolean

Возвращаемое значение

$this

Builder|Builder orHaving(string $column, string $operator = null, string $value = null)

Добавить условие "or having" к запросу.

Параметры

string $column
string $operator
string $value

Возвращаемое значение

Builder|Builder

$this havingRaw(string $sql, array $bindings = [], string $boolean = 'and')

Добавить условие having в виде SQL запроса.

Параметры

string $sql
array $bindings
string $boolean

Возвращаемое значение

$this

Builder|Builder orHavingRaw(string $sql, array $bindings = [])

Добавить условие orHaving или raw условие в запрос.

Параметры

string $sql
array $bindings

Возвращаемое значение

Builder|Builder

$this orderBy(string $column, string $direction = 'asc')

Добавить условие "order by" в запрос.

Параметры

string $column
string $direction

Возвращаемое значение

$this

Builder|Builder latest(string $column = 'created_at')

Добавить условие "order by" для отметки времени в запрос.

Параметры

string $column

Возвращаемое значение

Builder|Builder

Builder|Builder oldest(string $column = 'created_at')

Добавить условие "order by" для отметки времени в запрос.

Параметры

string $column

Возвращаемое значение

Builder|Builder

$this inRandomOrder(string $seed = '')

Разместить результаты запроса в случайном порядке.

Параметры

строка $seed

Значение возврата

$this

$this orderByRaw(string $sql, array $bindings = [])

Добавить сырое условие «упорядочить по» в запрос.

Параметры

строка $sql
массив $bindings

Значение возврата

$this

$this offset(int $value)

Установить значение «смещения» запроса.

Параметры

целое $value

Значение возврата

$this

Builder|Builder skip(int $value)

Псевдоним для установки значения «смещения» запроса.

Параметры

целое $value

Значение возврата

Builder|Builder

$this limit(int $value)

Установить значение «лимита» запроса.

Параметры

целое $value

Значение возврата

$this

Builder|Builder take(int $value)

Псевдоним для установки значения "limit" запроса.

Параметры

int $value

Возвращаемое значение

Builder|Builder

Builder|Builder forPage(int $page, int $perPage = 15)

Устанавливает лимит и смещение для заданной страницы.

Параметры

int $page
int $perPage

Возвращаемое значение

Builder|Builder

Builder|Builder forPageAfterId(int $perPage = 15, int $lastId, string $column = 'id')

Ограничивает запрос следующей "страницей" результатов после заданного ID.

Параметры

int $perPage
int $lastId
string $column

Возвращаемое значение

Builder|Builder

Builder|Builder union(Builder|Closure $query, bool $all = false)

Добавить оператор объединения в запрос.

Параметры

Builder|Closure $query
bool $all

Возвращаемое значение

Builder|Builder

Builder|Builder unionAll(Builder|Closure $query)

Добавить оператор объединения ALL в запрос.

Параметры

Builder|Closure $query

Возвращаемое значение

Builder|Builder

$this lock(bool $value = true)

Заблокировать выбранные строки в таблице.

Параметры

bool $value

Возвращаемое значение

$this

Builder lockForUpdate()

Заблокировать выбранные строки в таблице для обновления.

Возвращаемое значение

Builder

Builder sharedLock()

Заблокировать выбранные строки в таблице с совместным доступом.

Возвращаемое значение

Builder

string toSql()

Получить SQL-представление запроса.

Возвращаемое значение

string

mixed|Builder find(int $id, array $columns = ['*'])

Выполнить запрос для одной записи по идентификатору.

Параметры

int $id
array $columns

Возвращаемое значение

mixed|Builder

mixed value(string $column)

Получить значение одного столбца из первого результата запроса.

Параметры

string $column

Возвращаемое значение

mixed

mixed|Builder first(array $columns = ['*'])

Выполнить запрос и получить первый результат.

Параметры

array $columns

Возвращаемое значение

mixed|Builder

array|Builder[] get(array $columns = ['*'])

Выполнить запрос как операцию «выбор».

Параметры

array $columns

Возвращаемое значение

array|Builder[]

protected array runSelect()

Выполнить запрос в качестве оператора «выбор» к соединению.

Возвращаемое значение

array

LengthAwarePaginator paginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int|null $page = null)

Разбить заданный запрос на страницы с помощью простого пагинатора.

Параметры

int $perPage
array $columns
string $pageName
int|null $page

Возвращаемое значение

LengthAwarePaginator

Paginator simplePaginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int|null $page = null)

Получить пагинатор, поддерживающий только простые ссылки «следующая» и «предыдущая».

Это более эффективно для больших наборов данных и т. д.

Параметры

int $perPage
array $columns
string $pageName
int|null $page

Значение возврата

Paginator

int getCountForPagination(array $columns = ['*'])

Получить количество всех записей для пагинатора.

Параметры

array $columns

Значение возврата

int

protected void backupFieldsForCount()

Создать резервную копию некоторых полей для подсчёта страниц.

Значение возврата

void

protected array clearSelectAliases(array $columns)

Удалить алиасы столбцов, так как они нарушают запросы подсчёта.

Параметры

array $columns

Значение возврата

array

protected void restoreFieldsForCount()

Восстановить некоторые поля после подсчёта страниц.

Значение возврата

void

Generator cursor()

Получить генератор для заданного запроса.

Значение возврата

Generator

bool chunk(int $count, callable $callback)

Разбить результаты запроса на части.

Параметры

int $count
callable $callback

Значение возврата

bool

bool chunkById(int $count, callable $callback, string $column = 'id', string $alias = null)

Разбить результаты запроса на части, сравнивая числовые идентификаторы.

Параметры

int $count
callable $callback
string $column
string $alias

Значение возврата

bool

bool each(callable $callback, int $count = 1000)

Выполнить обратный вызов над каждым элементом, разбивая на части.

Параметры

callable $callback
int $count

Значение возврата

bool

Исключения

RuntimeException

array pluck(string $column, string|null $key = null)

Получить массив со значениями заданного столбца.

Параметры

string $column
string|null $key

Значение результата

array

array lists(string $column, string|null $key = null) устаревший

устаревший

since версия 5.2. Используйте метод "pluck" напрямую.

Псевдоним для метода "pluck".

Параметры

string $column
string|null $key

Значение результата

array

protected string|null stripTableForPluck(string $column)

Удалить имя таблицы или псевдоним из идентификатора столбца.

Параметры

string $column

Значение результата

string|null

string implode(string $column, string $glue = '')

Склеить значения заданного столбца в строку.

Параметры

string $column
string $glue

Значение результата

string

bool exists()

Определить, существуют ли строки для текущего запроса.

Значение результата

bool

int count(string $columns = '*')

Получить результат "count" запроса.

Параметры

string $columns

Возвращаемое значение

int

mixed min(string $column)

Получить минимальное значение заданного столбца.

Параметры

string $column

Возвращаемое значение

mixed

mixed max(string $column)

Получить максимальное значение заданного столбца.

Параметры

string $column

Возвращаемое значение

mixed

mixed sum(string $column)

Получить сумму значений заданного столбца.

Параметры

string $column

Возвращаемое значение

mixed

mixed avg(string $column)

Получить среднее значение значений заданного столбца.

Параметры

string $column

Возвращаемое значение

mixed

mixed average(string $column)

Псевдоним для метода "avg".

Параметры

string $column

Возвращаемое значение

mixed

mixed aggregate(string $function, array $columns = ['*'])

Выполнить агрегационную функцию в базе данных.

Параметры

string $function
array $columns

Возвращаемое значение

mixed

float|int numericAggregate(string $function, array $columns = ['*'])

Выполнить числовую агрегационную функцию в базе данных.

Параметры

string $function
array $columns

Возвращаемое значение

float|int

bool insert(array $values)

Вставить новую запись в базу данных.

Параметры

array $values

Возвращаемое значение

bool

int insertGetId(array $values, string $sequence = null)

Вставить новую запись и получить значение первичного ключа.

Параметры

array $values
string $sequence

Возвращаемое значение

int

int update(array $values)

Обновить запись в базе данных.

Параметры

array $values

Возвращаемое значение

int

bool updateOrInsert(array $attributes, array $values = [])

Вставить или обновить запись, соответствующую атрибутам, и заполнить её значениями.

Параметры

array $attributes
array $values

Возвращаемое значение

bool

int increment(string $column, int $amount = 1, array $extra = [])

Увеличить значение столбца на заданную величину.

Параметры

string $column
int $amount
array $extra

Возвращаемое значение

int

int decrement(string $column, int $amount = 1, array $extra = [])

Уменьшить значение столбца на заданную величину.

Параметры

string $column
int $amount
array $extra

Возвращаемое значение

int

int delete(mixed $id = null)

Удалить запись из базы данных.

Параметры

mixed $id

Возвращаемое значение

int

void truncate()

Выполнить операцию truncate для таблицы.

Возвращаемое значение

void

Builder newQuery()

Получить новый экземпляр билдера запросов.

Значение возврата

Builder

void mergeWheres(array $wheres, array $bindings)

Объединить массив условий where и связывающих данных.

Параметры

array $wheres
array $bindings

Значение возврата

void

protected array cleanBindings(array $bindings)

Удалить все выражения из списка связывающих данных.

Параметры

array $bindings

Значение возврата

array

Expression raw(mixed $value)

Создать выражение для базы данных в сыром виде.

Параметры

mixed $value

Значение возврата

Expression

array getBindings()

Получить текущие связывающие данные запроса в плоском массиве.

Значение возврата

array

array getRawBindings()

Получить сырой массив связывающих данных.

Значение возврата

array

$this setBindings(array $bindings, string $type = 'where')

Установить привязки к билдеру запроса.

Параметры

массив $bindings
строка $type

Возвращаемое значение

$this

Исключения

InvalidArgumentException

$this addBinding(mixed $value, string $type = 'where')

Добавить привязку к запросу.

Параметры

смешанный тип $value
строка $type

Возвращаемое значение

$this

Исключения

InvalidArgumentException

$this mergeBindings(Builder $query)

Объединить массив привязок в наши привязки.

Параметры

Builder $query

Возвращаемое значение

$this

ConnectionInterface getConnection()

Получить экземпляр подключения к базе данных.

Возвращаемое значение

ConnectionInterface

Processor getProcessor()

Получить экземпляр процессора запросов базы данных.

Возвращаемое значение

Processor

Grammar getGrammar()

Получить экземпляр синтаксического анализатора запросов.

Возвращаемое значение

Grammar

$this useWritePdo()

Использовать pdo для записи запроса.

Возвращаемое значение

$this

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.2/Illuminate/Database/Query/Builder.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API