Spec-Zone.ru › Laravel 10

JoinClause

class JoinClause extends Builder (View source)

Свойства

BuildsQueries
ExplainsQueries
ForwardsCalls
Macroable
Conditionable

Свойства

static protected array $macros

Зарегистрированные строковые макросы.

из Macroable
ConnectionInterface $connection

Экземпляр подключения к базе данных.

из Builder
Grammar $grammar

Экземпляр синтаксического анализатора запросов к базе данных.

из Builder
Processor $processor

Экземпляр постпроцессора запросов к базе данных.

из Builder
array $bindings

Текущие значения связываемых переменных запроса.

из Builder
array $aggregate

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

из Builder
array|null $columns

Столбцы, которые должны быть возвращены.

из Builder
bool|array $distinct

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

из Builder
Expression|string $from

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

из Builder
IndexHint $indexHint

Подсказка индекса для запроса.

из Builder
array $joins

Соединения таблиц для запроса.

из Builder
array $wheres

Условия WHERE для запроса.

из Builder
array $groups

Группировки для запроса.

из Builder
array $havings

Условия HAVING для запроса.

из Builder
array $orders

Сортировки для запроса.

из Builder
int $limit

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

из Builder
int $offset

Количество записей для пропуска.

из Builder
array $unions

Объединяющие операторы запроса.

из Builder
int $unionLimit

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

из Builder
int $unionOffset

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

из Builder
массив $unionOrders

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

из Builder
строка|булево $lock

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

из Builder
массив $beforeQueryCallbacks

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

из Builder
массив строк $operators

Все доступные операторы для условия.

из Builder
массив строк $bitwiseOperators

Все доступные побитовые операторы.

из Builder
булево $useWritePdo

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

из Builder
строка $type

Тип выполняемого соединения.

строка $table

Таблица, к которой подключается условие соединения.

защищённый ConnectionInterface $parentConnection

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

защищённый Grammar $parentGrammar

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

защищённый Processor $parentProcessor

Обработчик родительского билдера запросов.

защищённый строка $parentClass

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

Методы

$this|TWhenReturnType when($value = null, callable $callback = null, callable $default = null)

Примените обратный вызов, если заданное «значение» истинно (или разрешается до истинного).

из Conditionable
$this|TUnlessReturnType unless($value = null, callable $callback = null, callable $default = null)

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

из Conditionable
bool chunk(int $count, callable $callback)

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

из BuildsQueries
Collection chunkMap(callable $callback, int $count = 1000)

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

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

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

из BuildsQueries
bool chunkById(int $count, callable $callback, string|null $column = null, string|null $alias = null)

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

из BuildsQueries
bool chunkByIdDesc(int $count, callable $callback, string|null $column = null, string|null $alias = null)

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

из BuildsQueries
bool orderedChunkById(int $count, callable $callback, string|null $column = null, string|null $alias = null, bool $descending = false)

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

из BuildsQueries
bool eachById(callable $callback, int $count = 1000, string|null $column = null, string|null $alias = null)

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

из BuildsQueries
LazyCollection lazy(int $chunkSize = 1000)

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

из BuildsQueries
LazyCollection lazyById(int $chunkSize = 1000, string|null $column = null, string|null $alias = null)

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

из BuildsQueries
LazyCollection lazyByIdDesc(int $chunkSize = 1000, string|null $column = null, string|null $alias = null)

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

из BuildsQueries
LazyCollection orderedLazyById(int $chunkSize = 1000, string|null $column = null, string|null $alias = null, bool $descending = false)

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

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

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

from BuildsQueries
Model|object|BuildsQueries|null sole(array|string $columns = ['*'])

Выполняет запрос и возвращает первый результат, если это единственная соответствующая запись.

from BuildsQueries
CursorPaginator paginateUsingCursor(int $perPage, array|string $columns = ['*'], string $cursorName = 'cursor', Cursor|string|null $cursor = null)

Выполняет пагинацию запроса с помощью пагинатора курсора.

from BuildsQueries
string getOriginalColumnNameForCursorPagination(Builder|Builder $builder, string $parameter)

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

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
CursorPaginator cursorPaginator(Collection $items, int $perPage, Cursor $cursor, array $options)

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

from BuildsQueries
$this tap(callable $callback)

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

from BuildsQueries
Collection explain()

Объясняет запрос.

from ExplainsQueries
mixed forwardCallTo(mixed $object, string $method, array $parameters)

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

из ForwardsCalls
mixed forwardDecoratedCallTo(mixed $object, string $method, array $parameters)

Переадресовать вызов метода заданному объекту, вернув $this, если переадресованный вызов вернул себя.

из ForwardsCalls
static void throwBadMethodCallException(string $method)

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

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

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

из Macroable
static void mixin(object $mixin, bool $replace = true)

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

из Macroable
static bool hasMacro(string $name)

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

из Macroable
static void flushMacros()

Очистить существующие макросы.

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

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

из Macroable
mixed __call(string $method, array $parameters)

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

из Macroable
void __construct(Builder $parentQuery, string $type, string $table)

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

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

Установить столбцы, которые нужно выбрать.

из Builder
$this selectSub(Closure|Builder|Builder|string $query, string $as)

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

из Builder
$this selectRaw(string $expression, array $bindings = [])

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

из Builder
$this fromSub(Closure|Builder|Builder|string $query, string $as)

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

из Builder
$this fromRaw(string $expression, mixed $bindings = [])

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

from Builder
array createSub(Closure|Builder|Builder|string $query)

Создаёт подзапрос и анализирует его.

from Builder
array parseSub(mixed $query)

Анализирует подзапрос в SQL и параметры.

from Builder
mixed prependDatabaseNameIfCrossDatabaseQuery(mixed $query)

Добавляет имя базы данных, если запрос обращается к другой базе данных.

from Builder
$this addSelect(array|mixed $column)

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

from Builder
$this distinct()

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

from Builder
$this from(Closure|Builder|Builder|string $table, string|null $as = null)

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

from Builder
$this useIndex(string $index)

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

from Builder
$this forceIndex(string $index)

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

from Builder
$this ignoreIndex(string $index)

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

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

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

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

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

from Builder
$this joinSub(Closure|Builder|Builder|string $query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null, string $type = 'inner', bool $where = false)

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

