Spec-Zone.ru › Laravel 5.5

Строитель

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

Трейты

BuildsQueries
Macroable

Свойства

static protected array $macros Зарегистрированные строковые макросы. from Macroable
ConnectionInterface $connection Экземпляр подключения к базе данных.
Grammar $grammar Экземпляр синтаксического анализатора запросов к базе данных.
Processor $processor Экземпляр постпроцессора запросов к базе данных.
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 Указывает, используется ли блокировка строк.
array $operators Все доступные операторы предложений.
bool $useWritePdo Использовать ли write pdo для выбора.

Методы

bool chunk(int $count, callable $callback)

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

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

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

from BuildsQueries
Model|BuildsQueries|null first(array $columns = ['*'])

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

from BuildsQueries
mixed when(mixed $value, callable $callback, callable $default = null)

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

from BuildsQueries
Builder tap(Closure $callback)

Передать запрос в указанный обратный вызов.

from BuildsQueries
mixed unless(mixed $value, callable $callback, callable $default = null)

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

from BuildsQueries
LengthAwarePaginator paginator(Collection $items, int $total, int $perPage, int $currentPage, array $options)

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

from BuildsQueries
Paginator simplePaginator(Collection $items, int $perPage, int $currentPage, array $options)

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

from BuildsQueries
static void macro(string $name, object|callable $macro)

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

from Macroable
static void mixin(object $mixin)

Смешать другой объект в класс.

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 = [])

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

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

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

array parseSubSelect(mixed $query)

Разбирать подзапрос в SQL и параметры.

$this addSelect(array|mixed $column)

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

$this distinct()

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

$this from(string $table)

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

$this join(string $table, string $first, string|null $operator = null, string|null $second = null, string $type = 'inner', bool $where = false)

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

Builder|Builder joinWhere(string $table, string $first, string $operator, string $second, string $type = 'inner')

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

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

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

Builder|Builder leftJoinWhere(string $table, string $first, string $operator, string $second)

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

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

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

Builder|Builder rightJoinWhere(string $table, string $first, string $operator, string $second)

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

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

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

void mergeWheres(array $wheres, array $bindings)

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

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

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

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

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

array prepareValueAndOperator(string $value, string $operator, bool $useDefault = false)

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

bool invalidOperatorAndValue(string $operator, mixed $value)

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

bool invalidOperator(string $operator)

Определить, поддерживается ли заданный оператор.

Builder|Builder orWhere(string|array|Closure $column, string|null $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, mixed $bindings = [], string $boolean = 'and')

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

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

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

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

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

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

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

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

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

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

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

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

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

$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" к запросу.

$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')

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

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

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

Builder|Builder orWhereNotNull(string $column)

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

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

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

Builder|Builder orWhereDate(string $column, string $operator, string $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, mixed $value = null, string $boolean = 'and')

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

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

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

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

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

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

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

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

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

Builder forNestedWhere()

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

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

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

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

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

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

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

Builder|Builder илиГдеСуществует(Closure $callback, bool $not = false)

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

Builder|Builder гдеНеСуществует(Closure $callback, string $boolean = 'and')

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

Builder|Builder илиГдеНеСуществует(Closure $callback)

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

$this добавитьУсловиеСуществования(Builder $query, string $boolean = 'and', bool $not = false)

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

$this динамическоеГде(string $method, string $parameters)

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

void добавитьДинамическое(string $segment, string $connector, array $parameters, int $index)

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

$this сгруппироватьПо(array $groups)

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

$this иметь(string $column, string|null $operator = null, string|null $value = null, string $boolean = 'and')

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

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

Добавить условие "или имеющий" к запросу.

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

Добавить исходное условие "имеющий" к запросу.

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

Добавить исходное условие "или имеющий" к запросу.

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

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

$this orderByDesc(string $column)

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

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

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

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

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

$this inRandomOrder(string $seed = '')

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

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

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

Builder|Builder skip(int $value)

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

$this offset(int $value)

Устанавливает значение "offset" запроса.

Builder|Builder take(int $value)

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

$this limit(int $value)

Устанавливает значение "limit" запроса.

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

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

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

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

array removeExistingOrdersFor(string $column)

Возвращает массив со всеми заказами, у которых заданный столбец удален.

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

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

Builder|Builder unionAll(Builder|Closure $query)

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

$this lock(string|bool $value = true)

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

Builder lockForUpdate()

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

Builder sharedLock()

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

string toSql()

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

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

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

mixed value(string $column)

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

Collection get(array $columns = ['*'])

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

