Строитель
класс Строитель реализует Строитель (Просмотреть исходный код)
Трейты
| BuildsQueries | |
| ExplainsQueries | |
| ForwardsCalls | |
| Macroable | |
| Conditionable |
Свойства
| static protected array | $macros | Зарегистрированные строковые макросы. | from Macroable |
| ConnectionInterface | $connection | Экземпляр подключения к базе данных. | |
| Grammar | $grammar | Экземпляр синтаксического анализатора запросов к базе данных. | |
| Processor | $processor | Экземпляр постпроцессора запросов к базе данных. | |
| array | $bindings | Текущие значения связей запроса. | |
| array | $aggregate | Агрегатная функция и столбец для выполнения. | |
| array|null | $columns | Столбцы, которые должны быть возвращены. | |
| bool|array | $distinct | Указывает, возвращает ли запрос уникальные результаты. | |
| Expression|string | $from | Таблица, на которую направлен запрос. | |
| IndexHint | $indexHint | Подсказка индекса для запроса. | |
| array | $joins | Соединения таблиц для запроса. | |
| array | $wheres | Условия where для запроса. | |
| array | $groups | Группировки для запроса. | |
| array | $havings | Условия having для запроса. | |
| array | $orders | Сортировки для запроса. | |
| int | $limit | Максимальное количество записей для возврата. | |
| array | $groupLimit | Максимальное количество записей для возврата на группу. | |
| int | $offset | Количество записей для пропуска. | |
| array | $unions | Заявления объединения запросов. | |
| int | $unionLimit | Максимальное количество записей объединения для возврата. | |
| int | $unionOffset | Количество записей объединения для пропуска. | |
| array | $unionOrders | Сортировки для запроса объединения. | |
| string|bool | $lock | Указывает, используется ли блокировка строк. | |
| array | $beforeQueryCallbacks | Обработчики событий, которые должны быть вызваны перед выполнением запроса. | |
| protected array | $afterQueryCallbacks | Обработчики событий, которые должны быть вызваны после извлечения данных из базы данных. | |
| string[] | $operators | Все доступные операторы предложений. | |
| string[] | $bitwiseOperators | Все доступные побитовые операторы. | |
| bool | $useWritePdo | Использовать ли write pdo для select. |
Методы
| $this|TWhenReturnType | when($value = null, callable|null $callback = null, callable|null $default = null)
Примените обратный вызов, если заданное «значение» является (или разрешается в) истинное значение. | из Conditionable |
| $this|TUnlessReturnType | unless($value = null, callable|null $callback = null, callable|null $default = null)
Примените обратный вызов, если заданное «значение» является (или разрешается в) ложное значение. | из Conditionable |
| bool | chunk(int $count, callable $callback)
Разбить результаты запроса на куски. | из BuildsQueries |
| TReturn> | 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)
Выполнить обратный вызов над каждым элементом с разбивкой на куски по идентификатору. | из 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 |
| TValue|null | first(array|string $columns = ['*'])
Выполняет запрос и возвращает первый результат. | from BuildsQueries |
| TValue | 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, 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($callback)
Передаёт запрос в заданный обратный вызов. | from BuildsQueries |
| Collection | explain()
Объясняет запрос. | from ExplainsQueries |
| mixed | forwardCallTo(mixed $object, string $method, array $parameters)
Перенаправляет вызов метода на заданный объект. | from ForwardsCalls |
| mixed | forwardDecoratedCallTo(mixed $object, string $method, array $parameters)
Передать вызов метода заданному объекту, вернув $this, если переданный вызов вернул себя. | from ForwardsCalls |
| static void | throwBadMethodCallException(string $method)
Выбросить исключение плохого вызова метода для данного метода. | from ForwardsCalls |
| static void | macro(string $name, object|callable $macro)
Зарегистрировать пользовательское макрос. | from Macroable |
| static void | mixin(object $mixin, bool $replace = true)
Смешать другой объект в класс. | from Macroable |
| static bool | hasMacro(string $name)
Проверяет, зарегистрировано ли макрос. | from Macroable |
| static void | flushMacros()
Очистить существующие макросы. | from Macroable |
| static mixed | __callStatic(string $method, array $parameters)
Динамически обработать вызовы класса. | from Macroable |
| mixed | __call(string $method, array $parameters)
Обработать динамические вызовы методов в метод. | |
| void | __construct(ConnectionInterface $connection, Grammar|null $grammar = null, Processor|null $processor = null)
Создать новый экземпляр билдера запросов. | |
| $this | select(array|mixed $columns = ['*'])
Установить столбцы, которые нужно выбрать. | |
| $this | selectSub($query, string $as)
Добавить выражение подзапроса в запрос. | |
| $this | selectRaw(string $expression, array $bindings = [])
Добавить новое выражение "сырого" выбора в запрос. | |
| $this | fromSub($query, string $as)
Заставляет "from" извлекать данные из подзапроса. | |
| $this | fromRaw(string $expression, mixed $bindings = [])
Добавить в запрос предложение "from" с сырым выражением. | |
| array | createSub($query)
Создаёт подзапрос и анализирует его. | |
| array | parseSub(mixed $query)
Анализирует подзапрос, преобразуя его в SQL и значения. | |
| mixed | prependDatabaseNameIfCrossDatabaseQuery(mixed $query)
Добавляет имя базы данных, если данный запрос относится к другой базе данных. | |
| $this | addSelect(array|mixed $column)
Добавить новый столбец выбора в запрос. | |
| $this | distinct()
Вынудительно возвращать только уникальные результаты. |
| $this | from($table, string|null $as = null)
Укажите таблицу, на которую нацелен запрос. | |
| $this | useIndex(string $index)
Добавьте подсказку индекса для указания индекса запроса. | |
| $this | forceIndex(string $index)
Добавьте подсказку индекса для принудительного использования индекса запроса. | |
| $this | ignoreIndex(string $index)
Добавьте подсказку индекса для игнорирования индекса запроса. | |
| $this | join(Expression|string $table, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null, string $type = 'inner', bool $where = false)
Добавьте условие объединения к запросу. | |
| $this | joinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string $second, string $type = 'inner')
Добавьте условие объединения с "where" к запросу. | |
| $this | joinSub($query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null, string $type = 'inner', bool $where = false)
Добавьте условие объединения с подзапросом к запросу. | |
| $this | joinLateral($query, string $as, string $type = 'inner')
Добавьте условие латерального объединения к запросу. | |
| $this | leftJoinLateral($query, string $as)
Добавьте латеральное левое объединение к запросу. | |
| $this | leftJoin(Expression|string $table, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)
Добавьте левое объединение к запросу. | |
| $this | leftJoinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string|null $second)
Добавьте условие объединения с "where" к левому объединению. | |
| $this | leftJoinSub($query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)
Добавьте левое объединение с подзапросом к запросу. |
| $this | rightJoin(Expression|string $table, Closure|string $first, string|null $operator = null, Expression|string|null $second = null)
Добавить правое соединение к запросу. | |
| $this | rightJoinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string $second)
Добавить условие "правое соединение где" к запросу. | |
| $this | rightJoinSub($query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)
Добавить подзапрос правого соединения к запросу. | |
| $this | crossJoin(Expression|string $table, Closure|Expression|string|null $first = null, string|null $operator = null, Expression|string|null $second = null)
Добавить условие "внешнее соединение" к запросу. | |
| $this | crossJoinSub($query, string $as)
Добавить подзапрос внешнего соединения к запросу. | |
| JoinClause | newJoinClause(Builder $parentQuery, string $type, string $table)
Получить новую фразу соединения. | |
| JoinLateralClause | newJoinLateralClause(Builder $parentQuery, string $type, string $table)
Получить новую фразу бокового соединения. | |
| $this | mergeWheres(array $wheres, array $bindings)
Объединить массив условий и значений. | |
| $this | where(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null, string $boolean = 'and')
Добавить базовое условие «где» к запросу. | |
| $this | addArrayOfWheres(array $column, string $boolean, string $method = 'where')
Добавить массив условий «где» к запросу. | |
| array | prepareValueAndOperator(string $value, string $operator, bool $useDefault = false)
Подготовить значение и оператор для условия «где». | |
| bool | invalidOperatorAndValue(string $operator, mixed $value)
Определить, является ли данная комбинация оператора и значения допустимой. | |
| bool | invalidOperator(string $operator)
Определить, поддерживается ли данный оператор. | |
| bool | isBitwiseOperator(string $operator)
Определить, является ли оператор побитовым оператором. |
| $this | orWhere(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null)
Добавить условие «или где» к запросу. | |
| $this | whereNot(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null, string $boolean = 'and')
Добавить базовое условие «не где» к запросу. | |
| $this | orWhereNot(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null)
Добавить условие «или не где» к запросу. | |
| $this | whereColumn(Expression|string|array $first, string|null $operator = null, string|null $second = null, string|null $boolean = 'and')
Добавить условие «где» для сравнения двух столбцов к запросу. | |
| $this | orWhereColumn(Expression|string|array $first, string|null $operator = null, string|null $second = null)
Добавить условие «или где» для сравнения двух столбцов к запросу. | |
| $this | whereRaw(string $sql, mixed $bindings = [], string $boolean = 'and')
Добавить сырое условие «где» к запросу. | |
| $this | orWhereRaw(string $sql, mixed $bindings = [])
Добавить сырое условие «или где» к запросу. | |
| $this | whereIn(Expression|string $column, mixed $values, string $boolean = 'and', bool $not = false)
Добавить условие «где в» к запросу. | |
| $this | orWhereIn(Expression|string $column, mixed $values)
Добавить условие «или где в» к запросу. | |
| $this | whereNotIn(Expression|string $column, mixed $values, string $boolean = 'and')
Добавить условие «где не в» к запросу. | |
| $this | orWhereNotIn(Expression|string $column, mixed $values)
Добавить условие «или где не в» к запросу. | |
| $this | whereIntegerInRaw(string $column, Arrayable|array $values, string $boolean = 'and', bool $not = false)
Добавить условие «где в (сырое)» для целочисленных значений в запрос. | |
| $this | orWhereIntegerInRaw(string $column, Arrayable|array $values)
Добавить условие «или где в (сырое)» для целочисленных значений в запрос. | |
| $this | whereIntegerNotInRaw(string $column, Arrayable|array $values, string $boolean = 'and')
Добавить условие «где не в (сырое)» для целочисленных значений в запрос. |
| $this | orWhereIntegerNotInRaw(string $column, Arrayable|array $values)
Добавить условие "или где не в raw" для целых значений в запрос. | |
| $this | whereNull(string|array|Expression $columns, string $boolean = 'and', bool $not = false)
Добавить условие "где null" в запрос. | |
| $this | orWhereNull(string|array|Expression $column)
Добавить условие "или где null" в запрос. | |
| $this | whereNotNull(string|array|Expression $columns, string $boolean = 'and')
Добавить условие "где не null" в запрос. | |
| $this | whereBetween(Expression|string $column, iterable $values, string $boolean = 'and', bool $not = false)
Добавить условие "где между" в запрос. | |
| $this | whereBetweenColumns(Expression|string $column, array $values, string $boolean = 'and', bool $not = false)
Добавить условие "где между" используя столбцы в запрос. | |
| $this | orWhereBetween(Expression|string $column, iterable $values)
Добавить условие "или где между" в запрос. | |
| $this | orWhereBetweenColumns(Expression|string $column, array $values)
Добавить условие "или где между" используя столбцы в запрос. | |
| $this | whereNotBetween(Expression|string $column, iterable $values, string $boolean = 'and')
Добавить условие "где не между" в запрос. | |
| $this | whereNotBetweenColumns(Expression|string $column, array $values, string $boolean = 'and')
Добавить условие "где не между" используя столбцы в запрос. | |
| $this | orWhereNotBetween(Expression|string $column, iterable $values)
Добавить условие "или где не между" в запрос. | |
| $this | orWhereNotBetweenColumns(Expression|string $column, array $values)
Добавить условие "или где не между" используя столбцы в запрос. | |
| $this | orWhereNotNull(Expression|string $column)
Добавить условие "или где не null" в запрос. | |
| $this | whereDate(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')
Добавить условие "где дата" в запрос. |
| $this | orWhereDate(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null)
Добавить условие "или где дата" в запрос. | |
| $this | whereTime(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')
Добавить условие "где время" в запрос. | |
| $this | orWhereTime(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null)
Добавить условие "или где время" в запрос. | |
| $this | whereDay(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')
Добавить условие "где день" в запрос. | |
| $this | orWhereDay(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)
Добавить условие "или где день" в запрос. | |
| $this | whereMonth(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')
Добавить условие "где месяц" в запрос. | |
| $this | orWhereMonth(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)
Добавить условие "или где месяц" в запрос. | |
| $this | whereYear(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')
Добавить условие "где год" в запрос. | |
| $this | orWhereYear(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)
Добавить условие "или где год" в запрос. |
| $this | addDateBasedWhere(string $type, Expression|string $column, string $operator, mixed $value, string $boolean = 'and')
Добавить условие, основанное на дате (год, месяц, день, время), в запрос. | |
| $this | whereNested(Closure $callback, string $boolean = 'and')
Добавить вложенное условие where в запрос. | |
| Builder | forNestedWhere()
Создать новый экземпляр запроса для вложенного условия where. | |
| $this | addNestedWhereQuery(Builder $query, string $boolean = 'and')
Добавить другой билдер запросов как вложенное условие where к билдеру запроса. | |
| $this | whereSub(Expression|string $column, string $operator, $callback, string $boolean)
Добавить полное подзапросное условие в запрос. | |
| $this | whereExists($callback, string $boolean = 'and', bool $not = false)
Добавить условие exists в запрос. | |
| $this | orWhereExists($callback, bool $not = false)
Добавить условие or exists в запрос. | |
| $this | whereNotExists($callback, string $boolean = 'and')
Добавить условие where not exists в запрос. | |
| $this | orWhereNotExists($callback)
Добавить условие or where not exists в запрос. | |
| $this | addWhereExistsQuery(Builder $query, string $boolean = 'and', bool $not = false)
Добавить условие exists в запрос. | |
| $this | whereRowValues(array $columns, string $operator, array $values, string $boolean = 'and')
Добавляет условие where, используя значения строк. | |
| $this | orWhereRowValues(array $columns, string $operator, array $values)
Добавляет условие or where, используя значения строк. | |
| $this | whereJsonContains(string $column, mixed $value, string $boolean = 'and', bool $not = false)
Добавить условие "where JSON содержит" в запрос. | |
| $this | orWhereJsonContains(string $column, mixed $value)
Добавить условие "or where JSON содержит" в запрос. | |
| $this | whereJsonDoesntContain(string $column, mixed $value, string $boolean = 'and')
Добавить условие "where JSON не содержит" в запрос. | |
| $this | orWhereJsonDoesntContain(string $column, mixed $value)
Добавить условие "or where JSON не содержит" в запрос. | |
| $this | whereJsonOverlaps(string $column, mixed $value, string $boolean = 'and', bool $not = false)
Добавить условие "where JSON перекрывается" в запрос. | |
| $this | orWhereJsonOverlaps(string $column, mixed $value)
Добавить условие "or where JSON перекрывается" в запрос. | |
| $this | whereJsonDoesntOverlap(string $column, mixed $value, string $boolean = 'and')
Добавить условие "where JSON не перекрывается" в запрос. |
| $this | orWhereJsonDoesntOverlap(string $column, mixed $value)
Добавить условие "или где JSON не перекрывается" к запросу. | |
| $this | whereJsonContainsKey(string $column, string $boolean = 'and', bool $not = false)
Добавить условие, определяющее, существует ли JSON-путь в запросе. | |
| $this | orWhereJsonContainsKey(string $column)
Добавить условие "или", определяющее, существует ли JSON-путь в запросе. | |
| $this | whereJsonDoesntContainKey(string $column, string $boolean = 'and')
Добавить условие, определяющее, не существует ли JSON-путь в запросе. | |
| $this | orWhereJsonDoesntContainKey(string $column)
Добавить условие "или", определяющее, не существует ли JSON-путь в запросе. | |
| $this | whereJsonLength(string $column, mixed $operator, mixed $value = null, string $boolean = 'and')
Добавить условие "где длина JSON" к запросу. | |
| $this | orWhereJsonLength(string $column, mixed $operator, mixed $value = null)
Добавить условие "или где длина JSON" к запросу. | |
| $this | dynamicWhere(string $method, array $parameters)
Обрабатывает динамические условия "where" в запросе. | |
| void | addDynamic(string $segment, string $connector, array $parameters, int $index)
Добавить отдельное динамическое условие "where" в запрос. | |
| $this | whereFullText(string|string[] $columns, string $value, array $options = [], string $boolean = 'and')
Добавить условие "где полное соответствие" к запросу. | |
| $this | orWhereFullText(string|string[] $columns, string $value, array $options = [])
Добавить условие "или где полное соответствие" к запросу. | |
| $this | whereAll(string[] $columns, mixed $operator = null, mixed $value = null, string $boolean = 'and')
Добавить условие "где" к запросу для нескольких столбцов с условиями "и" между ними. | |
| $this | orWhereAll(string[] $columns, string $operator = null, mixed $value = null)
Добавить условие "или где" к запросу для нескольких столбцов с условиями "и" между ними. | |
| $this | whereAny(string[] $columns, string $operator = null, mixed $value = null, string $boolean = 'and')
Добавить условие "где" к запросу для нескольких столбцов с условиями "или" между ними. | |
| $this | orWhereAny(string[] $columns, string $operator = null, mixed $value = null)
Добавить условие "или где" к запросу для нескольких столбцов с условиями "или" между ними. | |
| $this | groupBy(array|Expression|string ...$groups)
Добавить условие "сгруппировать по" к запросу. | |
| $this | groupByRaw(string $sql, array $bindings = [])
Добавить сырое условие "сгруппировать по" к запросу. | |
| $this | having(Expression|Closure|string $column, string|int|float|null $operator = null, string|int|float|null $value = null, string $boolean = 'and')
Добавить условие "иметь" к запросу. |
| $this | orHaving(Expression|Closure|string $column, string|int|float|null $operator = null, string|int|float|null $value = null)
Добавить условие "или имеющий" к запросу. | |
| $this | havingNested(Closure $callback, string $boolean = 'and')
Добавить вложенное условие having к запросу. | |
| $this | addNestedHavingQuery(Builder $query, string $boolean = 'and')
Добавить другой объект Query Builder как вложенное условие having к объекту Query Builder. | |
| $this | havingNull(string|array $columns, string $boolean = 'and', bool $not = false)
Добавить условие "имеющий null" к запросу. | |
| $this | orHavingNull(string $column)
Добавить условие "или имеющий null" к запросу. | |
| $this | havingNotNull(string|array $columns, string $boolean = 'and')
Добавить условие "имеющий не null" к запросу. | |
| $this | orHavingNotNull(string $column)
Добавить условие "или имеющий не null" к запросу. | |
| $this | havingBetween(string $column, iterable $values, string $boolean = 'and', bool $not = false)
Добавить условие "имеющий между" к запросу. | |
| $this | havingRaw(string $sql, array $bindings = [], string $boolean = 'and')
Добавить сырое условие having к запросу. | |
| $this | orHavingRaw(string $sql, array $bindings = [])
Добавить сырое условие "или имеющий" к запросу. | |
| $this | orderBy($column, string $direction = 'asc')
Добавить условие "упорядочить по" к запросу. | |
| $this | orderByDesc($column)
Добавить условие "упорядочить по убыванию" к запросу. | |
| $this | latest(Closure|Builder|Expression|string $column = 'created_at')
Добавить условие "упорядочить по" для временной метки к запросу. | |
| $this | oldest(Closure|Builder|Expression|string $column = 'created_at')
Добавить условие "упорядочить по" для временной метки к запросу. | |
| $this | inRandomOrder(string|int $seed = '')
Упорядочить результаты запроса случайным образом. | |
| $this | orderByRaw(string $sql, array $bindings = [])
Добавить сырое условие "упорядочить по" к запросу. | |
| $this | skip(int $value)
Псевдоним для установки значения "смещение" запроса. | |
| $this | offset(int $value)
Установить значение "смещения" запроса. | |
| $this | take(int $value)
Псевдоним для установки значения "ограничение" запроса. | |
| $this | limit(int $value)
Установить значение "ограничения" запроса. |
| $this | groupLimit(int $value, string $column)
Добавить условие "ограничения группировки" к запросу. | |
| $this | forPage(int $page, int $perPage = 15)
Установить лимит и смещение для заданной страницы. | |
| $this | forPageBeforeId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')
Ограничить запрос предыдущей "страницей" результатов до заданного идентификатора. | |
| $this | forPageAfterId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')
Ограничить запрос следующей "страницей" результатов после заданного идентификатора. | |
| $this | reorder(Closure|Builder|Expression|string|null $column = null, string $direction = 'asc')
Удалить все существующие сортировки и, по желанию, добавить новую сортировку. | |
| array | removeExistingOrdersFor(string $column)
Получить массив со всеми удалёнными сортировками по заданному столбцу. | |
| $this | union($query, bool $all = false)
Добавить оператор объединения к запросу. | |
| $this | unionAll($query)
Добавить оператор объединения ALL к запросу. | |
| $this | lock(string|bool $value = true)
Заблокировать выбранные строки в таблице. | |
| $this | lockForUpdate()
Заблокировать выбранные строки в таблице для обновления. | |
| $this | sharedLock()
Заблокировать выбранные строки в таблице с совместным доступом. | |
| $this | beforeQuery(callable $callback)
Зарегистрировать замыкание, которое будет вызываться перед выполнением запроса. | |
| void | applyBeforeQueryCallbacks()
Вызвать коллбеки модификации "перед запросом". | |
| $this | afterQuery(Closure $callback)
Зарегистрировать замыкание, которое будет вызываться после выполнения запроса. | |
| mixed | applyAfterQueryCallbacks(mixed $result)
Вызвать коллбеки модификации "после запроса". | |
| string | toSql()
Получить SQL-представление запроса. | |
| string | toRawSql()
Получить необработанное SQL-представление запроса со встроенными связями. | |
| object|null | find(int|string $id, array|string $columns = ['*'])
Выполнить запрос для получения одной записи по идентификатору. | |
| findOr($id, $columns = ['*'], Closure|null $callback = null) Без описания | ||
| mixed | value(string $column)
Получить значение одного столбца из первого результата запроса. | |
| mixed | rawValue(string $expression, array $bindings = [])
Получить значение одного выражения из первого результата запроса. | |
| mixed | soleValue(string $column)
Получить значение одного столбца из первого результата запроса, если это единственная соответствующая запись. |
| Коллекция | get(array|string $columns = ['*'])
Выполнить запрос как оператор «select». | |
| массив | runSelect()
Выполнить запрос как оператор «select» против подключения. | |
| Коллекция | withoutGroupLimitKeys(Коллекция $items)
Удалить ключи ограничения группы из результатов в коллекции. | |
| LengthAwarePaginator | paginate(int|Closure $perPage = 15, array|string $columns = ['*'], string $pageName = 'page', int|null $page = null, Closure|int|null $total = null)
Разбить заданный запрос на страницы с помощью простого пагинатора. | |
| Paginator | simplePaginate(int $perPage = 15, array|string $columns = ['*'], string $pageName = 'page', int|null $page = null)
Получить пагинатор, поддерживающий только простые ссылки «следующая» и «предыдущая». | |
| CursorPaginator | cursorPaginate(int|null $perPage = 15, array|string $columns = ['*'], string $cursorName = 'cursor', Cursor|string|null $cursor = null)
Получить пагинатор, поддерживающий только простые ссылки «следующая» и «предыдущая». | |
| Коллекция | ensureOrderForCursorPagination(bool $shouldReverse = false)
Обеспечить правильный порядок, необходимый для пагинации с помощью курсора. | |
| int | getCountForPagination(array $columns = ['*'])
Получить количество всех записей для пагинатора. | |
| массив | runPaginationCountQuery(array $columns = ['*'])
Выполнить запрос подсчёта для пагинации. | |
| Builder | cloneForPaginationCount()
Создать копию существующего экземпляра запроса для использования в подзапросе для пагинации. | |
| массив | withoutSelectAliases(array $columns)
Удалить псевдонимы столбцов, так как они могут нарушить запросы подсчёта. | |
| LazyCollection | cursor()
Получить ленивую коллекцию для заданного запроса. | |
| void | enforceOrderBy()
Выбросить исключение, если в запросе нет предложения orderBy. | |
| Коллекция<ключ-массива,смешанное> | pluck(Expression|string $column, string|null $key = null)
Получить экземпляр коллекции, содержащий значения заданного столбца. | |
| string|null | stripTableForPluck(string $column)
Убрать имя таблицы или псевдоним из идентификатора столбца. | |
| Коллекция | pluckFromObjectColumn(array $queryResult, string $column, string $key)
Извлечь значения столбцов из строк, представленных как объекты. |
| Collection | pluckFromArrayColumn(array $queryResult, string $column, string $key)
Извлечь значения столбца из строк, представленных в виде массивов. | |
| строка | implode(string $column, string $glue = '')
Сконкатенировать значения заданного столбца в строку. | |
| логическое | exists()
Определить, существуют ли какие-либо строки для текущего запроса. | |
| логическое | doesntExist()
Определить, не существуют ли какие-либо строки для текущего запроса. | |
| смешанный тип | existsOr(Closure $callback)
Выполнить заданный обратный вызов, если для текущего запроса не существует строк. | |
| смешанный тип | doesntExistOr(Closure $callback)
Выполнить заданный обратный вызов, если для текущего запроса существуют строки. | |
| целое число | count(Expression|string $columns = '*')
Получить результат "count" запроса. | |
| смешанный тип | min(Expression|string $column)
Получить минимальное значение заданного столбца. | |
| смешанный тип | max(Expression|string $column)
Получить максимальное значение заданного столбца. | |
| смешанный тип | sum(Expression|string $column)
Получить сумму значений заданного столбца. | |
| смешанный тип | avg(Expression|string $column)
Получить среднее значение значений заданного столбца. | |
| смешанный тип | average(Expression|string $column)
Псевдоним для метода "avg". | |
| смешанный тип | aggregate(string $function, array $columns = ['*'])
Выполнить агрегатную функцию в базе данных. | |
| число с плавающей точкой|целое число | numericAggregate(string $function, array $columns = ['*'])
Выполнить числовую агрегатную функцию в базе данных. | |
| $this | setAggregate(string $function, array $columns)
Установить свойство агрегирования без выполнения запроса. | |
| смешанный тип | onceWithColumns(array $columns, callable $callback)
Выполнить заданный обратный вызов, выбирая заданные столбцы. | |
| логическое | insert(array $values)
Вставить новые записи в базу данных. | |
| целое число | insertOrIgnore(array $values)
Вставить новые записи в базу данных, игнорируя ошибки. | |
| целое число | insertGetId(array $values, string|null $sequence = null)
Вставить новую запись и получить значение первичного ключа. | |
| целое число | insertUsing(array $columns, $query)
Вставить новые записи в таблицу, используя подзапрос. |
| int | insertOrIgnoreUsing(array $columns, $query)
Вставка новых записей в таблицу с помощью подзапроса, игнорируя ошибки. | |
| int | update(array $values)
Обновление записей в базе данных. | |
| int | updateFrom(array $values)
Обновление записей в базе данных PostgreSQL с использованием синтаксиса update from. | |
| bool | updateOrInsert(array $attributes, array|callable $values = [])
Вставка или обновление записи, соответствующей атрибутам, и заполнение её значениями. | |
| int | upsert(array $values, array|string $uniqueBy, array|null $update = null)
Вставка новых записей или обновление существующих. | |
| int | increment(string $column, float|int $amount = 1, array $extra = [])
Увеличение значения столбца на заданное количество. | |
| int | incrementEach(array $columns, array $extra = [])
Увеличение значений указанных столбцов на заданные величины. | |
| int | decrement(string $column, float|int $amount = 1, array $extra = [])
Уменьшение значения столбца на заданное количество. | |
| int | decrementEach(array $columns, array $extra = [])
Уменьшение значений указанных столбцов на заданные величины. | |
| int | delete(mixed $id = null)
Удаление записей из базы данных. | |
| void | truncate()
Выполнение оператора truncate для таблицы. | |
| Builder | newQuery()
Получение нового экземпляра билдера запросов. | |
| Builder | forSubQuery()
Создание нового экземпляра запроса для подзапроса. | |
| array | getColumns()
Получение всех столбцов билдера запросов в текстовом массиве с оценкой всех выражений. | |
| Expression | raw(mixed $value)
Создание выражения базы данных в сыром виде. | |
| Collection | getUnionBuilders()
Получение экземпляров билдеров запросов, используемых в объединении запроса. | |
| array | getBindings()
Получение текущих связываемых значений запроса в плоском массиве. | |
| array | getRawBindings()
Получение массива связываемых значений в сыром виде. | |
| $this | setBindings(array $bindings, string $type = 'where')
Установка связываемых значений для билдера запросов. | |
| $this | addBinding(mixed $value, string $type = 'where')
Добавление связываемого значения в запрос. | |
| mixed | castBinding(mixed $value)
Преобразование заданного связываемого значения. | |
| $this | mergeBindings(Builder $query)
Объединение массива связываемых значений в наши связываемые значения. |
| array | cleanBindings(array $bindings)
Удалить все выражения из списка связей. | |
| mixed | flattenValue(mixed $value)
Получить значение скалярного типа из входных данных неизвестного типа. | |
| string | defaultKeyName()
Получить имя по умолчанию для ключа таблицы. | |
| ConnectionInterface | getConnection()
Получить экземпляр подключения к базе данных. | |
| Processor | getProcessor()
Получить экземпляр обработчика запросов к базе данных. | |
| Grammar | getGrammar()
Получить экземпляр грамматики запросов. | |
| $this | useWritePdo()
Использовать соединение "write" PDO при выполнении запроса. | |
| bool | isQueryable(mixed $value)
Определить, является ли значение экземпляром построения запроса или замыканием. | |
| Builder | clone()
Клонировать запрос. | |
| Builder | cloneWithout(array $properties)
Клонировать запрос без указанных свойств. | |
| Builder | cloneWithoutBindings(array $except)
Клонировать запрос без указанных связей. | |
| $this | dump(mixed ...$args)
Вывести текущий SQL-запрос и связи. | |
| $this | dumpRawSql()
Вывести исходный SQL-запрос с вложенными связями. | |
| never | dd()
Прекратить выполнение и вывести текущий SQL-запрос и связи. | |
| never | ddRawSql()
Прекратить выполнение и вывести исходный SQL-запрос с вложенными связями. |
Подробности
$this|TWhenReturnType when($value = null, callable|null $callback = null, callable|null $default = null)
Применить обратный вызов, если заданное "значение" истинно (или разрешается в истинное).
$this|TUnlessReturnType unless($value = null, callable|null $callback = null, callable|null $default = null)
Применить обратный вызов, если заданное "значение" ложно (или разрешается в ложное).
bool chunk(int $count, callable $callback)
Разбить результаты запроса на куски.
TReturn> chunkMap(callable $callback, int $count = 1000)
Выполнить отображение над каждым элементом с разбиением на куски.
bool each(callable $callback, int $count = 1000)
Выполнить обратный вызов над каждым элементом с разбиением на куски.
bool chunkById(int $count, callable $callback, string|null $column = null, string|null $alias = null)
Разбить результаты запроса на куски, сравнивая идентификаторы.
bool chunkByIdDesc(int $count, callable $callback, string|null $column = null, string|null $alias = null)
Разбить результаты запроса на куски, сравнивая идентификаторы в порядке убывания.
bool orderedChunkById(int $count, callable $callback, string|null $column = null, string|null $alias = null, bool $descending = false)
Разбить результаты запроса на куски, сравнивая идентификаторы в заданном порядке.
bool eachById(callable $callback, int $count = 1000, string|null $column = null, string|null $alias = null)
Выполнить обратный вызов над каждым элементом с разбиением по идентификатору.
LazyCollection lazy(int $chunkSize = 1000)
Ленивый запрос по кускам заданного размера.
LazyCollection lazyById(int $chunkSize = 1000, string|null $column = null, string|null $alias = null)
Запрос лениво, разбивая результаты запроса на части, сравнивая идентификаторы.
LazyCollection lazyByIdDesc(int $chunkSize = 1000, string|null $column = null, string|null $alias = null)
Ленивый запрос, разбивая результаты запроса на части, сравнивая идентификаторы в порядке убывания.
protected LazyCollection orderedLazyById(int $chunkSize = 1000, string|null $column = null, string|null $alias = null, bool $descending = false)
Ленивый запрос, разбивая результаты запроса на части, сравнивая идентификаторы в заданном порядке.
TValue|null first(array|string $columns = ['*'])
Выполнить запрос и получить первый результат.
TValue sole(array|string $columns = ['*'])
Выполнить запрос и получить первый результат, если это единственный соответствующий запись.
protected CursorPaginator paginateUsingCursor(int $perPage, array|string $columns = ['*'], string $cursorName = 'cursor', Cursor|string|null $cursor = null)
Выполнить постраничную разбивку заданного запроса с помощью курсорного пагинатора.
protected string getOriginalColumnNameForCursorPagination($builder, string $parameter)
Получить исходное имя столбца заданного столбца без каких-либо алиасов.
protected LengthAwarePaginator paginator(Collection $items, int $total, int $perPage, int $currentPage, array $options)
Создать новый экземпляр пагинатора с учётом длины.
protected Paginator simplePaginator(Collection $items, int $perPage, int $currentPage, array $options)
Создать новый экземпляр простого пагинатора.
protected CursorPaginator cursorPaginator(Collection $items, int $perPage, Cursor $cursor, array $options)
Создать новый экземпляр курсорного пагинатора.
$this tap($callback)
Передать запрос в заданный обратный вызов.
Collection explain()
Объясняет запрос.
protected mixed forwardCallTo(mixed $object, string $method, array $parameters)
Перенаправляет вызов метода заданному объекту.
protected mixed forwardDecoratedCallTo(mixed $object, string $method, array $parameters)
Перенаправляет вызов метода заданному объекту, возвращая $this, если перенаправленный вызов вернул себя.
static protected void throwBadMethodCallException(string $method)
Выбрасывает исключение BadMethodCallException для данного метода.
static void macro(string $name, object|callable $macro)
Регистрирует пользовательское макро.
static void mixin(object $mixin, bool $replace = true)
Смешивает другой объект в класс.
static bool hasMacro(string $name)
Проверяет, зарегистрировано ли макро.
static void flushMacros()
Очистить существующие макросы.
static mixed __callStatic(string $method, array $parameters)
Динамически обрабатывает вызовы класса.
mixed __call(string $method, array $parameters)
Обрабатывает динамические вызовы методов.
void __construct(ConnectionInterface $connection, Grammar|null $grammar = null, Processor|null $processor = null)
Создаёт новый экземпляр билдера запросов.
$this select(array|mixed $columns = ['*'])
Устанавливает столбцы для выбора.
$this selectSub($query, string $as)
Добавляет подзапрос к запросу.
$this selectRaw(string $expression, array $bindings = [])
Добавляет новый "сырой" выражение выбора к запросу.
$this fromSub($query, string $as)
Заставляет "from" получать данные из подзапроса.
$this fromRaw(string $expression, mixed $bindings = [])
Добавляет "сырое" условие from к запросу.
protected array createSub($query)
Создаёт подзапрос и анализирует его.
protected array parseSub(mixed $query)
Анализирует подзапрос, преобразуя его в SQL и параметры.
protected mixed prependDatabaseNameIfCrossDatabaseQuery(mixed $query)
Добавляет имя базы данных, если запрос относится к другой базе данных.
$this addSelect(array|mixed $column)
Добавляет новый столбец в выборку запроса.
$this distinct()
Вынуждает запрос возвращать только уникальные результаты.
$this from($table, string|null $as = null)
Устанавливает таблицу, на которую направлен запрос.
$this useIndex(string $index)
Добавляет подсказку индекса для использования в запросе.
$this forceIndex(string $index)
Добавляет подсказку индекса, заставляющую использовать указанный индекс.
$this ignoreIndex(string $index)
Добавляет подсказку индекса, чтобы игнорировать указанный индекс.
$this join(Expression|string $table, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null, string $type = 'inner', bool $where = false)
Добавить условие объединения к запросу.
$this joinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string $second, string $type = 'inner')
Добавить условие «join where» к запросу.
$this joinSub($query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null, string $type = 'inner', bool $where = false)
Добавить условие объединения с подзапросом к запросу.
$this joinLateral($query, string $as, string $type = 'inner')
Добавить условие левого объединения к запросу.
$this leftJoinLateral($query, string $as)
Добавить левое соединение слева к запросу.
$this leftJoin(Expression|string $table, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)
Добавить левое соединение к запросу.
$this leftJoinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string|null $second)
Добавить условие «соединение где» в запрос.
$this leftJoinSub($query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)
Добавить подзапрос левого соединения в запрос.
$this rightJoin(Expression|string $table, Closure|string $first, string|null $operator = null, Expression|string|null $second = null)
Добавить правое соединение к запросу.
$this rightJoinWhere(Expression|string $table, Closure|Expression|string $first, string $operator, Expression|string $second)
Добавить условие «правое соединение где» к запросу.
$this rightJoinSub($query, string $as, Closure|Expression|string $first, string|null $operator = null, Expression|string|null $second = null)
Добавить правое соединение подзапроса к запросу.
$this crossJoin(Expression|string $table, Closure|Expression|string|null $first = null, string|null $operator = null, Expression|string|null $second = null)
Добавить условие "внешнего соединения" к запросу.
$this crossJoinSub($query, string $as)
Добавить подзапрос с внешним соединением к запросу.
protected JoinClause newJoinClause(Builder $parentQuery, string $type, string $table)
Получить новую фразу соединения.
protected JoinLateralClause newJoinLateralClause(Builder $parentQuery, string $type, string $table)
Получить новую фразу соединения (lateral).
$this mergeWheres(array $wheres, array $bindings)
Объединить массив условий where и связывающие переменные.
$this where(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null, string $boolean = 'and')
Добавить базовое условие where к запросу.
protected $this addArrayOfWheres(array $column, string $boolean, string $method = 'where')
Добавить массив условий where к запросу.
array prepareValueAndOperator(string $value, string $operator, bool $useDefault = false)
Подготовить значение и оператор для условия where.
protected bool invalidOperatorAndValue(string $operator, mixed $value)
Определить, является ли данная комбинация оператора и значения допустимой.
Предотвращает использование значений Null с недопустимыми операторами.
protected bool invalidOperator(string $operator)
Определить, поддерживается ли данный оператор.
protected bool isBitwiseOperator(string $operator)
Определить, является ли оператор побитовым оператором.
$this orWhere(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null)
Добавить условие "or where" к запросу.
$this whereNot(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null, string $boolean = 'and')
Добавить базовое условие "where not" к запросу.
$this orWhereNot(Closure|string|array|Expression $column, mixed $operator = null, mixed $value = null)
Добавить условие «или не где» к запросу.
$this whereColumn(Expression|string|array $first, string|null $operator = null, string|null $second = null, string|null $boolean = 'and')
Добавить условие «где» сравнивая два столбца к запросу.
$this orWhereColumn(Expression|string|array $first, string|null $operator = null, string|null $second = null)
Добавить условие «или где» сравнивая два столбца к запросу.
$this whereRaw(string $sql, mixed $bindings = [], string $boolean = 'and')
Добавить сырое условие «где» к запросу.
$this orWhereRaw(string $sql, mixed $bindings = [])
Добавить сырое условие «или где» к запросу.
$this whereIn(Expression|string $column, mixed $values, string $boolean = 'and', bool $not = false)
Добавить условие «где в» к запросу.
$this orWhereIn(Expression|string $column, mixed $values)
Добавить условие "или где в" к запросу.
$this whereNotIn(Expression|string $column, mixed $values, string $boolean = 'and')
Добавить условие "где не в" к запросу.
$this orWhereNotIn(Expression|string $column, mixed $values)
Добавить условие "или где не в" к запросу.
$this whereIntegerInRaw(string $column, Arrayable|array $values, string $boolean = 'and', bool $not = false)
Добавить условие "где в (сырое)" для целочисленных значений к запросу.
$this orWhereIntegerInRaw(string $column, Arrayable|array $values)
Добавить условие "или где в (сырое)" для целочисленных значений к запросу.
$this whereIntegerNotInRaw(string $column, Arrayable|array $values, string $boolean = 'and')
Добавить условие "где не в (сырое)" для целочисленных значений к запросу.
$this orWhereIntegerNotInRaw(string $column, Arrayable|array $values)
Добавить условие «или где не содержится в» для целочисленных значений в запрос.
$this whereNull(string|array|Expression $columns, string $boolean = 'and', bool $not = false)
Добавить условие «где пусто» в запрос.
$this orWhereNull(string|array|Expression $column)
Добавить условие «или где пусто» в запрос.
$this whereNotNull(string|array|Expression $columns, string $boolean = 'and')
Добавить условие «где не пусто» в запрос.
$this whereBetween(Expression|string $column, iterable $values, string $boolean = 'and', bool $not = false)
Добавить условие «между» в запрос.
$this whereBetweenColumns(Expression|string $column, array $values, string $boolean = 'and', bool $not = false)
Добавить условие «между» используя столбцы в запрос.
$this orWhereBetween(Expression|string $column, iterable $values)
Добавить условие or where между значениями в запросе.
$this orWhereBetweenColumns(Expression|string $column, array $values)
Добавить условие or where между значениями по столбцам в запросе.
$this whereNotBetween(Expression|string $column, iterable $values, string $boolean = 'and')
Добавить условие where не между значениями в запросе.
$this whereNotBetweenColumns(Expression|string $column, array $values, string $boolean = 'and')
Добавить условие where не между значениями по столбцам в запросе.
$this orWhereNotBetween(Expression|string $column, iterable $values)
Добавить условие or где не между значениями в запросе.
$this orWhereNotBetweenColumns(Expression|string $column, array $values)
Добавить условие or где не между значениями по столбцам в запросе.
$this orWhereNotNull(Expression|string $column)
Добавить условие "или где не null" к запросу.
$this whereDate(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')
Добавить условие "где дата" к запросу.
$this orWhereDate(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null)
Добавить условие "или где дата" к запросу.
$this whereTime(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')
Добавить условие "где время" к запросу.
$this orWhereTime(Expression|string $column, DateTimeInterface|string|null $operator, DateTimeInterface|string|null $value = null)
Добавить условие "или где время" к запросу.
$this whereDay(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')
Добавить условие "где день" к запросу.
$this orWhereDay(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)
Добавить условие "или где день" к запросу.
$this whereMonth(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')
Добавить условие "где месяц" к запросу.
$this orWhereMonth(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)
Добавить условие "или где месяц" к запросу.
$this whereYear(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')
Добавить условие "где год" к запросу.
$this orWhereYear(Expression|string $column, DateTimeInterface|string|int|null $operator, DateTimeInterface|string|int|null $value = null)
Добавить условие "или где год" к запросу.
protected $this addDateBasedWhere(string $type, Expression|string $column, string $operator, mixed $value, string $boolean = 'and')
Добавить условие, основанное на дате (год, месяц, день, время), к запросу.
$this whereNested(Closure $callback, string $boolean = 'and')
Добавить вложенное условие where к запросу.
Builder forNestedWhere()
Создать новый экземпляр запроса для вложенного условия where.
$this addNestedWhereQuery(Builder $query, string $boolean = 'and')
Добавить другой объект билдера запросов в качестве вложенного условия where к объекту билдера запросов.
protected $this whereSub(Expression|string $column, string $operator, $callback, string $boolean)
Добавить полное подзапросное условие в запрос.
$this whereExists($callback, string $boolean = 'and', bool $not = false)
Добавить условие exists в запрос.
$this orWhereExists($callback, bool $not = false)
Добавить условие or exists в запрос.
$this whereNotExists($callback, string $boolean = 'and')
Добавить условие where not exists в запрос.
$this orWhereNotExists($callback)
Добавить условие where not exists в запрос.
$this addWhereExistsQuery(Builder $query, string $boolean = 'and', bool $not = false)
Добавить условие exists в запрос.
$this whereRowValues(array $columns, string $operator, array $values, string $boolean = 'and')
Добавляет условие where с использованием значений строки.
$this orWhereRowValues(array $columns, string $operator, array $values)
Добавляет условие or where с использованием значений строки.
$this whereJsonContains(string $column, mixed $value, string $boolean = 'and', bool $not = false)
Добавляет условие "where JSON содержит" в запрос.
$this orWhereJsonContains(string $column, mixed $value)
Добавляет условие "or where JSON содержит" в запрос.
$this whereJsonDoesntContain(string $column, mixed $value, string $boolean = 'and')
Добавляет условие "where JSON не содержит" в запрос.
$this orWhereJsonDoesntContain(string $column, mixed $value)
Добавляет условие "or where JSON не содержит" в запрос.
$this whereJsonOverlaps(string $column, mixed $value, string $boolean = 'and', bool $not = false)
Добавляет условие "where JSON перекрывается" в запрос.
$this orWhereJsonOverlaps(string $column, mixed $value)
Добавляет условие "or where JSON перекрывается" в запрос.
$this whereJsonDoesntOverlap(string $column, mixed $value, string $boolean = 'and')
Добавить условие "where JSON не перекрывается" к запросу.
$this orWhereJsonDoesntOverlap(string $column, mixed $value)
Добавить условие "or where JSON не перекрывается" к запросу.
$this whereJsonContainsKey(string $column, string $boolean = 'and', bool $not = false)
Добавить условие, определяющее существование JSON пути к запросу.
$this orWhereJsonContainsKey(string $column)
Добавить условие "or", определяющее существование JSON пути к запросу.
$this whereJsonDoesntContainKey(string $column, string $boolean = 'and')
Добавить условие, определяющее отсутствие JSON пути к запросу.
$this orWhereJsonDoesntContainKey(string $column)
Добавить условие "or", определяющее отсутствие JSON пути к запросу.
$this whereJsonLength(string $column, mixed $operator, mixed $value = null, string $boolean = 'and')
Добавить условие "where JSON длина" к запросу.
$this orWhereJsonLength(string $column, mixed $operator, mixed $value = null)
Добавить условие "or where JSON длина" к запросу.
$this dynamicWhere(string $method, array $parameters)
Обрабатывает динамические условия "where" для запроса.
protected void addDynamic(string $segment, string $connector, array $parameters, int $index)
Добавить оператор динамического условия в запрос.
$this whereFullText(string|string[] $columns, string $value, array $options = [], string $boolean = 'and')
Добавить условие "where fulltext" в запрос.
$this orWhereFullText(string|string[] $columns, string $value, array $options = [])
Добавить условие "or where fulltext" в запрос.
$this whereAll(string[] $columns, mixed $operator = null, mixed $value = null, string $boolean = 'and')
Добавить условие "where" в запрос для нескольких столбцов с условиями "и" между ними.
$this orWhereAll(string[] $columns, string $operator = null, mixed $value = null)
Добавить условие "or where" в запрос для нескольких столбцов с условиями "и" между ними.
$this whereAny(string[] $columns, string $operator = null, mixed $value = null, string $boolean = 'and')
Добавить условие "where" в запрос для нескольких столбцов с условиями "или" между ними.
$this orWhereAny(string[] $columns, string $operator = null, mixed $value = null)
Добавить условие "or where" в запрос для нескольких столбцов с условиями "или" между ними.
$this groupBy(array|Expression|string ...$groups)
Добавить условие "group by" в запрос.
$this groupByRaw(string $sql, array $bindings = [])
Добавить условие группировки raw к запросу.
$this having(Expression|Closure|string $column, string|int|float|null $operator = null, string|int|float|null $value = null, string $boolean = 'and')
Добавить условие "having" к запросу.
$this orHaving(Expression|Closure|string $column, string|int|float|null $operator = null, string|int|float|null $value = null)
Добавить условие "or having" к запросу.
$this havingNested(Closure $callback, string $boolean = 'and')
Добавить вложенное условие having к запросу.
$this addNestedHavingQuery(Builder $query, string $boolean = 'and')
Добавить другой объект запроса как вложенное условие having к объекту запроса.
$this havingNull(string|array $columns, string $boolean = 'and', bool $not = false)
Добавить условие "having null" к запросу.
$this orHavingNull(string $column)
Добавить условие "or having null" к запросу.
$this havingNotNull(string|array $columns, string $boolean = 'and')
Добавить условие «having not null» к запросу.
$this orHavingNotNull(string $column)
Добавить условие «or having not null» к запросу.
$this havingBetween(string $column, iterable $values, string $boolean = 'and', bool $not = false)
Добавить условие «having between» к запросу.
$this havingRaw(string $sql, array $bindings = [], string $boolean = 'and')
Добавить сырое условие having к запросу.
$this orHavingRaw(string $sql, array $bindings = [])
Добавить сырое условие «or having» к запросу.
$this orderBy($column, string $direction = 'asc')
Добавить условие «order by» к запросу.
$this orderByDesc($column)
Добавить условие «order by» по убыванию к запросу.
$this latest(Closure|Builder|Expression|string $column = 'created_at')
Добавить условие сортировки по временной метке к запросу.
$this oldest(Closure|Builder|Expression|string $column = 'created_at')
Добавить условие "сортировка по" для отметки времени в запросе.
$this inRandomOrder(string|int $seed = '')
Вывести результаты запроса в случайном порядке.
$this orderByRaw(string $sql, array $bindings = [])
Добавить условие "сортировка по" с помощью необработанного SQL-запроса.
$this skip(int $value)
Псевдоним для установки значения "смещение" запроса.
$this offset(int $value)
Установить значение "смещения" запроса.
$this take(int $value)
Псевдоним для установки значения "лимит" запроса.
$this limit(int $value)
Установить значение "лимит" запроса.
$this groupLimit(int $value, string $column)
Добавить условие "группового лимита" в запрос.
$this forPage(int $page, int $perPage = 15)
Установить лимит и смещение для заданной страницы.
$this forPageBeforeId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')
Ограничить запрос предыдущей "страницей" результатов перед заданным ID.
$this forPageAfterId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')
Ограничить запрос следующей "страницей" результатов после заданного ID.
$this reorder(Closure|Builder|Expression|string|null $column = null, string $direction = 'asc')
Удалить все существующие сортировки и, по желанию, добавить новую сортировку.
protected array removeExistingOrdersFor(string $column)
Получить массив со всеми удалёнными сортировками по заданному столбцу.
$this union($query, bool $all = false)
Добавить оператор объединения к запросу.
$this unionAll($query)
Добавить оператор объединения ALL к запросу.
$this lock(string|bool $value = true)
Заблокировать выбранные строки в таблице.
$this lockForUpdate()
Заблокировать выбранные строки в таблице для обновления.
$this sharedLock()
Заблокировать выбранные строки в таблице по принципу совместного доступа.
$this beforeQuery(callable $callback)
Зарегистрировать замыкание, которое будет вызываться перед выполнением запроса.
void applyBeforeQueryCallbacks()
Вызвать обратные вызовы модификаций "перед запросом".
$this afterQuery(Closure $callback)
Зарегистрировать замыкание, которое будет вызываться после выполнения запроса.
mixed applyAfterQueryCallbacks(mixed $result)
Вызвать колбэки модификации "после запроса".
string toSql()
Получить SQL-представление запроса.
string toRawSql()
Получить исходное SQL-представление запроса со встроенными связываниями.
object|null find(int|string $id, array|string $columns = ['*'])
Выполнить запрос для получения одной записи по ID.
findOr($id, $columns = ['*'], Closure|null $callback = null)
Без описания
mixed value(string $column)
Получить значение единственного столбца из первого результата запроса.
mixed rawValue(string $expression, array $bindings = [])
Получить значение единственного выражения из первого результата запроса.
mixed soleValue(string $column)
Получить значение единственного столбца из первого результата запроса, если это единственная совпадающая запись.
Коллекция get(array|string $columns = ['*'])
Выполнить запрос как операцию "select".
protected array runSelect()
Выполнить запрос как операцию «выбор» к подключению.
protected Collection withoutGroupLimitKeys(Collection $items)
Удалить ключи ограничения группы из результатов в коллекции.
LengthAwarePaginator paginate(int|Closure $perPage = 15, array|string $columns = ['*'], string $pageName = 'page', int|null $page = null, Closure|int|null $total = null)
Разбить данные из запроса на страницы с помощью пагинатора.
Paginator simplePaginate(int $perPage = 15, array|string $columns = ['*'], string $pageName = 'page', int|null $page = null)
Получить пагинатор, поддерживающий только простые ссылки «следующая» и «предыдущая».
Более эффективно для больших наборов данных.
CursorPaginator cursorPaginate(int|null $perPage = 15, array|string $columns = ['*'], string $cursorName = 'cursor', Cursor|string|null $cursor = null)
Получить пагинатор, поддерживающий только простые ссылки «следующая» и «предыдущая».
Более эффективно для больших наборов данных.
protected Collection ensureOrderForCursorPagination(bool $shouldReverse = false)
Обеспечить правильный порядок, необходимый для пагинации по курсорам.
int getCountForPagination(array $columns = ['*'])
Получить количество всех записей для пагинатора.
protected array runPaginationCountQuery(array $columns = ['*'])
Выполнить запрос подсчёта для пагинации.
protected Builder cloneForPaginationCount()
Клонировать существующий экземпляр запроса для использования в подзапросе пагинации.
protected array withoutSelectAliases(array $columns)
Удалить алиасы столбцов, так как они нарушают работу запросов подсчёта.
LazyCollection cursor()
Получить ленивую коллекцию для заданного запроса.
protected void enforceOrderBy()
Выбросить исключение, если в запросе нет условия сортировки.
Collection<array-key,mixed> pluck(Expression|string $column, string|null $key = null)
Получить коллекцию значений заданного столбца.
protected string|null stripTableForPluck(string $column)
Удалить имя или псевдоним таблицы из идентификатора столбца.
protected Collection pluckFromObjectColumn(array $queryResult, string $column, string $key)
Получить значения столбца из строк, представленных как объекты.
protected Collection pluckFromArrayColumn(array $queryResult, string $column, string $key)
Извлечь значения столбца из строк, представленных массивами.
string implode(string $column, string $glue = '')
Конкатенировать значения заданного столбца в строку.
bool exists()
Определить, существуют ли строки для текущего запроса.
bool doesntExist()
Определить, не существует ли строк для текущего запроса.
mixed existsOr(Closure $callback)
Выполнить заданный обратный вызов, если для текущего запроса не существует строк.
mixed doesntExistOr(Closure $callback)
Выполнить заданный обратный вызов, если для текущего запроса существуют строки.
int count(Expression|string $columns = '*')
Получить результат "count" запроса.
mixed min(Expression|string $column)
Получить минимальное значение заданного столбца.
mixed max(Expression|string $column)
Получить максимальное значение заданного столбца.
mixed sum(Expression|string $column)
Получить сумму значений заданного столбца.
mixed avg(Expression|string $column)
Получить среднее значение значений заданного столбца.
mixed average(Expression|string $column)
Псевдоним для метода "avg".
mixed aggregate(string $function, array $columns = ['*'])
Выполнение агрегатной функции в базе данных.
float|int numericAggregate(string $function, array $columns = ['*'])
Выполнение числовой агрегатной функции в базе данных.
protected $this setAggregate(string $function, array $columns)
Установить свойство aggregate без выполнения запроса.
protected mixed onceWithColumns(array $columns, callable $callback)
Выполнить переданный обратный вызов с указанными столбцами.
После выполнения обратного вызова столбцы возвращаются к исходному значению.
bool insert(array $values)
Вставить новые записи в базу данных.
int insertOrIgnore(array $values)
Вставить новые записи в базу данных, игнорируя ошибки.
int insertGetId(array $values, string|null $sequence = null)
Вставить новую запись и получить значение первичного ключа.
int insertUsing(array $columns, $query)
Вставить новые записи в таблицу, используя подзапрос.
int insertOrIgnoreUsing(array $columns, $query)
Вставить новые записи в таблицу, используя подзапрос, игнорируя ошибки.
int update(array $values)
Обновить записи в базе данных.
int updateFrom(array $values)
Обновить записи в базе данных PostgreSQL, используя синтаксис update from.
bool updateOrInsert(array $attributes, array|callable $values = [])
Вставить или обновить запись, соответствующую атрибутам, и заполнить её значениями.
int upsert(array $values, array|string $uniqueBy, array|null $update = null)
Вставить новые записи или обновить существующие.
int increment(string $column, float|int $amount = 1, array $extra = [])
Увеличить значение столбца на заданное количество.
int incrementEach(array $columns, array $extra = [])
Увеличить значения указанных столбцов на заданные количества.
int decrement(string $column, float|int $amount = 1, array $extra = [])
Уменьшить значение столбца на заданную величину.
int decrementEach(array $columns, array $extra = [])
Уменьшить значения указанных столбцов на заданные величины.
int delete(mixed $id = null)
Удалить записи из базы данных.
void truncate()
Выполнить операцию truncate для таблицы.
Builder newQuery()
Получить новый экземпляр билдера запросов.
protected Builder forSubQuery()
Создать новый экземпляр билдера запросов для подзапроса.
array getColumns()
Получить все столбцы билдера запросов в текстовом массиве, в котором все выражения вычислены.
Expression raw(mixed $value)
Создать выражение базы данных в сыром виде.
protected Collection getUnionBuilders()
Получить экземпляры билдера запросов, используемые в объединении запроса.
array getBindings()
Получить текущие значения связываемых параметров запроса в плоском массиве.
array getRawBindings()
Получить сырой массив связываемых параметров.
$this setBindings(array $bindings, string $type = 'where')
Установить привязки в билдере запроса.
$this addBinding(mixed $value, string $type = 'where')
Добавить привязку к запросу.
mixed castBinding(mixed $value)
Преобразовать значение привязки.
$this mergeBindings(Builder $query)
Объединить массив привязок в наши привязки.
array cleanBindings(array $bindings)
Удалить все выражения из списка привязок.
protected mixed flattenValue(mixed $value)
Получить значение скалярного типа из входных данных неизвестного типа.
protected string defaultKeyName()
Получить имя ключа по умолчанию для таблицы.
ConnectionInterface getConnection()
Получить экземпляр подключения к базе данных.
Processor getProcessor()
Получить экземпляр обработчика запросов базы данных.
Grammar getGrammar()
Получить экземпляр синтаксического анализатора запросов.
$this useWritePdo()
Использовать соединение "write" PDO при выполнении запроса.
protected bool isQueryable(mixed $value)
Определить, является ли значение экземпляром билдера запросов или замыканием.
Библиотека clone()
Клонировать запрос.
Библиотека cloneWithout(array $properties)
Клонировать запрос без указанных свойств.
Библиотека cloneWithoutBindings(array $except)
Клонировать запрос без указанных связываний.
$this dump(mixed ...$args)
Вывести текущий SQL и связывающие значения.
$this dumpRawSql()
Вывести исходный SQL с встроенными связывающими значениями.
never dd()
Прекратить выполнение и вывести текущий SQL и связывающие значения.
never ddRawSql()
Прекратить выполнение и вывести исходный SQL с встроенными связывающими значениями.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/11.x/Illuminate/Database/Query/Builder.html