из Builder
$this joinLateral(Closure|Builder|Builder|string $query, string $as, string $type = 'inner')

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

из Builder
$this leftJoinLateral(Closure|Builder|Builder|string $query, string $as)

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

из Builder
$this leftJoin(Expression|string $table, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)

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

из Builder
$this leftJoinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string|null $second)

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

из Builder
$this leftJoinSub(Closure|Builder|Builder|string $query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)

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

из Builder
$this rightJoin(Expression|string $table, Closure|string $first, string|null $operator = null, Expression|string|null $second = null)

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

из Builder
$this rightJoinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string $second)

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

из Builder
$this rightJoinSub(Closure|Builder|Builder|string $query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)

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

из Builder
$this crossJoin(Expression|string $table, Closure|Expression|string|null $first = null, string|null $operator = null, Expression|string|null $second = null)

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

из Builder
$this crossJoinSub(Closure|Builder|Builder|string $query, string $as)

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

из Builder
JoinClause newJoinClause(Builder $parentQuery, string $type, string $table)

Получить новую инструкцию объединения.

из Builder
JoinLateralClause newJoinLateralClause(Builder $parentQuery, string $type, string $table)

Получить новую инструкцию объединения с LATERAL.

из Builder
$this mergeWheres(array $wheres, array $bindings)

Объединить массив условий WHERE и привязанных значений.

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

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

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

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

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

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

from Builder
bool invalidOperatorAndValue(string $operator, mixed $value)

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

from Builder
bool invalidOperator(string $operator)

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

from Builder
bool isBitwiseOperator(string $operator)

Определить, является ли оператор битовым оператором.

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

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

from Builder
$this whereNot(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null, string $boolean = 'and')

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

from Builder
$this orWhereNot(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null)

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

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

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

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

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

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

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

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

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

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

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

from Builder
$this orWhereIn(Expression|string $column, mixed $values)

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

из Builder
$this whereNotIn(Expression|string $column, mixed $values, string $boolean = 'and')

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

из Builder
$this orWhereNotIn(Expression|string $column, mixed $values)

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

из Builder
$this whereIntegerInRaw(string $column, Arrayable|array $values, string $boolean = 'and', bool $not = false)

Добавить условие «где в (сырое)» для целочисленных значений в запрос.

из Builder
$this orWhereIntegerInRaw(string $column, Arrayable|array $values)

Добавить условие «или где в (сырое)» для целочисленных значений в запрос.

из Builder
$this whereIntegerNotInRaw(string $column, Arrayable|array $values, string $boolean = 'and')

Добавить условие «где не в (сырое)» для целочисленных значений в запрос.

из Builder
$this orWhereIntegerNotInRaw(string $column, Arrayable|array $values)

Добавить условие «или где не в (сырое)» для целочисленных значений в запрос.

из Builder
$this whereNull(string|array|Expression $columns, string $boolean = 'and', bool $not = false)

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

из Builder
$this orWhereNull(string|array|Expression $column)

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

из Builder
$this whereNotNull(string|array|Expression $columns, string $boolean = 'and')

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

из Builder
$this whereBetween(Expression|string $column, iterable $values, string $boolean = 'and', bool $not = false)

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

из Builder
$this whereBetweenColumns(Expression|string $column, array $values, string $boolean = 'and', bool $not = false)

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

из Builder
$this orWhereBetween(Expression|string $column, iterable $values)

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

из Builder
$this orWhereBetweenColumns(Expression|string $column, array $values)

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

из Builder
$this whereNotBetween(Expression|string $column, iterable $values, string $boolean = 'and')

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

из Builder
$this whereNotBetweenColumns(Expression|string $column, array $values, string $boolean = 'and')

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

из Builder
$this orWhereNotBetween(Expression|string $column, iterable $values)

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

из Builder
$this orWhereNotNull(Expression|string $column)

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