array 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)

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

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

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

array runPaginationCountQuery(array $columns = ['*'])

Выполнить запрос подсчёта для пагинатора.

array withoutSelectAliases(array $columns)

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

Generator cursor()

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

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

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

void enforceOrderBy()

Выбросить исключение, если в запросе нет условия orderBy.

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

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

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 = ['*'])

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

$this setAggregate(string $function, array $columns)

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

bool insert(array $values)

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

int insertGetId(array $values, string|null $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()

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

Builder forSubQuery()

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

Expression raw(mixed $value)

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

массив getBindings()

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

массив getRawBindings()

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

$this setBindings(массив $bindings, строка $type = 'where')

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

$this addBinding(смешанное $value, строка $type = 'where')

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

$this mergeBindings(Builder $query)

Объединить массив связей в наши связи.

массив cleanBindings(массив $bindings)

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

ConnectionInterface getConnection()

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

Processor getProcessor()

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

Grammar getGrammar()

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

$this useWritePdo()

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

Builder cloneWithout(массив $properties)

Клонировать запрос без заданных свойств.

Библиотека cloneWithoutBindings(array $except)

Клонировать запрос без указанных связей.

Подробности

bool chunk(int $count, callable $callback)

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

Параметры

int $count
callable $callback

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

bool

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

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

Параметры

callable $callback
int $count

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

bool

Модель|Построение запросов|null first(array $columns = ['*'])

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

Параметры

array $columns

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

Модель|Построение запросов|null

mixed when(mixed $value, callable $callback, callable $default = null)

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

Параметры

mixed $value
callable $callback
callable $default

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

mixed

Builder tap(Closure $callback)

Передать запрос в заданный обратный вызов.

Параметры

Closure $callback

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

Builder

mixed unless(mixed $value, callable $callback, callable $default = null)

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

Параметры

mixed $value
callable $callback
callable $default

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

mixed

protected LengthAwarePaginator paginator(Collection $items, int $total, int $perPage, int $currentPage, array $options)

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

Параметры

Collection $items
int $total
int $perPage
int $currentPage
array $options

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

LengthAwarePaginator

protected Paginator simplePaginator(Collection $items, int $perPage, int $currentPage, array $options)

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

Параметры

Collection $items
int $perPage
int $currentPage
array $options

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

Paginator

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

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

Параметры

string $name
object|callable $macro

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

void

static void mixin(object $mixin)

Смешать другой объект в класс.

Параметры

object $mixin

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

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 = [])

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

Параметры

string $expression
array $bindings

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

Builder|Builder

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

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

Параметры

Closure|Builder|string $query
string $as

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

Builder|Builder

Исключения

InvalidArgumentException

protected array parseSubSelect(mixed $query)

Обработать подзапрос и преобразовать его в SQL и параметры.

Параметры

mixed $query

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

array

$this addSelect(array|mixed $column)

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

Параметры

array|mixed $column

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

$this

$this distinct()

Выбрать только уникальные результаты.

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

$this

$this from(string $table)

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

Параметры

string $table

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

$this

$this join(string $table, string $first, string|null $operator = null, string|null $second = null, string $type = 'inner', bool $where = false)

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

Параметры

string $table
string $first
string|null $operator
string|null $second
string $type
bool $where

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

$this

Builder|Builder joinWhere(string $table, string $first, string $operator, string $second, string $type = 'inner')

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

Параметры

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

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

Builder|Builder

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

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

Параметры

string $table
string $first
string|null $operator
string|null $second

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

Builder|Builder

Builder|Builder leftJoinWhere(string $table, string $first, string $operator, string $second)

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

Параметры

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

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

Builder|Builder

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

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

Параметры

string $table
string $first
string|null $operator
string|null $second

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

Builder|Builder

Builder|Builder rightJoinWhere(string $table, string $first, string $operator, string $second)

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

string $table
string|null $first
string|null $operator
string|null $second

Return Value

Builder|Builder

void mergeWheres(array $wheres, array $bindings)

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

Parameters

array $wheres
array $bindings

Return Value

void

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

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

Параметры

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

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

$this

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

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

Параметры

array $column
string $boolean
string $method

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

$this

protected array prepareValueAndOperator(string $value, string $operator, bool $useDefault = false)

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

Параметры

string $value
string $operator
bool $useDefault

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

array

Исключения

InvalidArgumentException

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

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

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

Параметры

string $operator
mixed $value

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

bool

protected bool invalidOperator(string $operator)

Определить, поддерживается ли данный оператор.

Параметры

