Строитель
класс Builder (Просмотр исходного кода)
Трейты
| BuildsQueries | |
| ForwardsCalls | |
| Macroable |
Свойства
| статический защищённый массив | $macros | Зарегистрированные строковые макросы. | из Macroable |
| ConnectionInterface | $connection | Экземпляр подключения к базе данных. | |
| Grammar | $grammar | Экземпляр грамматики запросов к базе данных. | |
| Processor | $processor | Экземпляр постобработчика запросов к базе данных. | |
| массив | $bindings | Текущие параметры запроса. | |
| массив | $aggregate | Функция агрегации и столбец для выполнения. | |
| массив | $columns | Столбцы, которые должны быть возвращены. | |
| логическое значение | $distinct | Указывает, возвращает ли запрос уникальные результаты. | |
| строка | $from | Таблица, на которую нацелен запрос. | |
| массив | $joins | Объединения таблиц для запроса. | |
| массив | $wheres | Условие WHERE для запроса. | |
| массив | $groups | Группировки для запроса. | |
| массив | $havings | Условие HAVING для запроса. | |
| массив | $orders | Упорядочивание для запроса. | |
| целое число | $limit | Максимальное количество записей для возврата. | |
| целое число | $offset | Количество записей, которые нужно пропустить. | |
| массив | $unions | Заявления объединения запроса. | |
| целое число | $unionLimit | Максимальное количество записей объединения для возврата. | |
| целое число | $unionOffset | Количество записей объединения для пропуска. | |
| массив | $unionOrders | Упорядочивание для запроса объединения. | |
| строка|логическое значение | $lock | Указывает, используется ли блокировка строк. | |
| массив | $operators | Все доступные операторы запроса. | |
| логическое значение | $useWritePdo | Использовать ли write pdo для выбора. |
Методы
| bool | chunk(int $count, callable $callback) Разбить результаты запроса на куски. | из BuildsQueries |
| bool | each(callable $callback, int $count = 1000) Выполнить обратный вызов над каждым элементом с разбиением на куски. | из BuildsQueries |
| Model|object|BuildsQueries|null | first(array $columns = ['*']) Выполнить запрос и получить первый результат. | из BuildsQueries |
| mixed|$this | when(mixed $value, callable $callback, callable|null $default = null) Применить изменения запроса в обратном вызове, если заданное «значение» истинно. | из BuildsQueries |
| Builder | tap(callable $callback) Передать запрос в заданный обратный вызов. | из BuildsQueries |
| mixed|$this | unless(mixed $value, callable $callback, callable|null $default = null) Применить изменения запроса в обратном вызове, если заданное «значение» ложно. | из BuildsQueries |
| LengthAwarePaginator | paginator(Collection $items, int $total, int $perPage, int $currentPage, array $options) Создать новый экземпляр пагинатора с учетом длины. | из BuildsQueries |
| Paginator | simplePaginator(Collection $items, int $perPage, int $currentPage, array $options) Создать новый простой экземпляр пагинатора. | из BuildsQueries |
| mixed | forwardCallTo(mixed $object, string $method, array $parameters) Перенаправить вызов метода заданному объекту. | из 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 mixed | __callStatic(string $method, array $parameters) Динамически обрабатывать вызовы класса. | из Macroable |
| mixed | __call(string $method, array $parameters) Обработать динамические вызовы метода в метод. | |
| void | __construct(ConnectionInterface $connection, Grammar $grammar = null, Processor $processor = null) Создать новый экземпляр билдера запросов. | |
| $this | select(array|mixed $columns = ['*']) Установить столбцы, которые нужно выбрать. | |
| Builder|Builder | selectSub(Closure|Builder|string $query, string $as) Добавить подзапрос выражение в запрос. | |
| Builder|Builder | selectRaw(string $expression, array $bindings = []) Добавить новое выражение «необработанного» выбора в запрос. | |
| Builder|Builder | fromSub(Closure|Builder|string $query, string $as) Делает «from», чтобы извлечение происходило из подзапроса. | |
| Builder|Builder | fromRaw(string $expression, mixed $bindings = []) Добавить необработанную часть «from» в запрос. | |
| array | createSub(Closure|Builder|string $query) Создает подзапрос и анализирует его. | |
| array | parseSub(mixed $query) Анализирует подзапрос в SQL и параметры. | |
| $this | addSelect(array|mixed $column) Добавить новый столбец выбора в запрос. | |
| $this | distinct() Принудительно возвращать только уникальные результаты. | |
| $this | from(string $table) Указать таблицу, на которую направлен запрос. | |
| $this | join(string $table, Closure|string $first, string|null $operator = null, string|null $second = null, string $type = 'inner', bool $where = false) Добавить условие соединения в запрос. | |
| Builder|Builder | joinWhere(string $table, Closure|string $first, string $operator, string $second, string $type = 'inner') Добавить условие «join where» в запрос. |
| Builder|Builder | joinSub(Closure|Builder|string $query, string $as, Closure|string $first, string|null $operator = null, string|null $second = null, string $type = 'inner', bool $where = false) Добавить условие соединения подзапроса к запросу. | |
| Builder|Builder | leftJoin(string $table, Closure|string $first, string|null $operator = null, string|null $second = null) Добавить левое соединение к запросу. | |
| Builder|Builder | leftJoinWhere(string $table, Closure|string $first, string $operator, string $second) Добавить условие «соединение где» к запросу. | |
| Builder|Builder | leftJoinSub(Closure|Builder|string $query, string $as, Closure|string $first, string|null $operator = null, string|null $second = null) Добавить левое соединение подзапроса к запросу. | |
| Builder|Builder | rightJoin(string $table, Closure|string $first, string|null $operator = null, string|null $second = null) Добавить правое соединение к запросу. | |
| Builder|Builder | rightJoinWhere(string $table, Closure|string $first, string $operator, string $second) Добавить условие «правое соединение где» к запросу. | |
| Builder|Builder | rightJoinSub(Closure|Builder|string $query, string $as, Closure|string $first, string|null $operator = null, string|null $second = null) Добавить правое соединение подзапроса к запросу. | |
| Builder|Builder | crossJoin(string $table, Closure|string|null $first = null, string|null $operator = null, string|null $second = null) Добавить условие «перекрёстное соединение» к запросу. | |
| JoinClause | newJoinClause(Builder $parentQuery, string $type, string $table) Получить новое условие соединения. | |
| void | mergeWheres(array $wheres, array $bindings) Объединить массив условий и значений связывания. | |
| $this | where(string|array|Closure $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) Определить, поддерживается ли данный оператор. | |
| Builder|Builder | orWhere(string|array|Closure $column, mixed $operator = null, mixed $value = null) Добавить условие «или где» к запросу. | |
| Builder|Builder | whereColumn(string|array $first, string|null $operator = null, string|null $second = null, string|null $boolean = 'and') Добавить условие «где» с сравнением двух столбцов к запросу. | |
| Builder|Builder | orWhereColumn(string|array $first, string|null $operator = null, string|null $second = null) Добавить условие «или где» с сравнением двух столбцов к запросу. | |
| $this | whereRaw(string $sql, mixed $bindings = [], string $boolean = 'and') Добавить сырое условие «где» к запросу. | |
| Builder|Builder | orWhereRaw(string $sql, mixed $bindings = []) Добавить сырое условие «или где» к запросу. | |
| $this | whereIn(string $column, mixed $values, string $boolean = 'and', bool $not = false) Добавить условие «где в» к запросу. | |
| Builder|Builder | orWhereIn(string $column, mixed $values) Добавить условие «или где в» к запросу. | |
| Builder|Builder | whereNotIn(string $column, mixed $values, string $boolean = 'and') Добавить условие «где не в» к запросу. | |
| Builder|Builder | orWhereNotIn(string $column, mixed $values) Добавить условие «или где не в» к запросу. | |
| $this | whereInSub(string $column, Closure $callback, string $boolean, bool $not) Добавить условие «где в» с подзапросом к запросу. | |
| $this | whereInExistingQuery(string $column, Builder|Builder $query, string $boolean, bool $not) Добавить внешний подзапрос к запросу. | |
| $this | whereIntegerInRaw(string $column, Arrayable|array $values, string $boolean = 'and', bool $not = false) Добавить условие «где в сырой» для целых значений в запрос. |
| $this | whereIntegerNotInRaw(string $column, Arrayable|array $values, string $boolean = 'and') Добавить условие «where not in raw» для целых значений в запрос. | |
| $this | whereNull(string|array $columns, string $boolean = 'and', bool $not = false) Добавить условие «where null» в запрос. | |
| Builder|Builder | orWhereNull(string $column) Добавить условие «or where null» в запрос. | |
| Builder|Builder | whereNotNull(string $column, string $boolean = 'and') Добавить условие «where not null» в запрос. | |
| $this | whereBetween(string $column, array $values, string $boolean = 'and', bool $not = false) Добавить условие where between в запрос. | |
| Builder|Builder | orWhereBetween(string $column, array $values) Добавить условие or where between в запрос. | |
| Builder|Builder | whereNotBetween(string $column, array $values, string $boolean = 'and') Добавить условие where not between в запрос. | |
| Builder|Builder | orWhereNotBetween(string $column, array $values) Добавить условие or where not between в запрос. | |
| Builder|Builder | orWhereNotNull(string $column) Добавить условие «or where not null» в запрос. | |
| Builder|Builder | whereDate(string $column, string $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and') Добавить условие «where date» в запрос. | |
| Builder|Builder | orWhereDate(string $column, string $operator, DateTimeInterface|string|null $value = null) Добавить условие «or where date» в запрос. | |
| Builder|Builder | whereTime(string $column, string $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and') Добавить условие «where time» в запрос. | |
| Builder|Builder | orWhereTime(string $column, string $operator, DateTimeInterface|string|null $value = null) Добавить условие «or where time» в запрос. | |
| Builder|Builder | whereDay(string $column, string $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and') Добавить условие «where day» в запрос. | |
| Builder|Builder | orWhereDay(string $column, string $operator, DateTimeInterface|string|null $value = null) Добавить условие «or where day» в запрос. | |
| Builder|Builder | whereMonth(string $column, string $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and') Добавить условие «where month» в запрос. | |
| Builder|Builder | orWhereMonth(string $column, string $operator, DateTimeInterface|string|null $value = null) Добавить условие «or where month» в запрос. | |
| Builder|Builder | whereYear(string $column, string $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and') Добавить условие «where year» в запрос. | |
| Builder|Builder | orWhereYear(string $column, string $operator, DateTimeInterface|string|int|null $value = null) Добавить условие «or where year» в запрос. | |
| $this | addDateBasedWhere(string $type, string $column, string $operator, mixed $value, string $boolean = 'and') Добавить условие, основанное на дате (год, месяц, день, время), в запрос. | |
| Builder|Builder | whereNested(Closure $callback, string $boolean = 'and') Добавить вложенное условие where в запрос. | |
| Builder | forNestedWhere() Создать новый экземпляр запроса для вложенного условия where. | |
| $this | addNestedWhereQuery(Builder|Builder $query, string $boolean = 'and') Добавить другой билдер запроса как вложенное условие where к билдеру запроса. | |
| $this | whereSub(string $column, string $operator, Closure $callback, string $boolean) Добавить полный подзапрос в запрос. | |
| $this | whereExists(Closure $callback, string $boolean = 'and', bool $not = false) Добавить условие exists в запрос. | |
| Builder|Builder | orWhereExists(Closure $callback, bool $not = false) Добавить условие or exists в запрос. | |
| Builder|Builder | whereNotExists(Closure $callback, string $boolean = 'and') Добавить условие where not exists в запрос. |
| Builder|Builder | orWhereNotExists(Closure $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 | 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» для запроса. | |
| void | addDynamic(string $segment, string $connector, array $parameters, int $index) Добавить отдельное динамическое условие «where» в запрос. | |
| $this | groupBy(array ...$groups) Добавить условие «group by» к запросу. | |
| $this | having(string $column, string|null $operator = null, string|null $value = null, string $boolean = 'and') Добавить условие «having» к запросу. | |
| Builder|Builder | orHaving(string $column, string|null $operator = null, string|null $value = null) Добавить условие «or having» к запросу. | |
| Builder|Builder | havingBetween(string $column, array $values, string $boolean = 'and', bool $not = false) Добавить условие «having between» к запросу. | |
| $this | havingRaw(string $sql, array $bindings = [], string $boolean = 'and') Добавить сырое условие «having» к запросу. | |
| Builder|Builder | orHavingRaw(string $sql, array $bindings = []) Добавить сырое условие «or having» к запросу. | |
| $this | orderBy(string $column, string $direction = 'asc') Добавить условие «order by» к запросу. | |
| $this | orderByDesc(string $column) Добавить условие «order by» по убыванию к запросу. | |
| Builder|Builder | latest(string $column = 'created_at') Добавить условие «order by» для временной метки к запросу. | |
| Builder|Builder | oldest(string $column = 'created_at') Добавить условие «order by» для временной метки к запросу. | |
| $this | inRandomOrder(string $seed = '') Расположить результаты запроса в случайном порядке. | |
| $this | orderByRaw(string $sql, array $bindings = []) Добавить сырое условие «order by» к запросу. | |
| Builder|Builder | skip(int $value) Псевдоним для установки значения «смещения» запроса. | |
| $this | offset(int $value) Установить значение «смещения» запроса. | |
| Builder|Builder | take(int $value) Псевдоним для установки значения «лимит» запроса. | |
| $this | limit(int $value) Установить значение «лимит» запроса. | |
| Builder|Builder | forPage(int $page, int $perPage = 15) Установить лимит и смещение для заданной страницы. | |
| Builder|Builder | forPageBeforeId(int $perPage = 15, int|null $lastId = 0, string $column = 'id') Ограничить запрос предыдущей «страницей» результатов перед заданным ID. | |
| Builder|Builder | forPageAfterId(int $perPage = 15, int|null $lastId = 0, string $column = 'id') Ограничить запрос следующей «страницей» результатов после заданного ID. | |
| array | removeExistingOrdersFor(string $column) Получить массив со всеми удаленными заказами с заданным столбцом. | |
| Builder|Builder | union(Builder|Closure $query, bool $all = false) Добавить оператор объединения в запрос. | |
| Builder|Builder | unionAll(Builder|Closure $query) Добавить оператор объединения ALL в запрос. | |
| $this | lock(string|bool $value = true) Заблокировать выбранные строки в таблице. | |
| Builder | lockForUpdate() Заблокировать выбранные строки в таблице для обновления. |
| Builder | sharedLock() Заблокировать выбранные строки в таблице по чтению. | |
| string | toSql() Получить SQL-представление запроса. | |
| mixed|Builder | find(int|string $id, array $columns = ['*']) Выполнить запрос для получения одной записи по ID. | |
| mixed | value(string $column) Получить значение одного столбца из первого результата запроса. | |
| Collection | get(array|string $columns = ['*']) Выполнить запрос в качестве оператора "select". | |
| array | runSelect() Выполнить запрос в качестве оператора "select" для подключения. | |
| LengthAwarePaginator | paginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int|null $page = null) Разбить заданный запрос на страницы с помощью простого пагинатора. | |
| Paginator | simplePaginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int|null $page = null) Получить пагинатор, поддерживающий только простые ссылки "Далее" и "Назад". | |
| int | getCountForPagination(array $columns = ['*']) Получить количество всех записей для пагинатора. | |
| array | runPaginationCountQuery(array $columns = ['*']) Выполнить запрос подсчёта для пагинации. | |
| array | withoutSelectAliases(array $columns) Удалить псевдонимы столбцов, так как они нарушат запросы подсчёта. | |
| Generator | cursor() Получить генератор для данного запроса. | |
| bool | chunkById(int $count, callable $callback, string $column = 'id', string|null $alias = null) Разбить результаты запроса на части по сравниванию числовых идентификаторов. | |
| void | enforceOrderBy() Выбросить исключение, если у запроса нет условия orderBy. | |
| Collection | pluck(string $column, string|null $key = null) Получить массив со значениями заданного столбца. | |
| string|null | stripTableForPluck(string $column) Удалить имя таблицы или псевдоним из идентификатора столбца. | |
| Collection | pluckFromObjectColumn(array $queryResult, string $column, string $key) Извлечь значения столбцов из строк, представленных как объекты. | |
| Collection | pluckFromArrayColumn(array $queryResult, string $column, string $key) Извлечь значения столбцов из строк, представленных как массивы. | |
| string | implode(string $column, string $glue = '') Объединить значения заданного столбца в строку. | |
| bool | exists() Определить, существуют ли какие-либо строки для текущего запроса. | |
| bool | doesntExist() Определить, не существует ли строк для текущего запроса. | |
| int | count(string $columns = '*') Получить результат "count" запроса. | |
| mixed | min(string $column) Получить минимальное значение заданного столбца. | |
| mixed | max(string $column) Получить максимальное значение заданного столбца. | |
| mixed | sum(string $column) Получить сумму значений заданного столбца. | |
| mixed | avg(string $column) Получить среднее значение значений заданного столбца. | |
| mixed | average(string $column) Псевдоним для метода "avg". | |
| mixed | aggregate(string $function, array $columns = ['*']) Выполнить агрегатную функцию на базе данных. | |
| float|int | numericAggregate(string $function, array $columns = ['*']) Выполнить числовую агрегатную функцию на базе данных. | |
| $this | setAggregate(string $function, array $columns) Установить свойство агрегата без выполнения запроса. | |
| mixed | onceWithColumns(array $columns, callable $callback) Выполнить заданный обратный вызов при выборе заданных столбцов. | |
| bool | insert(array $values) Вставить новую запись в базу данных. | |
| int | insertOrIgnore(array $values) Вставить новую запись в базу данных, игнорируя ошибки. | |
| int | insertGetId(array $values, string|null $sequence = null) Вставить новую запись и получить значение первичного ключа. | |
| bool | insertUsing(array $columns, Closure|Builder|string $query) Вставить новые записи в таблицу с помощью подзапроса. | |
| int | update(array $values) Обновить запись в базе данных. | |
| bool | updateOrInsert(array $attributes, array $values = []) Вставить или обновить запись, соответствующую атрибутам, и заполнить ее значениями. | |
| int | increment(string $column, float|int $amount = 1, array $extra = []) Увеличить значение столбца на заданное количество. | |
| int | decrement(string $column, float|int $amount = 1, array $extra = []) Уменьшить значение столбца на заданное количество. | |
| int | delete(mixed $id = null) Удалить запись из базы данных. | |
| void | truncate() Выполнить оператор truncate для таблицы. | |
| Builder | newQuery() Получить новый экземпляр билдера запросов. | |
| Builder | forSubQuery() Создать новый экземпляр запроса для подзапроса. |
| Expression | raw(mixed $value) Создать необработанное выражение базы данных. | |
| массив | getBindings() Получить текущие значения связываемых параметров запроса в плоском массиве. | |
| массив | getRawBindings() Получить необработанный массив связываемых параметров. | |
| $this | setBindings(array $bindings, string $type = 'where') Установить связываемые параметры в билдере запроса. | |
| $this | addBinding(mixed $value, string $type = 'where') Добавить связываемый параметр к запросу. | |
| $this | mergeBindings(Builder $query) Слить массив связываемых параметров в наши связываемые параметры. | |
| массив | cleanBindings(array $bindings) Удалить все выражения из списка связываемых параметров. | |
| ConnectionInterface | getConnection() Получить экземпляр подключения к базе данных. | |
| Processor | getProcessor() Получить экземпляр процессора запросов базы данных. | |
| Grammar | getGrammar() Получить экземпляр синтаксического анализатора запросов. | |
| $this | useWritePdo() Использовать write pdo для запроса. | |
| Builder | cloneWithout(array $properties) Клонировать запрос без заданных свойств. | |
| Builder | cloneWithoutBindings(array $except) Клонировать запрос без заданных связываемых параметров. | |
| $this | dump() Вывести SQL и связываемые параметры. | |
| void | dd() Прервать выполнение и вывести SQL и связываемые параметры. |
Подробности
bool chunk(int $count, callable $callback)
Разбить результаты запроса на куски.
bool each(callable $callback, int $count = 1000)
Выполнить обратный вызов для каждого элемента с разбивкой на куски.
Модель|object|BuildsQueries|null first(array $columns = ['*'])
Выполнить запрос и получить первый результат.
mixed|$this when(mixed $value, callable $callback, callable|null $default = null)
Применить изменения запроса обратного вызова, если заданное "значение" истинно.
Builder tap(callable $callback)
Передать запрос в заданный обратный вызов.
mixed|$this unless(mixed $value, callable $callback, callable|null $default = null)
Применить изменения запроса обратного вызова, если заданное "значение" ложно.
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 mixed forwardCallTo(mixed $object, string $method, array $parameters)
Перенаправить вызов метода заданному объекту.
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 mixed __callStatic(string $method, array $parameters)
Динамически обрабатывать вызовы класса.
mixed __call(string $method, array $parameters)
Обработать динамические вызовы метода.
void __construct(ConnectionInterface $connection, Grammar $grammar = null, Processor $processor = null)
Создать новый экземпляр билдера запросов.
$this select(array|mixed $columns = ['*'])
Установить столбцы для выбора.
Builder|Builder selectSub(Closure|Builder|string $query, string $as)
Добавить выражение подзапроса в запрос.
Builder|Builder selectRaw(string $expression, array $bindings = [])
Добавить новое выражение "сырого" выбора в запрос.
Builder|Builder fromSub(Closure|Builder|string $query, string $as)
Делает "от" выборку из подзапроса.
Builder|Builder fromRaw(string $expression, mixed $bindings = [])
Добавить сырое условие from к запросу.
protected array parseSub(mixed $query)
Анализирует подзапрос в SQL и параметры.
$this addSelect(array|mixed $column)
Добавить новый столбец выбора в запрос.
$this distinct()
Принудительно возвращать только уникальные результаты.
$this from(string $table)
Установить таблицу, на которую направлен запрос.
$this join(string $table, Closure|string $first, string|null $operator = null, string|null $second = null, string $type = 'inner', bool $where = false)
Добавить условие объединения к запросу.
Builder|Builder joinWhere(string $table, Closure|string $first, string $operator, string $second, string $type = 'inner')
Добавить условие "join where" к запросу.
Builder|Builder joinSub(Closure|Builder|string $query, string $as, Closure|string $first, string|null $operator = null, string|null $second = null, string $type = 'inner', bool $where = false)
Добавить условие объединения с подзапросом к запросу.
Builder|Builder leftJoin(string $table, Closure|string $first, string|null $operator = null, string|null $second = null)
Добавить левое объединение к запросу.
Builder|Builder leftJoinWhere(string $table, Closure|string $first, string $operator, string $second)
Добавить условие "join where" к запросу.
Builder|Builder leftJoinSub(Closure|Builder|string $query, string $as, Closure|string $first, string|null $operator = null, string|null $second = null)
Добавить левое объединение с подзапросом к запросу.
Builder|Builder rightJoin(string $table, Closure|string $first, string|null $operator = null, string|null $second = null)
Добавить правое объединение к запросу.
Builder|Builder rightJoinWhere(string $table, Closure|string $first, string $operator, string $second)
Добавить условие "right join where" к запросу.
Builder|Builder rightJoinSub(Closure|Builder|string $query, string $as, Closure|string $first, string|null $operator = null, string|null $second = null)
Добавить правое соединение подзапроса к запросу.
Builder|Builder crossJoin(string $table, Closure|string|null $first = null, string|null $operator = null, string|null $second = null)
Добавить предложение «перекрёстное соединение» к запросу.
protected JoinClause newJoinClause(Builder $parentQuery, string $type, string $table)
Получить новое предложение соединения.
void mergeWheres(array $wheres, array $bindings)
Объединить массив предложений where и привязок.
$this where(string|array|Closure $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)
Определить, поддерживается ли данный оператор.
Builder|Builder orWhere(string|array|Closure $column, mixed $operator = null, mixed $value = null)
Добавить предложение «или где» к запросу.
Builder|Builder whereColumn(string|array $first, string|null $operator = null, string|null $second = null, string|null $boolean = 'and')
Добавить предложение «где» для сравнения двух столбцов к запросу.
Builder|Builder orWhereColumn(string|array $first, string|null $operator = null, string|null $second = null)
Добавить предложение «или где» для сравнения двух столбцов к запросу.
$this whereRaw(string $sql, mixed $bindings = [], string $boolean = 'and')
Добавить сырое предложение where к запросу.
Builder|Builder orWhereRaw(string $sql, mixed $bindings = [])
Добавить условие where или raw к запросу.
$this whereIn(string $column, mixed $values, string $boolean = 'and', bool $not = false)
Добавить условие "where in" к запросу.
Builder|Builder whereNotIn(string $column, mixed $values, string $boolean = 'and')
Добавить условие "where not in" к запросу.
Builder|Builder orWhereNotIn(string $column, mixed $values)
Добавить условие "or where not in" к запросу.
protected $this whereInSub(string $column, Closure $callback, string $boolean, bool $not)
Добавить условие where in с подзапросом к запросу.
protected $this whereInExistingQuery(string $column, Builder|Builder $query, string $boolean, bool $not)
Добавить внешний подзапрос к запросу.
$this whereIntegerInRaw(string $column, Arrayable|array $values, string $boolean = 'and', bool $not = false)
Добавить условие "where in raw" для целочисленных значений к запросу.
$this whereIntegerNotInRaw(string $column, Arrayable|array $values, string $boolean = 'and')
Добавить условие "where not in raw" для целочисленных значений к запросу.
$this whereNull(string|array $columns, string $boolean = 'and', bool $not = false)
Добавить условие "where null" к запросу.
Builder|Builder whereNotNull(string $column, string $boolean = 'and')
Добавить условие "where not null" к запросу.
$this whereBetween(string $column, array $values, string $boolean = 'and', bool $not = false)
Добавить условие where between к запросу.
Builder|Builder orWhereBetween(string $column, array $values)
Добавить условие or where between к запросу.
Builder|Builder whereNotBetween(string $column, array $values, string $boolean = 'and')
Добавить условие where not between в запрос.
Builder|Builder orWhereNotBetween(string $column, array $values)
Добавить условие or where not between в запрос.
Builder|Builder whereDate(string $column, string $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')
Добавить условие "where date" в запрос.
Builder|Builder orWhereDate(string $column, string $operator, DateTimeInterface|string|null $value = null)
Добавить условие "or where date" в запрос.
Builder|Builder whereTime(string $column, string $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')
Добавить условие "where time" в запрос.
Builder|Builder orWhereTime(string $column, string $operator, DateTimeInterface|string|null $value = null)
Добавить условие "or where time" в запрос.
Builder|Builder whereDay(string $column, string $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')
Добавить условие "where day" в запрос.
Builder|Builder orWhereDay(string $column, string $operator, DateTimeInterface|string|null $value = null)
Добавить условие "or where day" в запрос.
Builder|Builder whereMonth(string $column, string $operator, DateTimeInterface|string|null $value = null, string $boolean = 'and')
Добавить условие "where month" в запрос.
Builder|Builder orWhereMonth(string $column, string $operator, DateTimeInterface|string|null $value = null)
Добавить условие "or where month" в запрос.
Builder|Builder whereYear(string $column, string $operator, DateTimeInterface|string|int|null $value = null, string $boolean = 'and')
Добавить условие "где год" в запрос.
Builder|Builder orWhereYear(string $column, string $operator, DateTimeInterface|string|int|null $value = null)
Добавить условие "или где год" в запрос.
protected $this addDateBasedWhere(string $type, string $column, string $operator, mixed $value, string $boolean = 'and')
Добавить условие, основанное на дате (год, месяц, день, время), в запрос.
Builder|Builder whereNested(Closure $callback, string $boolean = 'and')
Добавить вложенное условие where в запрос.
Builder forNestedWhere()
Создать новый экземпляр запроса для вложенного условия where.
$this addNestedWhereQuery(Builder|Builder $query, string $boolean = 'and')
Добавить другой объект Query Builder как вложенное условие where к объекту Query Builder.
protected $this whereSub(string $column, string $operator, Closure $callback, string $boolean)
Добавить полное подзапрос в запрос.
$this whereExists(Closure $callback, string $boolean = 'and', bool $not = false)
Добавить условие exists в запрос.
Builder|Builder orWhereExists(Closure $callback, bool $not = false)
Добавить условие or exists в запрос.
Builder|Builder whereNotExists(Closure $callback, string $boolean = 'and')
Добавить условие 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 содержит" (JSON содержит).
$this orWhereJsonContains(string $column, mixed $value)
Добавляет в запрос условие "or where JSON содержит" (JSON содержит).
$this whereJsonDoesntContain(string $column, mixed $value, string $boolean = 'and')
Добавляет в запрос условие "where JSON не содержит" (JSON не содержит).
$this orWhereJsonDoesntContain(string $column, mixed $value)
Добавляет в запрос условие "or where JSON не содержит" (JSON не содержит).
$this whereJsonLength(string $column, mixed $operator, mixed $value = null, string $boolean = 'and')
Добавляет в запрос условие "where длина JSON" (длина JSON).
$this orWhereJsonLength(string $column, mixed $operator, mixed $value = null)
Добавляет в запрос условие "or where длина JSON" (длина JSON).
$this dynamicWhere(string $method, array $parameters)
Обрабатывает динамические условия "where" для запроса.
protected void addDynamic(string $segment, string $connector, array $parameters, int $index)
Добавляет одно динамическое условие where в запрос.
$this groupBy(array ...$groups)
Добавляет в запрос условие "group by".
$this having(string $column, string|null $operator = null, string|null $value = null, string $boolean = 'and')
Добавляет в запрос условие "having".
Builder|Builder orHaving(string $column, string|null $operator = null, string|null $value = null)
Добавляет в запрос условие "or having".
Builder|Builder havingBetween(string $column, array $values, string $boolean = 'and', bool $not = false)
Добавляет в запрос условие "having between".
$this havingRaw(string $sql, array $bindings = [], string $boolean = 'and')
Добавляет в запрос сырое условие having.
Builder|Builder orHavingRaw(string $sql, array $bindings = [])
Добавляет в запрос сырое условие or having.
$this orderBy(string $column, string $direction = 'asc')
Добавляет в запрос условие "order by".
$this orderByDesc(string $column)
Добавляет в запрос условие "order by" по убыванию.
Builder|Builder latest(string $column = 'created_at')
Добавить условие "упорядочить по" для временной метки в запрос.
Builder|Builder oldest(string $column = 'created_at')
Добавить условие "упорядочить по" для временной метки в запрос.
$this inRandomOrder(string $seed = '')
Расположить результаты запроса в случайном порядке.
$this orderByRaw(string $sql, array $bindings = [])
Добавить условие "упорядочить по" в сыром виде в запрос.
$this offset(int $value)
Установить значение «смещения» запроса.
$this limit(int $value)
Установить значение «предел» запроса.
Builder|Builder forPage(int $page, int $perPage = 15)
Установить предел и смещение для заданной страницы.
Builder|Builder forPageBeforeId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')
Ограничить запрос предыдущей «страницей» результатов до заданного ID.
Builder|Builder forPageAfterId(int $perPage = 15, int|null $lastId = 0, string $column = 'id')
Ограничить запрос следующей «страницей» результатов после заданного ID.
protected массив removeExistingOrdersFor(string $column)
Получить массив со всеми удаленными заказами с заданным столбцом.
Builder|Closure union(Builder|Closure $query, bool $all = false)
Добавить оператор объединения в запрос.
$this lock(string|bool $value = true)
Заблокировать выбранные строки в таблице.
Builder lockForUpdate()
Заблокировать выбранные строки в таблице для обновления.
Builder sharedLock()
Заблокировать выбранные строки в таблице по модели shared lock.
строка toSql()
Получить SQL-представление запроса.
смешанный|Builder find(int|string $id, array $columns = ['*'])
Выполнить запрос для получения одной записи по идентификатору.
смешанный value(string $column)
Получить значение отдельного столбца из первого результата запроса.
Коллекция get(array|string $columns = ['*'])
Выполнить запрос в качестве оператора «select».
protected массив runSelect()
Выполнить запрос как оператор «select» против подключения.
LengthAwarePaginator paginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int|null $page = null)
Разбить заданный запрос на страницы с помощью простого пагинатора.
Paginator simplePaginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int|null $page = null)
Получить пагинатор, поддерживающий только простые ссылки «следующая» и «предыдущая».
Это более эффективно для больших наборов данных и т. д.
целое число getCountForPagination(array $columns = ['*'])
Получить количество всех записей для пагинатора.
protected массив runPaginationCountQuery(array $columns = ['*'])
Выполнить запрос подсчёта для пагинации.
protected массив withoutSelectAliases(array $columns)
Удалить псевдонимы столбцов, так как они нарушат запросы подсчета.
Генератор cursor()
Получить генератор для данного запроса.
логическое значение chunkById(int $count, callable $callback, string $column = 'id', string|null $alias = null)
Разбить результаты запроса на куски, сравнивая числовые идентификаторы.
protected void enforceOrderBy()
Выбросить исключение, если в запросе нет условия orderBy.
Коллекция pluck(string $column, string|null $key = null)
Получить массив со значениями заданного столбца.
protected строка|null stripTableForPluck(string $column)
Удалить имя или псевдоним таблицы из идентификатора столбца.
protected Коллекция pluckFromObjectColumn(array $queryResult, string $column, string $key)
Извлечь значения столбцов из строк, представленных как объекты.
protected Коллекция pluckFromArrayColumn(array $queryResult, string $column, string $key)
Извлечь значения столбцов из строк, представленных как массивы.
строка implode(string $column, string $glue = '')
Объединить значения заданного столбца в строку.
bool exists()
Определить, существуют ли строки для текущего запроса.
bool doesntExist()
Определить, не существует ли строк для текущего запроса.
int count(string $columns = '*')
Получить результат "count" запроса.
mixed min(string $column)
Получить минимальное значение заданного столбца.
mixed max(string $column)
Получить максимальное значение заданного столбца.
mixed sum(string $column)
Получить сумму значений заданного столбца.
mixed avg(string $column)
Получить среднее значение значений заданного столбца.
mixed average(string $column)
Псевдоним для метода "avg".
mixed aggregate(string $function, array $columns = ['*'])
Выполнить агрегатную функцию в базе данных.
float|int numericAggregate(string $function, array $columns = ['*'])
Выполнить числовую агрегатную функцию в базе данных.
protected $this setAggregate(string $function, array $columns)
Установить свойство агрегирования без выполнения запроса.
protected mixed onceWithColumns(array $columns, callable $callback)
Выполнить заданный обратный вызов, выбирая заданные столбцы.
После выполнения обратного вызова столбцы сбрасываются до исходного значения.
bool insert(array $values)
Вставить новую запись в базу данных.
int insertOrIgnore(array $values)
Вставить новую запись в базу данных, игнорируя ошибки.
int insertGetId(array $values, string|null $sequence = null)
Вставить новую запись и получить значение первичного ключа.
bool insertUsing(array $columns, Closure|Builder|string $query)
Вставка новых записей в таблицу с использованием подзапроса.
int update(array $values)
Обновить запись в базе данных.
bool updateOrInsert(array $attributes, array $values = [])
Вставить или обновить запись, соответствующую атрибутам, и заполнить её значениями.
int increment(string $column, float|int $amount = 1, array $extra = [])
Увеличить значение столбца на заданную величину.
int decrement(string $column, float|int $amount = 1, array $extra = [])
Уменьшить значение столбца на заданную величину.
int delete(mixed $id = null)
Удалить запись из базы данных.
void truncate()
Выполнить операцию truncate для таблицы.
Билдер newQuery()
Получить новый экземпляр билдера запросов.
protected Билдер forSubQuery()
Создать новый экземпляр запроса для подзапроса.
Выражение raw(mixed $value)
Создать выражение для базы данных.
массив getBindings()
Получить текущие значения связей запроса в плоском массиве.
массив getRawBindings()
Получить массив исходных связей.
$this setBindings(массив $bindings, строка $type = 'where')
Установить связи в билдере запросов.
$this addBinding(смешанное $value, строка $type = 'where')
Добавить связь к запросу.
$this mergeBindings(Билдер $query)
Объединить массив связей в наши связи.
protected массив cleanBindings(массив $bindings)
Удалить все выражения из списка связей.
Интерфейс подключения getConnection()
Получить экземпляр подключения к базе данных.
Обработчик getProcessor()
Получить экземпляр обработчика запросов базы данных.
Грамматика getGrammar()
Получить экземпляр грамматики запроса.
$this useWritePdo()
Использовать pdo для записи запросов.
Билдер cloneWithout(массив $properties)
Клонировать запрос без указанных свойств.
Билдер cloneWithoutBindings(массив $except)
Клонировать запрос без указанных связей.
$this dump()
Вывести текущий SQL и связи.
пусто dd()
Завершить работу и вывести текущий SQL и связи.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.8/Illuminate/Database/Query/Builder.html