из Builder
$this whereDate(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')

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

из Builder
$this orWhereDate(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null)

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

из Builder
$this whereTime(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')

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

из Builder
$this orWhereTime(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null)

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

из Builder
$this whereDay(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')

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

из Builder
$this orWhereDay(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)

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

из Builder
$this whereMonth(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')

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

из Builder
$this orWhereMonth(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)

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

из Builder
$this whereYear(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')

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

из Builder
$this orWhereYear(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)

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

из Builder
$this addDateBasedWhere(string $type, Expression|string $column, string $operator, mixed $value, string $boolean = 'and')

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

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

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

from Builder
Builder forNestedWhere()

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

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

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

from Builder
$this whereSub(Expression|string $column, string $operator, Closure|Builder|Builder $callback, string $boolean)

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

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

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

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

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

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

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

from Builder
$this orWhereNotExists(Closure|Builder|Builder $callback)

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

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

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

from Builder
$this whereRowValues(array $columns, string $operator, array $values, string $boolean = 'and')

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

from Builder
$this orWhereRowValues(array $columns, string $operator, array $values)

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

из Builder
$this whereJsonContains(string $column, mixed $value, string $boolean = 'and', bool $not = false)

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

из Builder
$this orWhereJsonContains(string $column, mixed $value)

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

из Builder
$this whereJsonDoesntContain(string $column, mixed $value, string $boolean = 'and')

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

из Builder
$this orWhereJsonDoesntContain(string $column, mixed $value)

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

из Builder
$this whereJsonContainsKey(string $column, string $boolean = 'and', bool $not = false)

Добавляет условие, определяющее существование JSON-пути в запросе.

из Builder
$this orWhereJsonContainsKey(string $column)

Добавляет условие «или», определяющее существование JSON-пути в запросе.

из Builder
$this whereJsonDoesntContainKey(string $column, string $boolean = 'and')

Добавляет условие, определяющее отсутствие JSON-пути в запросе.

из Builder
$this orWhereJsonDoesntContainKey(string $column)

Добавляет условие «или», определяющее отсутствие JSON-пути в запросе.

из Builder
$this whereJsonLength(string $column, mixed $operator, mixed $value = null, string $boolean = 'and')

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

из Builder
$this orWhereJsonLength(string $column, mixed $operator, mixed $value = null)

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

из Builder
$this dynamicWhere(string $method, array $parameters)

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

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

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

из Builder
$this whereFullText(string|string[] $columns, string $value, array $options = [], string $boolean = 'and')

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

из Builder
$this orWhereFullText(string|string[] $columns, string $value, array $options = [])

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

из Builder
$this whereAll(string[] $columns, mixed $operator = null, mixed $value = null, string $boolean = 'and')

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

из Builder
$this orWhereAll(string[] $columns, string $operator = null, mixed $value = null)

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

из Builder
$this whereAny(string[] $columns, string $operator = null, mixed $value = null, string $boolean = 'and')

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

из Builder
$this orWhereAny(string[] $columns, string $operator = null, mixed $value = null)

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

из Builder
$this groupBy(array|Expression|string ...$groups)

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

из Builder
$this groupByRaw(string $sql, array $bindings = [])

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

из Builder
$this having(Expression|Closure|string $column, string|int|float|null $operator = null, string|int|float|null $value = null, string $boolean = 'and')

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

из Builder
$this orHaving(Expression|Closure|string $column, string|int|float|null $operator = null, string|int|float|null $value = null)

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

из Builder
$this havingNested(Closure $callback, string $boolean = 'and')

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

из Builder
$this addNestedHavingQuery(Builder $query, string $boolean = 'and')

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

из Builder
$this havingNull(string|array $columns, string $boolean = 'and', bool $not = false)

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

из Builder
$this orHavingNull(string $column)

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

из Builder
$this havingNotNull(string|array $columns, string $boolean = 'and')

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

из Builder
$this orHavingNotNull(string $column)

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

из Builder
$this havingBetween(string $column, iterable $values, string $boolean = 'and', bool $not = false)

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

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

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

из Builder
$this orHavingRaw(string $sql, array $bindings = [])

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

из Builder
$this orderBy(Closure|Builder|Builder|Expression|string $column, string $direction = 'asc')

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

из Builder
$this orderByDesc(Closure|Builder|Builder|Expression|string $column)

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

из Builder
$this latest(Closure|Builder|Expression|string $column = 'created_at')

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

из Builder
$this oldest(Closure|Builder|Expression|string $column = 'created_at')

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

из Builder
$this inRandomOrder(string|int $seed = '')

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

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

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

из Builder
$this skip(int $value)

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

из Builder
$this offset(int $value)

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

из Builder
$this take(int $value)

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

from Builder
$this limit(int $value)

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

from Builder
$this forPage(int $page, int $perPage = 15)

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

from Builder
$this forPageBeforeId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')

Ограничивает запрос предыдущей «страницей» результатов перед заданным идентификатором.

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

Ограничивает запрос следующей «страницей» результатов после заданного идентификатора.

from Builder
$this reorder(Closure|Builder|Expression|string|null $column = null, string $direction = 'asc')

Удаляет все существующие упорядочения и при необходимости добавляет новое упорядочение.

from Builder
array removeExistingOrdersFor(string $column)

Возвращает массив со всеми удаленными упорядочениями для заданного столбца.

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

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

from Builder
$this unionAll(Closure|Builder|Builder $query)

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

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

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

from Builder
$this lockForUpdate()

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

from Builder
$this sharedLock()

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

from Builder
$this beforeQuery(callable $callback)

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

from Builder
void applyBeforeQueryCallbacks()

Вызывает обратные вызовы модификации «перед запросом».

from Builder
string toSql()

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

из Builder
string toRawSql()

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

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

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

из Builder
mixed|Builder findOr(mixed $id, Closure|array|string $columns = ['*'], Closure $callback = null)

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

из Builder
mixed value(string $column)

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

из Builder
mixed rawValue(string $expression, array $bindings = [])

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

из Builder
mixed soleValue(string $column)

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

из Builder
Collection get(array|string $columns = ['*'])

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

из Builder
array runSelect()

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

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

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

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

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

из Builder
CursorPaginator cursorPaginate(int|null $perPage = 15, array|string $columns = ['*'], string $cursorName = 'cursor', Cursor|string|null $cursor = null)

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

из Builder
Коллекция ensureOrderForCursorPagination(bool $shouldReverse = false)

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

из Построителя
int getCountForPagination(array $columns = ['*'])

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

из Построителя
массив runPaginationCountQuery(array $columns = ['*'])

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

из Построителя
Построитель cloneForPaginationCount()

Создать копию существующего объекта запроса для использования во вспомогательном запросе для постраничной навигации.

из Построителя
массив withoutSelectAliases(array $columns)

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

из Построителя
Ленивая коллекция cursor()

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

из Построителя
void enforceOrderBy()

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

из Построителя
Коллекция pluck(Выражение|string $column, string|null $key = null)

Получить экземпляр коллекции, содержащий значения заданного столбца.

из Построителя
строка|null stripTableForPluck(string $column)

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

из Построителя
Коллекция pluckFromObjectColumn(array $queryResult, string $column, string $key)

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

из Построителя
Коллекция pluckFromArrayColumn(array $queryResult, string $column, string $key)

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

из Построителя
строка implode(string $column, string $glue = '')

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

из Построителя
bool exists()

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

из Построителя
bool doesntExist()

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

из Построителя
mixed existsOr(Closure $callback)

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

from Builder
mixed doesntExistOr(Closure $callback)

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

from Builder
int count(Expression|string $columns = '*')

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

from Builder
mixed min(Expression|string $column)

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

from Builder
mixed max(Expression|string $column)

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

from Builder
mixed sum(Expression|string $column)

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

from Builder
mixed avg(Expression|string $column)

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

from Builder
mixed average(Expression|string $column)

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

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

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

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

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

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

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

from Builder
mixed onceWithColumns(array $columns, callable $callback)

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

from Builder
bool insert(array $values)

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

from Builder
int insertOrIgnore(array $values)

Вставить новые записи в базу данных, игнорируя ошибки.

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

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

from Builder
int insertUsing(array $columns, Closure|Builder|Builder|string $query)

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

from Builder
int insertOrIgnoreUsing(array $columns, Closure|Builder|Builder|string $query)

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

from Builder
int update(array $values)

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

from Builder
int updateFrom(array $values)

Обновить записи в базе данных PostgreSQL с использованием синтаксиса update from.

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

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

from Builder
int upsert(array $values, array|string $uniqueBy, array|null $update = null)

Вставить новые записи или обновить существующие.

from Builder
int increment(string $column, float|int $amount = 1, array $extra = [])

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

from Builder
int incrementEach(array $columns, array $extra = [])

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

from Builder
int decrement(string $column, float|int $amount = 1, array $extra = [])

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

from Builder
int decrementEach(array $columns, array $extra = [])

Уменьшить значения заданных столбцов на заданные количества.

from Builder
int delete(mixed $id = null)

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

from Builder
void truncate()

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

from Builder
Builder newQuery()

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

Builder forSubQuery()

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

массив getColumns()

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

из Builder
Expression raw(mixed $value)

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

из Builder
Коллекция getUnionBuilders()

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

из Builder
массив getBindings()

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

из Builder
массив getRawBindings()

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

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

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

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

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

из Builder
mixed castBinding(mixed $value)

Преобразовать заданное значение привязки.

из Builder
$this mergeBindings(Builder $query)

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

из Builder
массив cleanBindings(array $bindings)

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

из Builder
mixed flattenValue(mixed $value)

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

из Builder
строка defaultKeyName()

Получить имя ключа по умолчанию для таблицы.

из Builder
ConnectionInterface getConnection()

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

из Builder
Processor getProcessor()

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

из Builder
Grammar getGrammar()

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

из Builder
$this useWritePdo()

Используйте подключение "write" PDO при выполнении запроса.

из Builder
bool isQueryable(mixed $value)

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

из Builder
Builder clone()

Клонировать запрос.

из Builder
Builder cloneWithout(array $properties)

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

из Builder
Builder cloneWithoutBindings(array $except)

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

из Builder
$this dump()

Вывести текущий SQL и связывающие данные.

из Builder
$this dumpRawSql()

Вывести текущий SQL в сыром виде с внедренными связывающими данными.

из Builder
never dd()

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

из Builder
never ddRawSql()

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

из Builder
$this on(Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null, string $boolean = 'and')

Добавить условие "on" к соединению.

JoinClause orOn(Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)

Добавить условие "или на" к соединению.

Builder newParentQuery()

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

Details

$this|TWhenReturnType when($value = null, callable $callback = null, callable $default = null)

Применить обратный вызов, если данное "значение" истинно (или разрешается в истинное).

Parameters

$value
callable $callback
callable $default

Return Value

$this|TWhenReturnType

$this|TUnlessReturnType unless($value = null, callable $callback = null, callable $default = null)

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

Параметры

$value
callable $callback
callable $default

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

$this|TUnlessReturnType

bool chunk(int $count, callable $callback)

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

Параметры

int $count
callable $callback

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

bool

Collection chunkMap(callable $callback, int $count = 1000)

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

Параметры

callable $callback
int $count

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

Collection

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

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

Параметры

callable $callback
int $count

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

bool

Исключения

RuntimeException

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

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

Параметры

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

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

bool

bool chunkByIdDesc(int $count, callable $callback, string|null $column = null, string|null $alias = null)

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

Параметры

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

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

bool

bool orderedChunkById(int $count, callable $callback, string|null $column = null, string|null $alias = null, bool $descending = false)

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

Параметры

int $count
callable $callback
string|null $column
string|null $alias
bool $descending

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

bool

bool eachById(callable $callback, int $count = 1000, string|null $column = null, string|null $alias = null)

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

Параметры

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

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

bool

LazyCollection lazy(int $chunkSize = 1000)

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

Параметры

int $chunkSize

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

LazyCollection

Исключения

InvalidArgumentException

LazyCollection lazyById(int $chunkSize = 1000, string|null $column = null, string|null $alias = null)

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

Параметры

int $chunkSize
string|null $column
string|null $alias

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

LazyCollection

Исключения

InvalidArgumentException

LazyCollection lazyByIdDesc(int $chunkSize = 1000, string|null $column = null, string|null $alias = null)

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

Параметры

int $chunkSize
string|null $column
string|null $alias

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

LazyCollection

Исключения

InvalidArgumentException

protected LazyCollection orderedLazyById(int $chunkSize = 1000, string|null $column = null, string|null $alias = null, bool $descending = false)

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

Параметры

int $chunkSize
string|null $column
string|null $alias
bool $descending

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

LazyCollection

Исключения

InvalidArgumentException

Модель|object|BuildsQueries|null first(array|string $columns = ['*'])

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

Параметры

array|string $columns

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

Модель|object|BuildsQueries|null

Модель|объект|BuildsQueries|null sole(array|string $columns = ['*'])

Выполнить запрос и получить первый результат, если это единственная соответствующая запись.

Параметры

array|string $columns

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

Модель|объект|BuildsQueries|null

Исключения

RecordsNotFoundException
MultipleRecordsFoundException

protected CursorPaginator paginateUsingCursor(int $perPage, array|string $columns = ['*'], string $cursorName = 'cursor', Cursor|string|null $cursor = null)

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

Параметры

int $perPage
array|string $columns
string $cursorName
Cursor|string|null $cursor

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

CursorPaginator

protected string getOriginalColumnNameForCursorPagination(Builder|Builder $builder, string $parameter)

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

Параметры

Builder|Builder $builder
string $parameter

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

string

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

protected CursorPaginator cursorPaginator(Collection $items, int $perPage, Cursor $cursor, array $options)

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

Parameters

Collection $items
int $perPage
Cursor $cursor
array $options

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

CursorPaginator

$this tap(callable $callback)

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

Parameters

callable $callback

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

$this

Collection explain()

Объяснить запрос.

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

Collection

protected mixed forwardCallTo(mixed $object, string $method, array $parameters)

Перенаправить вызов метода к заданному объекту.

Parameters

mixed $object
string $method
array $parameters

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

mixed

Исключения

BadMethodCallException

protected mixed forwardDecoratedCallTo(mixed $object, string $method, array $parameters)

Перенаправить вызов метода к заданному объекту, вернув $this, если перенаправленный вызов вернул себя.

Parameters

mixed $object
string $method
array $parameters

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

mixed

Исключения

BadMethodCallException

static protected void throwBadMethodCallException(string $method)

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

Parameters

string $method

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

void

Исключения

BadMethodCallException

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

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

Parameters

string $name
object|callable $macro

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

void

статический void mixin(object $mixin, bool $replace = true)

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

Параметры

object $mixin
bool $replace

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

void

Исключения

ReflectionException

статический bool hasMacro(string $name)

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

Параметры

string $name

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

bool

статический void flushMacros()

Очистить существующие макросы.

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

void

статический 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(Builder $parentQuery, string $type, string $table)

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

Параметры

Builder $parentQuery
string $type
string $table

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

void

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

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

Параметры

array|mixed $columns

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

$this

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

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

Параметры

Closure|Builder|Builder|string $query
string $as

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

$this

Исключения

InvalidArgumentException

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

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

Параметры

string $expression
array $bindings

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

$this

$this fromSub(Closure|Builder|Builder|string $query, string $as)

Выполнить выборку "from" из подзапроса.

Параметры

Closure|Builder|Builder|string $query
string $as

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

$this

Исключения

InvalidArgumentException

$this fromRaw(string $expression, mixed $bindings = [])

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

Параметры

string $expression
mixed $bindings

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

$this

protected array createSub(Closure|Builder|Builder|string $query)

Создаёт подзапрос и анализирует его.

Параметры

Closure|Builder|Builder|string $query

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

array

protected array parseSub(mixed $query)

Анализирует подзапрос, преобразуя его в SQL и параметры.

Параметры

mixed $query

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

array

Исключения

InvalidArgumentException

protected mixed prependDatabaseNameIfCrossDatabaseQuery(mixed $query)

Добавляет имя базы данных, если запрос относится к другой базе.

Параметры

mixed $query

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

mixed

$this addSelect(array|mixed $column)

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

Параметры

array|mixed $column

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

$this

$this distinct()

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

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

$this

$this from(Closure|Builder|Builder|string $table, string|null $as = null)

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

Параметры

Closure|Builder|Builder|string $table
string|null $as

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

$this

$this useIndex(string $index)

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

Параметры

string $index

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

$this

$this forceIndex(string $index)

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

Параметры

string $index

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

$this

$this ignoreIndex(string $index)

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

Параметры

string $index

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

$this

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

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

Параметры

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

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

$this

$this joinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string $second, string $type = 'inner')

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

Параметры

Expression|string $table
Closure|Expression|string $first
string $operator
Expression|string $second
string $type

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

$this

$this joinSub(Closure|Builder|Builder|string $query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null, string $type = 'inner', bool $where = false)

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

Параметры

Closure|Builder|Builder|string $query
string $as
Closure|Expression|string $first
string|null $operator
Expression|string|null $second
string $type
bool $where

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

$this

Исключения

InvalidArgumentException

$this joinLateral(Closure|Builder|Builder|string $query, string $as, string $type = 'inner')

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

Параметры

Closure|Builder|Builder|string $query
string $as
string $type

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

$this

$this leftJoinLateral(Closure|Builder|Builder|string $query, string $as)

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

Параметры

Closure|Builder|Builder|string $query
string $as

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

$this

$this leftJoin(Expression|string $table, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)

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

Параметры

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

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

$this

$this leftJoinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string|null $second)

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

Параметры

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

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

$this

$this leftJoinSub(Closure|Builder|Builder|string $query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)

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

Параметры

Closure|Builder|Builder|string $query
string $as
Closure|Expression|string $first
string|null $operator
Expression|string|null $second

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

$this

$this rightJoin(Expression|string $table, Closure|string $first, string|null $operator = null, Expression|string|null $second = null)

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

Параметры

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

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

$this

$this rightJoinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string $second)

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

Параметры

Expression|string $table
Closure|Expression|string $first
string $operator
Expression|string $second

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

$this

$this rightJoinSub(Closure|Builder|Builder|string $query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)

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

Параметры

Closure|Builder|Builder|string $query
string $as
Closure|Expression|string $first
string|null $operator
Expression|string|null $second

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

$this

$this crossJoin(Expression|string $table, Closure|Expression|string|null $first = null, string|null $operator = null, Expression|string|null $second = null)

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

Параметры

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

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

$this

$this crossJoinSub(Closure|Builder|Builder|string $query, string $as)

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

Параметры

Closure|Builder|Builder|string $query
string $as

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

$this

protected JoinClause newJoinClause(Builder $parentQuery, string $type, string $table)

Получить новую фразу соединения.

Параметры

Builder $parentQuery
string $type
string $table

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

JoinClause

protected JoinLateralClause newJoinLateralClause(Builder $parentQuery, string $type, string $table)

Получить новый фрагмент условия соединения LATERAL.

Parameters

Builder $parentQuery
string $type
string $table

Return Value

JoinLateralClause

$this mergeWheres(array $wheres, array $bindings)

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

Parameters

array $wheres
array $bindings

Return Value

$this

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

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

Parameters

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

Return Value

$this

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

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

Parameters

array $column
string $boolean
string $method

Return Value

$this

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

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

Parameters

string $value
string $operator
bool $useDefault

Return Value

array

Exceptions

InvalidArgumentException

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

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

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

Parameters

string $operator
mixed $value

Return Value

bool

protected bool invalidOperator(string $operator)

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

Parameters

string $operator

Return Value

bool

protected bool isBitwiseOperator(string $operator)

Определить, является ли оператор битовым оператором.

Parameters

string $operator

Return Value

bool

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

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

Parameters

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

Return Value

$this

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

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

Parameters

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

Return Value

$this

$this orWhereNot(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null)

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

Parameters

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

Return Value

$this

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

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

Parameters

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

Return Value

$this

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

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

Parameters

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

Return Value

$this

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

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

Параметры

string $sql
mixed $bindings
string $boolean

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

$this

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

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

Параметры

string $sql
mixed $bindings

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

$this

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

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

Параметры

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

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

$this

$this orWhereIn(Expression|string $column, mixed $values)

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

Параметры

Expression|string $column
mixed $values

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

$this

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

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

Параметры

Expression|string $column
mixed $values
string $boolean

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

$this

$this orWhereNotIn(Expression|string $column, mixed $values)

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

Параметры

Expression|string $column
mixed $values

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

$this

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

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

Параметры

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

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

$this

$this orWhereIntegerInRaw(string $column, Arrayable|array $values)

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

Параметры

string $column
Arrayable|array $values

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

$this

$this whereIntegerNotInRaw(string $column, Arrayable|array $values, string $boolean = 'and')

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

Параметры

string $column
Arrayable|array $values
string $boolean

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

$this

$this orWhereIntegerNotInRaw(string $column, Arrayable|array $values)

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

Параметры

string $column
Arrayable|array $values

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

$this

$this whereNull(string|array|Expression $columns, string $boolean = 'and', bool $not = false)

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

Параметры

string|array|Expression $columns
string $boolean
bool $not

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

$this

$this orWhereNull(string|array|Expression $column)

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

Параметры

string|array|Expression $column

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

$this

$this whereNotNull(string|array|Expression $columns, string $boolean = 'and')

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

Параметры

string|array|Expression $columns
string $boolean

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

$this

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

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

Параметры

Expression|string $column
iterable $values
string $boolean
bool $not

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

$this

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

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

Параметры

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

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

$this

$this orWhereBetween(Expression|string $column, iterable $values)

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

Параметры

Expression|string $column
iterable $values

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

$this

$this orWhereBetweenColumns(Expression|string $column, array $values)

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

Параметры

Expression|string $column
array $values

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

$this

$this whereNotBetween(Expression|string $column, iterable $values, string $boolean = 'and')

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

Параметры

Expression|string $column
iterable $values
string $boolean

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

$this

$this whereNotBetweenColumns(Expression|string $column, array $values, string $boolean = 'and')

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

Параметры

Expression|string $column
array $values
string $boolean

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

$this

$this orWhereNotBetween(Expression|string $column, iterable $values)

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

Параметры

Expression|string $column
iterable $values

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

$this

$this orWhereNotBetweenColumns(Expression|string $column, array $values)

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

Параметры

Expression|string $column
array $values

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

$this

$this orWhereNotNull(Expression|string $column)

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

Параметры

Expression|string $column

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

$this

$this whereDate(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')

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

Параметры

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

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

$this

$this orWhereDate(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null)

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

Параметры

Expression|string $column
DateTimeInterface|string|null $operator
DateTimeInterface|string|null $value

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

$this

$this whereTime(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')

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

Параметры

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

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

$this

$this orWhereTime(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null)

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

Параметры

Expression|string $column
DateTimeInterface|string|null $operator
DateTimeInterface|string|null $value

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

$this

$this whereDay(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')

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

Параметры

Expression|string $column
DateTimeInterface|string|int|null $operator
DateTimeInterface|string|int|null $value
string $boolean

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

$this

$this orWhereDay(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)

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

Параметры

Expression|string $column
DateTimeInterface|string|int|null $operator
DateTimeInterface|string|int|null $value

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

$this

$this whereMonth(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')

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

Параметры

Expression|string $column
DateTimeInterface|string|int|null $operator
DateTimeInterface|string|int|null $value
string $boolean

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

$this

$this orWhereMonth(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)

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

Параметры

Expression|string $column
DateTimeInterface|string|int|null $operator
DateTimeInterface|string|int|null $value

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

$this

$this whereYear(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')

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

Параметры

Expression|string $column
DateTimeInterface|string|int|null $operator
DateTimeInterface|string|int|null $value
string $boolean

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

$this

$this orWhereYear(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)

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

Параметры

Expression|string $column
DateTimeInterface|string|int|null $operator
DateTimeInterface|string|int|null $value

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

$this

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

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

Параметры

string $type
Expression|string $column
string $operator
mixed $value
string $boolean

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

$this

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

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

Параметры

Closure $callback
string $boolean

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

$this

Builder forNestedWhere()

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

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

Builder

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

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

Параметры

Builder $query
string $boolean

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

$this

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

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

Параметры

Expression|string $column
string $operator
Closure|Builder|Builder $callback
string $boolean

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

$this

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

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

Параметры

Closure|Builder|Builder $callback
string $boolean
bool $not

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

$this

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

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

Параметры

Closure|Builder|Builder $callback
bool $not

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

$this

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

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

Параметры

Closure|Builder|Builder $callback
string $boolean

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

$this

$this orWhereNotExists(Closure|Builder|Builder $callback)

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

Параметры

Closure|Builder|Builder $callback

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

$this

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

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

Параметры

Builder $query
string $boolean
bool $not

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

$this

$this whereRowValues(array $columns, string $operator, array $values, string $boolean = 'and')

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

Параметры

array $columns
string $operator
array $values
string $boolean

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

$this

Исключения

InvalidArgumentException

$this orWhereRowValues(array $columns, string $operator, array $values)

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

Параметры

array $columns
string $operator
array $values

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

$this

$this whereJsonContains(string $column, mixed $value, string $boolean = 'and', bool $not = false)

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

Parameters

string $column
mixed $value
string $boolean
bool $not

Return Value

$this

$this orWhereJsonContains(string $column, mixed $value)

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

Parameters

string $column
mixed $value

Return Value

$this

$this whereJsonDoesntContain(string $column, mixed $value, string $boolean = 'and')

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

Parameters

string $column
mixed $value
string $boolean

Return Value

$this

$this orWhereJsonDoesntContain(string $column, mixed $value)

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

Parameters

string $column
mixed $value

Return Value

$this

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

Добавить условие, определяющее, существует ли JSON-путь в запросе.

Parameters

string $column
string $boolean
bool $not

Return Value

$this

$this orWhereJsonContainsKey(string $column)

Добавить условие «или», определяющее, существует ли JSON-путь в запросе.

Parameters

string $column

Return Value

$this

$this whereJsonDoesntContainKey(string $column, string $boolean = 'and')

Добавить условие, определяющее, не существует ли JSON-путь в запросе.

Parameters

string $column
string $boolean

Return Value

$this

$this orWhereJsonDoesntContainKey(string $column)

Добавить условие «или», определяющее, не существует ли JSON-путь в запросе.

Parameters

string $column

Return Value

$this

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

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

Parameters

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

Return Value

$this

$this orWhereJsonLength(string $column, mixed $operator, mixed $value = null)

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

Parameters

string $column
mixed $operator
mixed $value

Return Value

$this

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

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

Parameters

string $method
array $parameters

Return Value

$this

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

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

Parameters

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

Return Value

void

$this whereFullText(string|string[] $columns, string $value, array $options = [], string $boolean = 'and')

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

Parameters

string|string[] $columns
string $value
array $options
string $boolean

Return Value

$this

$this orWhereFullText(string|string[] $columns, string $value, array $options = [])

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

Parameters

string|string[] $columns
string $value
array $options

Return Value

$this

$this whereAll(string[] $columns, mixed $operator = null, mixed $value = null, string $boolean = 'and')

Добавить условие "где" для нескольких столбцов с условиями "и" между ними.

Parameters

string[] $columns
mixed $operator
mixed $value
string $boolean

Return Value

$this

$this orWhereAll(string[] $columns, string $operator = null, mixed $value = null)

Добавить условие "или где" для нескольких столбцов с условиями "и" между ними.

Parameters

string[] $columns
string $operator
mixed $value

Return Value

$this

$this whereAny(string[] $columns, string $operator = null, mixed $value = null, string $boolean = 'and')

Добавить условие "где" для нескольких столбцов с условиями "или" между ними.

Parameters

string[] $columns
string $operator
mixed $value
string $boolean

Return Value

$this

$this orWhereAny(string[] $columns, string $operator = null, mixed $value = null)

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

Параметры

string[] $columns
string $operator
mixed $value

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

$this

$this groupBy(array|Expression|string ...$groups)

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

Параметры

array|Expression|string ...$groups

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

$this

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

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

Параметры

string $sql
array $bindings

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

$this

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

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

Параметры

Expression|Closure|string $column
string|int|float|null $operator
string|int|float|null $value
string $boolean

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

$this

$this orHaving(Expression|Closure|string $column, string|int|float|null $operator = null, string|int|float|null $value = null)

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

Параметры

Expression|Closure|string $column
string|int|float|null $operator
string|int|float|null $value

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

$this

$this havingNested(Closure $callback, string $boolean = 'and')

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

Параметры

Closure $callback
string $boolean

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

$this

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

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

Параметры

Builder $query
string $boolean

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

$this

$this havingNull(string|array $columns, string $boolean = 'and', bool $not = false)

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

Параметры

string|array $columns
string $boolean
bool $not

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

$this

$this orHavingNull(string $column)

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

Параметры

string $column

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

$this

$this havingNotNull(string|array $columns, string $boolean = 'and')

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

Параметры

string|array $columns
string $boolean

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

$this

$this orHavingNotNull(string $column)

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

Параметры

string $column

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

$this

$this havingBetween(string $column, iterable $values, string $boolean = 'and', bool $not = false)

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

Параметры

string $column
iterable $values
string $boolean
bool $not

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

$this

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

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

Параметры

string $sql
array $bindings
string $boolean

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

$this

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

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

Параметры

string $sql
array $bindings

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

$this

$this orderBy(Closure|Builder|Builder|Expression|string $column, string $direction = 'asc')

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

Параметры

Closure|Builder|Builder|Expression|string $column
string $direction

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

$this

Исключения

InvalidArgumentException

$this orderByDesc(Closure|Builder|Builder|Expression|string $column)

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

Параметры

Closure|Builder|Builder|Expression|string $column

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

$this

$this latest(Closure|Builder|Expression|string $column = 'created_at')

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

Параметры

Closure|Builder|Expression|string $column

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

$this

$this oldest(Closure|Builder|Expression|string $column = 'created_at')

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

Параметры

Closure|Builder|Expression|string $column

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

$this

$this inRandomOrder(string|int $seed = '')

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

Параметры

string|int $seed

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

$this

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

Добавить условие сортировки с использованием произвольного SQL-выражения.

Параметры

string $sql
array $bindings

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

$this

$this skip(int $value)

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

Параметры

int $value

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

$this

$this offset(int $value)

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

Параметры

int $value

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

$this

$this take(int $value)

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

Параметры

int $value

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

$this

$this limit(int $value)

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

Параметры

int $value

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

$this

$this forPage(int $page, int $perPage = 15)

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

Параметры

int $page
int $perPage

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

$this

$this forPageBeforeId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')

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

Параметры

int $perPage
int|null $lastId
string $column

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

$this

$this forPageAfterId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')

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

Параметры

int $perPage
int|null $lastId
string $column

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

$this

$this reorder(Closure|Builder|Expression|string|null $column = null, string $direction = 'asc')

Удалить все существующие сортировки и, при необходимости, добавить новую.

Параметры

Closure|Builder|Expression|string|null $column
string $direction

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

$this

protected array removeExistingOrdersFor(string $column)

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

Параметры

string $column

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

array

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

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

Параметры

Closure|Builder|Builder $query
bool $all

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

$this

$this unionAll(Closure|Builder|Builder $query)

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

Параметры

Closure|Builder|Builder $query

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

$this

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

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

Параметры

string|bool $value

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

$this

$this lockForUpdate()

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

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

$this

$this sharedLock()

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

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

$this

$this beforeQuery(callable $callback)

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

Параметры

callable $callback

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

$this

void applyBeforeQueryCallbacks()

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

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

void

string toSql()

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

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

string

string toRawSql()

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

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

string

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

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

Параметры

int|string $id
array|string $columns

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

mixed|Builder

mixed|Builder findOr(mixed $id, Closure|array|string $columns = ['*'], Closure $callback = null)

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

Параметры

mixed $id
Closure|array|string $columns
Closure $callback

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

mixed|Builder

mixed value(string $column)

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

Parameters

string $column

Return Value

mixed

mixed rawValue(string $expression, array $bindings = [])

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

Parameters

string $expression
array $bindings

Return Value

mixed

mixed soleValue(string $column)

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

Parameters

string $column

Return Value

mixed

Exceptions

RecordsNotFoundException
MultipleRecordsFoundException

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

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

Parameters

array|string $columns

Return Value

Collection

protected array runSelect()

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

Return Value

array

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

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

Parameters

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

Return Value

LengthAwarePaginator

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

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

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

Parameters

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

Return Value

Paginator

CursorPaginator cursorPaginate(int|null $perPage = 15, array|string $columns = ['*'], string $cursorName = 'cursor', Cursor|string|null $cursor = null)

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

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

Параметры

int|null $perPage
array|string $columns
string $cursorName
Cursor|string|null $cursor

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

CursorPaginator

protected Collection ensureOrderForCursorPagination(bool $shouldReverse = false)

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

Параметры

bool $shouldReverse

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

Collection

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

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

Параметры

array $columns

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

int

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

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

Параметры

array $columns

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

array

protected Builder cloneForPaginationCount()

Клонировать существующий экземпляр запроса для использования в подзапросе пагинации.

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

Builder

protected array withoutSelectAliases(array $columns)

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

Параметры

array $columns

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

array

LazyCollection cursor()

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

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

LazyCollection

protected void enforceOrderBy()

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

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

void

Исключения

RuntimeException

Коллекция pluck(Выражение|string $column, string|null $key = null)

Получить экземпляр коллекции, содержащий значения указанного столбца.

Параметры

Выражение|string $column
string|null $key

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

Коллекция

protected string|null stripTableForPluck(string $column)

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

Параметры

string $column

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

string|null

protected Коллекция pluckFromObjectColumn(array $queryResult, string $column, string $key)

Извлечь значения столбца из строк, представленных в виде объектов.

Параметры

array $queryResult
string $column
string $key

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

Коллекция

protected Коллекция pluckFromArrayColumn(array $queryResult, string $column, string $key)

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

Параметры

array $queryResult
string $column
string $key

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

Коллекция

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

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

Параметры

string $column
string $glue

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

string

bool exists()

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

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

bool

bool doesntExist()

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

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

bool

mixed existsOr(Closure $callback)

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

Параметры

Closure $callback

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

mixed

mixed doesntExistOr(Closure $callback)

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

Параметры

Closure $callback

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

mixed

int count(Expression|string $columns = '*')

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

Параметры

Expression|string $columns

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

int

mixed min(Expression|string $column)

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

Параметры

Expression|string $column

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

mixed

mixed max(Expression|string $column)

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

Параметры

Expression|string $column

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

mixed

mixed sum(Expression|string $column)

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

Параметры

Expression|string $column

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

mixed

mixed avg(Expression|string $column)

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

Параметры

Expression|string $column

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

mixed

mixed average(Expression|string $column)

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

Параметры

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

protected mixed onceWithColumns(array $columns, callable $callback)

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

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

Параметры

array $columns
callable $callback

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

mixed

bool insert(array $values)

Вставка новых записей в базу данных.

Параметры

array $values

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

bool

int insertOrIgnore(array $values)

Вставка новых записей в базу данных, игнорируя ошибки.

Параметры

array $values

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

int

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

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

Параметры

array $values
string|null $sequence

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

int

int insertUsing(array $columns, Closure|Builder|Builder|string $query)

Вставить новые записи в таблицу с помощью подзапроса.

Параметры

array $columns
Closure|Builder|Builder|string $query

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

int

int insertOrIgnoreUsing(array $columns, Closure|Builder|Builder|string $query)

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

Параметры

array $columns
Closure|Builder|Builder|string $query

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

int

int update(array $values)

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

Параметры

array $values

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

int

int updateFrom(array $values)

Обновление записей в базе данных PostgreSQL с использованием синтаксиса update from.

Параметры

array $values

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

int

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

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

Параметры

array $attributes
array $values

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

bool

int upsert(array $values, array|string $uniqueBy, array|null $update = null)

Вставка новых записей или обновление существующих.

Параметры

array $values
array|string $uniqueBy
array|null $update

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

int

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

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

Параметры

string $column
float|int $amount
array $extra

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

int

Исключения

InvalidArgumentException

int incrementEach(array $columns, array $extra = [])

Увеличение значений указанных столбцов на заданные величины.

Параметры

array $columns
array $extra

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

int

Исключения

InvalidArgumentException

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

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

Параметры

string $column
float|int $amount
array $extra

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

int

Исключения

InvalidArgumentException

int decrementEach(array $columns, array $extra = [])

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

Параметры

array $columns
array $extra

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

int

Исключения

InvalidArgumentException

int delete(mixed $id = null)

Удаление записей из базы данных.

Параметры

mixed $id

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

int

void truncate()

Выполнение команды truncate для таблицы.

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

void

Блокер newQuery()

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

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

Блокер

protected Блокер forSubQuery()

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

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

Блокер

array getColumns()

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

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

array

Выражение raw(mixed $value)

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

Параметры

mixed $value

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

Выражение

protected Коллекция getUnionBuilders()

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

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

Коллекция

array getBindings()

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

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

array

array getRawBindings()

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

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

array

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

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

Параметры

array $bindings
string $type

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

$this

Исключения

ИсключениеНекорректныхАргументов

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

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

Параметры

mixed $value
string $type

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

$this

Исключения

ИсключениеНекорректныхАргументов

mixed castBinding(mixed $value)

Преобразовать значение привязки.

Параметры

mixed $value

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

mixed

$this mergeBindings(Builder $query)

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

Параметры

Builder $query

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

$this

array cleanBindings(array $bindings)

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

Параметры

array $bindings

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

array

protected mixed flattenValue(mixed $value)

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

Параметры

mixed $value

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

mixed

protected string defaultKeyName()

Получить имя по умолчанию для ключа таблицы.

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

string

ConnectionInterface getConnection()

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

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

ConnectionInterface

Processor getProcessor()

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

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

Processor

Grammar getGrammar()

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

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

Grammar

$this useWritePdo()

Использовать подключение PDO "write" при выполнении запроса.

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

$this

protected bool isQueryable(mixed $value)

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

Параметры

mixed $value

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

bool

Builder clone()

Клонировать запрос.

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

Builder

Builder cloneWithout(array $properties)

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

Параметры

array $properties

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

Builder

Блок-схема cloneWithoutBindings(array $except)

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

Параметры

массив $except

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

Блок-схема

$this dump()

Вывести текущую SQL-запрос и связи.

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

$this

$this dumpRawSql()

Вывести исходный текущий SQL-запрос с встроенными связями.

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

$this

never dd()

Вывести текущую SQL-запрос и связи и завершить выполнение программы.

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

never

never ddRawSql()

Вывести исходный текущий SQL-запрос с встроенными связями и завершить выполнение программы.

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

never

$this on(Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null, string $boolean = 'and')

Добавить условие "on" к соединению.

Условие on может быть сцеплено, например:

$join->on('contacts.user_id', '=', 'users.id') ->on('contacts.info_id', '=', 'info.id')

Это произведет следующий SQL:

on contacts.user_id = users.id and contacts.info_id = info.id

Параметры

Closure|Expression|string $first
string|null $operator
Expression|string|null $second
string $boolean

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

$this

Исключения

InvalidArgumentException

УсловиеСоединения orOn(Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)

Добавить условие "или на" к соединению.

Параметры

Closure|Expression|string $first
string|null $operator
Expression|string|null $second

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

УсловиеСоединения

protected Builder newParentQuery()

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

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

Builder

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

Spec-Zone.ru

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