string $operator

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

bool

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

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

Параметры

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

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

Builder|Builder

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

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

Параметры

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)

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

Параметры

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

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

Builder|Builder

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

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

Параметры

string $sql
mixed $bindings
string $boolean

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

$this

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

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

Параметры

string $sql
mixed $bindings

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

Builder|Builder

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

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

Параметры

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

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

$this

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

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

Параметры

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)

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

Параметры

string $column
string $boolean
bool $not

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

$this

Builder|Builder orWhereNull(string $column)

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

Параметры

string $column

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

Builder|Builder

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

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

Параметры

string $column
string $boolean

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

Builder|Builder

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

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

Параметры

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

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

$this

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

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

Параметры

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)

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

Параметры

string $column
array $values

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

Builder|Builder

Builder|Builder orWhereNotNull(string $column)

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

Параметры

string $column

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

Builder|Builder

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

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

Параметры

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

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

Builder|Builder

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

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

Параметры

string $column
string $operator
string $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, mixed $value = null, string $boolean = 'and')

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

Параметры

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

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

Builder|Builder

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

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

Параметры

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

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

Builder|Builder

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

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

Параметры

string $column
string $operator
mixed $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

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

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

Параметры

Closure $callback
string $boolean

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

Builder|Builder

Builder дляВложенногоУсловий()

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

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

Builder

$this добавитьВложенныйЗапрос(Builder|Builder $query, string $boolean = 'and')

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

Параметры

Builder|Builder $query
string $boolean

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

$this

protected $this условиеПодзапрос(string $column, string $operator, Closure $callback, string $boolean)

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

Параметры

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

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

$this

$this условиеСуществования(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)

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

Параметры

Builder $query
string $boolean
bool $not

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

$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(array $groups)

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

Параметры

array $groups

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

$this

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

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

Параметры

string $column
string|null $operator
string|null $value
string $boolean

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

$this

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

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

Параметры

string $column
string|null $operator
string|null $value

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

Builder|Builder

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

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

Параметры

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

$this orderByDesc(string $column)

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

Параметры

string $column

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

$this

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

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

Параметры

string $column

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

Builder|Builder

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

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

Параметры

строка $column

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

Builder|Builder

$this inRandomOrder(string $seed = '')

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

Параметры

строка $seed

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

$this

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

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

Параметры

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

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

$this

Builder|Builder skip(int $value)

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

Параметры

целое $value

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

Builder|Builder

$this offset(int $value)

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

Параметры

int $value

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

$this

Builder|Builder take(int $value)

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

Параметры

int $value

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

Builder|Builder

$this limit(int $value)

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

Параметры

int $value

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

$this

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

protected array removeExistingOrdersFor(string $column)

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

Параметры

string $column

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

array

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

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

Параметры

Builder|Closure $query
bool $all

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

Builder|Builder

Builder|Builder unionAll(Builder|Closure $query)

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

Параметры

Builder|Closure $query

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

Builder|Builder

$this lock(string|bool $value = true)

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

Параметры

string|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

Коллекция get(array $columns = ['*'])

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

Параметры

array $columns

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

Коллекция

protected array runSelect()

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

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

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 array runPaginationCountQuery(array $columns = ['*'])

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

Параметры

array $columns

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

array

protected array withoutSelectAliases(array $columns)

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

Параметры

array $columns

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

array

Generator cursor()

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

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

Generator

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

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

Параметры

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

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

bool

protected void enforceOrderBy()

Выбросить исключение, если в запросе нет условия orderBy.

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

void

Исключения

RuntimeException

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

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

Параметры

string $column
string|null $key

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

Collection

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

protected $this setAggregate(string $function, array $columns)

Установить свойство агрегирования без выполнения запроса.

Параметры

string $function
array $columns

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

$this

bool insert(array $values)

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

Параметры

array $values

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

bool

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

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

Параметры

array $values
string|null $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

protected Builder forSubQuery()

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

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

Builder

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

protected array cleanBindings(array $bindings)

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

Параметры

массив $bindings

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

массив

ConnectionInterface getConnection()

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

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

ConnectionInterface

Processor getProcessor()

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

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

Processor

Grammar getGrammar()

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

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

Grammar

$this useWritePdo()

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

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

$this

Builder cloneWithout(array $properties)

Клонировать запрос без указанных свойств.

Параметры

array $properties

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

Builder

Builder cloneWithoutBindings(array $except)

Клонировать запрос без указанных связей.

Параметры

массив $except

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

Builder

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

Spec-Zone.ru

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