JoinClause

class JoinClause extends Builder (View source)

Свойства

статический защищённый массив	$macros	Зарегистрированные строковые макросы.	из Macroable
защищённый Connection	$connection	Экземпляр подключения к базе данных.	из Builder
защищённый Grammar	$grammar	Экземпляр синтаксического анализатора запросов к базе данных.	из Builder
защищённый Processor	$processor	Экземпляр постпроцессора запросов к базе данных.	из Builder
защищённый массив	$bindings	Текущие значения связей запроса.	из Builder
массив	$aggregate	Функция агрегирования и столбец для выполнения.	из Builder
массив	$columns	Столбцы, которые должны быть возвращены.	из Builder
булево значение	$distinct	Указывает, возвращает ли запрос различные результаты.	из Builder
строка	$from	Таблица, на которую нацелен запрос.	из Builder
массив	$joins	Соединения таблиц для запроса.	из Builder
массив	$wheres	Условия WHERE для запроса.	из Builder
массив	$groups	Группировки для запроса.	из Builder
массив	$havings	Условия HAVING для запроса.	из Builder
массив	$orders	Сортировка для запроса.	из Builder
целое число	$limit	Максимальное количество записей для возврата.	из Builder
целое число	$offset	Количество записей для пропуска.	из Builder
массив	$unions	Заявления объединения запросов.	из Builder
целое число	$unionLimit	Максимальное количество записей объединения для возврата.	из Builder
целое число	$unionOffset	Количество записей объединения для пропуска.	из Builder
массив	$unionOrders	Сортировка для запроса объединения.	из Builder
строка\|булево значение	$lock	Указывает, используется ли блокировка строк.	из Builder

protected array	$backups	Текущие резервные копии поля.	из Builder
protected array	$bindingBackups	Текущие резервные копии связывания.	из Builder
protected array	$operators	Все доступные операторы предложений.	из Builder
protected bool	$useWritePdo	Использовать write pdo для выбора.	из Builder
string	$type	Тип выполняемого соединения.
string	$table	Таблица, к которой присоединяется предложение о соединении.

Методы

static void	macro(string $name, callable $macro) Зарегистрировать пользовательский макрос.	из Macroable
static bool	hasMacro(string $name) Проверить, зарегистрирован ли макрос.	из Macroable
static mixed	__callStatic(string $method, array $parameters) Динамическая обработка вызовов класса.	из Macroable
mixed	__call(string $method, array $parameters) Динамическая обработка вызовов класса.	из Macroable
void	__construct(Builder $parentQuery, string $type, string $table) Создать новый экземпляр условия объединения.
$this	select(array\|mixed $columns = ['*']) Установить столбцы для выбора.	из Builder
Builder\|Builder	selectRaw(string $expression, array $bindings = []) Добавить новое выражение "сырого" выбора в запрос.	из Builder
Builder\|Builder	selectSub(Closure\|Builder\|string $query, string $as) Добавить подзапрос в запрос.	из Builder
$this	addSelect(array\|mixed $column) Добавить новый столбец выбора в запрос.	из Builder
$this	distinct() Принудительно вернуть только уникальные результаты.	из Builder
$this	from(string $table) Указать таблицу, на которую нацелен запрос.	из Builder
$this	join(string $table, string $one, string $operator = null, string $two = null, string $type = 'inner', bool $where = false) Добавить условие объединения к запросу.	из Builder
Builder\|Builder	joinWhere(string $table, string $one, string $operator, string $two, string $type = 'inner') Добавить условие "join where" к запросу.	из Builder
Builder\|Builder	leftJoin(string $table, string $first, string $operator = null, string $second = null) Добавить левое соединение к запросу.	из Builder

Builder\|Builder	leftJoinWhere(string $table, string $one, string $operator, string $two) Добавить условие "join where" к запросу.	из Builder
Builder\|Builder	rightJoin(string $table, string $first, string $operator = null, string $second = null) Добавить правое соединение к запросу.	из Builder
Builder\|Builder	rightJoinWhere(string $table, string $one, string $operator, string $two) Добавить условие "right join where" к запросу.	из Builder
Builder\|Builder	crossJoin(string $table, string $first = null, string $operator = null, string $second = null) Добавить условие "cross join" к запросу.	из Builder
Builder	when(bool $value, Closure $callback, Closure $default = null) Применить изменения запроса из обратного вызова, если заданное "значение" истинно.	из Builder
$this	where(string\|array\|Closure $column, string $operator = null, mixed $value = null, string $boolean = 'and') Добавить базовое условие where к запросу.	из Builder
$this	addArrayOfWheres(array $column, string $boolean, string $method = 'where') Добавить массив условий where к запросу.	из Builder
bool	invalidOperatorAndValue(string $operator, mixed $value) Определить, является ли заданная комбинация оператора и значения законной.	из Builder
Builder\|Builder	orWhere(Closure\|string $column, string $operator = null, mixed $value = null) Добавить условие "or where" к запросу.	из Builder
Builder\|Builder	whereColumn(string\|array $first, string\|null $operator = null, string\|null $second = null, string\|null $boolean = 'and') Добавить условие "where" с сравнением двух столбцов к запросу.	из Builder
Builder\|Builder	orWhereColumn(string\|array $first, string\|null $operator = null, string\|null $second = null) Добавить условие "or where" с сравнением двух столбцов к запросу.	из Builder

$this	whereRaw(string $sql, mixed $bindings = [], string $boolean = 'and') Добавить сырое условие where в запрос.	из Builder
Builder\|Builder	orWhereRaw(string $sql, array $bindings = []) Добавить сырое условие or where в запрос.	из Builder
$this	whereBetween(string $column, array $values, string $boolean = 'and', bool $not = false) Добавить условие where between в запрос.	из Builder
Builder\|Builder	orWhereBetween(string $column, array $values) Добавить условие or where between в запрос.	из Builder
Builder\|Builder	whereNotBetween(string $column, array $values, string $boolean = 'and') Добавить условие where not between в запрос.	из Builder
Builder\|Builder	orWhereNotBetween(string $column, array $values) Добавить условие or where not between в запрос.	из Builder
Builder\|Builder	whereNested(Closure $callback, string $boolean = 'and') Добавить вложенное условие where в запрос.	из Builder
Builder	forNestedWhere() Создать новый экземпляр запроса для вложенного условия where.	из Builder
$this	addNestedWhereQuery(Builder\|Builder $query, string $boolean = 'and') Добавить другой объект билдера запросов как вложенное условие where к билдеру запросов.	из Builder
$this	whereSub(string $column, string $operator, Closure $callback, string $boolean) Добавить полную подзапросную выборку в запрос.	из Builder
$this	whereExists(Closure $callback, string $boolean = 'and', bool $not = false) Добавить условие exists в запрос.	из Builder
Builder\|Builder	orWhereExists(Closure $callback, bool $not = false) Добавить условие or exists в запрос.	из Builder

Builder\|Builder	whereNotExists(Closure $callback, string $boolean = 'and') Добавить условие «не существует» в запрос.	из Builder
Builder\|Builder	orWhereNotExists(Closure $callback) Добавить условие «не существует» в запрос.	из Builder
$this	addWhereExistsQuery(Builder $query, string $boolean = 'and', bool $not = false) Добавить условие «существует» в запрос.	из Builder
$this	whereIn(string $column, mixed $values, string $boolean = 'and', bool $not = false) Добавить условие «входит в» в запрос.	из Builder
Builder\|Builder	orWhereIn(string $column, mixed $values) Добавить условие «или входит в» в запрос.	из Builder
Builder\|Builder	whereNotIn(string $column, mixed $values, string $boolean = 'and') Добавить условие «не входит в» в запрос.	из Builder
Builder\|Builder	orWhereNotIn(string $column, mixed $values) Добавить условие «или не входит в» в запрос.	из Builder
$this	whereInSub(string $column, Closure $callback, string $boolean, bool $not) Добавить условие «входит в» с подзапросом в запрос.	из Builder
$this	whereInExistingQuery(string $column, Builder\|Builder $query, string $boolean, bool $not) Добавить внешний подзапрос в запрос.	из Builder
$this	whereNull(string $column, string $boolean = 'and', bool $not = false) Добавить условие «равно null» в запрос.	из Builder
Builder\|Builder	orWhereNull(string $column) Добавить условие «или равно null» в запрос.	из Builder
Builder\|Builder	whereNotNull(string $column, string $boolean = 'and') Добавить условие «не равно null» в запрос.	из Builder

Builder\|Builder	orWhereNotNull(string $column) Добавить условие "или где не равно null" к запросу.	из Builder
Builder\|Builder	whereDate(string $column, string $operator, mixed $value = null, string $boolean = 'and') Добавить условие "где дата" к запросу.	из Builder
Builder\|Builder	orWhereDate(string $column, string $operator, string $value) Добавить условие "или где дата" к запросу.	из Builder
Builder\|Builder	whereTime(string $column, string $operator, int $value, string $boolean = 'and') Добавить условие "где время" к запросу.	из Builder
Builder\|Builder	orWhereTime(string $column, string $operator, int $value) Добавить условие "или где время" к запросу.	из Builder
Builder\|Builder	whereDay(string $column, string $operator, mixed $value = null, string $boolean = 'and') Добавить условие "где день" к запросу.	из Builder
Builder\|Builder	whereMonth(string $column, string $operator, mixed $value = null, string $boolean = 'and') Добавить условие "где месяц" к запросу.	из Builder
Builder\|Builder	whereYear(string $column, string $operator, mixed $value = null, string $boolean = 'and') Добавить условие "где год" к запросу.	из Builder
$this	addDateBasedWhere(string $type, string $column, string $operator, int $value, string $boolean = 'and') Добавить условие, основанное на дате (год, месяц, день, время), к запросу.	из Builder
array	prepareValueAndOperator(string $value, string $operator, bool $useDefault = false) Подготовить значение и оператор для условия where.	из Builder
$this	dynamicWhere(string $method, string $parameters) Обрабатывает динамические условия "where" для запроса.	из Builder
void	addDynamic(string $segment, string $connector, array $parameters, int $index) Добавить отдельное динамическое условие where в запрос.	из Builder

$this	groupBy(array $groups) Добавить условие "группировать по" в запрос.	из Builder
$this	having(string $column, string $operator = null, string $value = null, string $boolean = 'and') Добавить условие "having" в запрос.	из Builder
Builder\|Builder	orHaving(string $column, string $operator = null, string $value = null) Добавить условие "или having" в запрос.	из Builder
$this	havingRaw(string $sql, array $bindings = [], string $boolean = 'and') Добавить сырое условие "having" в запрос.	из Builder
Builder\|Builder	orHavingRaw(string $sql, array $bindings = []) Добавить сырое условие "или having" в запрос.	из Builder
$this	orderBy(string $column, string $direction = 'asc') Добавить условие "упорядочить по" в запрос.	из Builder
Builder\|Builder	latest(string $column = 'created_at') Добавить условие "упорядочить по времени" в запрос.	из Builder
Builder\|Builder	oldest(string $column = 'created_at') Добавить условие "упорядочить по времени" в запрос.	из Builder
$this	inRandomOrder(string $seed = '') Расположить результаты запроса в случайном порядке.	из Builder
$this	orderByRaw(string $sql, array $bindings = []) Добавить сырое условие "упорядочить по" в запрос.	из Builder
$this	offset(int $value) Установить значение "смещения" запроса.	из Builder
Builder\|Builder	skip(int $value) Псевдоним для установки значения "смещения" запроса.	из Builder
$this	limit(int $value) Установить значение "лимита" запроса.	из Builder
Builder\|Builder	take(int $value) Псевдоним для установки значения "лимита" запроса.	из Builder

Builder\|Builder	forPage(int $page, int $perPage = 15) Установите лимит и смещение для заданной страницы.	from Builder
Builder\|Builder	forPageAfterId(int $perPage = 15, int $lastId, string $column = 'id') Ограничьте запрос следующей «страницей» результатов после заданного ID.	from Builder
Builder\|Builder	union(Builder\|Closure $query, bool $all = false) Добавьте оператор объединения к запросу.	from Builder
Builder\|Builder	unionAll(Builder\|Closure $query) Добавьте оператор объединения со всеми результатами к запросу.	from Builder
$this	lock(bool $value = true) Заблокировать выбранные строки в таблице.	from Builder
Builder	lockForUpdate() Заблокировать выбранные строки в таблице для обновления.	from Builder
Builder	sharedLock() Заблокировать выбранные строки в таблице для совместного доступа.	from Builder
string	toSql() Получить SQL представление запроса.	from Builder
mixed\|Builder	find(int $id, array $columns = ['*']) Выполнить запрос для получения одной записи по ID.	from Builder
mixed	value(string $column) Получить значение одного столбца из первого результата запроса.	from Builder
stdClass\|array\|null	first(array $columns = ['*']) Выполнить запрос и получить первый результат.	from Builder
Collection	get(array $columns = ['*']) Выполнить запрос как оператор «select».	from Builder
array	runSelect() Выполнить запрос как оператор «select» против подключения.	from Builder

LengthAwarePaginator	paginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int\|null $page = null) Выполнить разбиение заданного запроса на страницы с помощью простого пагинатора.	from Builder
Paginator	simplePaginate(int $perPage = 15, array $columns = ['*'], string $pageName = 'page', int\|null $page = null) Получить пагинатор, поддерживающий только простые ссылки «Следующая» и «Предыдущая».	from Builder
int	getCountForPagination(array $columns = ['*']) Получить количество всех записей для пагинатора.	from Builder
void	backupFieldsForCount() Сохранить резервную копию и удалить некоторые поля для подсчёта страниц.	from Builder
array	clearSelectAliases(array $columns) Удалить псевдонимы столбцов, поскольку они нарушают запросы на подсчёт.	from Builder
void	restoreFieldsForCount() Восстановить некоторые поля после подсчёта страниц.	from Builder
Generator	cursor() Получить генератор для данного запроса.	from Builder
bool	chunk(int $count, callable $callback) Разбить результаты запроса на части.	from Builder
bool	chunkById(int $count, callable $callback, string $column = 'id', string $alias = null) Разбить результаты запроса на части по сравниванию числовых идентификаторов.	from Builder
bool	each(callable $callback, int $count = 1000) Выполнить функцию обратного вызова для каждого элемента, используя разбиение.	from Builder
Collection	pluck(string $column, string\|null $key = null) Получить массив со значениями заданного столбца.	from Builder
string\|null	stripTableForPluck(string $column) Удалить имя таблицы или псевдоним из идентификатора столбца.	from Builder
string	implode(string $column, string $glue = '') Объединить значения заданного столбца в строку.	from Builder
bool	exists() Определить, существуют ли какие-либо строки для текущего запроса.	from Builder
int	count(string $columns = '*') Получить результат «count» запроса.	from Builder

mixed	min(string $column) Получить минимальное значение заданного столбца.	из Builder
mixed	max(string $column) Получить максимальное значение заданного столбца.	из Builder
mixed	sum(string $column) Получить сумму значений заданного столбца.	из Builder
mixed	avg(string $column) Получить среднее значение значений заданного столбца.	из Builder
mixed	average(string $column) Псевдоним для метода "avg".	из Builder
mixed	aggregate(string $function, array $columns = ['*']) Выполнить агрегатную функцию в базе данных.	из Builder
float\|int	numericAggregate(string $function, array $columns = ['*']) Выполнить числовую агрегатную функцию в базе данных.	из Builder
bool	insert(array $values) Вставить новую запись в базу данных.	из Builder
int	insertGetId(array $values, string $sequence = null) Вставить новую запись и получить значение первичного ключа.	из Builder
int	update(array $values) Обновить запись в базе данных.	из Builder
bool	updateOrInsert(array $attributes, array $values = []) Вставить или обновить запись, соответствующую атрибутам, и заполнить её значениями.	из Builder
int	increment(string $column, int $amount = 1, array $extra = []) Увеличить значение столбца на заданную величину.	из Builder
int	decrement(string $column, int $amount = 1, array $extra = []) Уменьшить значение столбца на заданную величину.	из Builder
int	delete(mixed $id = null) Удалить запись из базы данных.	из Builder
void	truncate() Выполнить операцию truncate для таблицы.	из Builder
Builder	newQuery() Получить новый экземпляр билдера для добавления условий.
void	mergeWheres(array $wheres, array $bindings) Объединить массив условий и значений.	из Builder

массив	cleanBindings(массив $bindings) Удалить все выражения из списка связей.	из Builder
Выражение	raw(смешанное $value) Создать выражение базы данных в сыром виде.	из Builder
массив	getBindings() Получить текущие значения связей запроса в плоском массиве.	из Builder
массив	getRawBindings() Получить сырой массив связей.	из Builder
$this	setBindings(массив $bindings, строка $type = 'where') Установить связи в билдере запроса.	из Builder
$this	addBinding(смешанное $value, строка $type = 'where') Добавить связь к запросу.	из Builder
$this	mergeBindings(Builder $query) Объединить массив связей в наши связи.	из Builder
Интерфейс подключения	getConnection() Получить экземпляр подключения к базе данных.	из Builder
Обработчик	getProcessor() Получить экземпляр обработчика запросов базы данных.	из Builder
Грамматика	getGrammar() Получить экземпляр грамматики запроса.	из Builder
$this	useWritePdo() Использовать write pdo для запроса.	из Builder
$this	on(Closure\|строка $first, строка\|null $operator = null, строка\|null $second = null, строка $boolean = 'and') Добавить условие "on" к объединению.
JoinClause	orOn(Closure\|строка $first, строка\|null $operator = null, строка\|null $second = null) Добавить условие "or on" к объединению.

Подробности

static void macro(строка $name, callable $macro)

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

Параметры

строка	$name
callable	$macro

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

void

static bool hasMacro(строка $name)

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

Параметры

строка

$name

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

bool

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

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

Parameters

string	$method
array	$parameters

Return Value

mixed

Exceptions

BadMethodCallException

mixed __call(string $method, array $parameters)

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

Parameters

string	$method
array	$parameters

Return Value

mixed

Exceptions

BadMethodCallException

void __construct(Builder $parentQuery, string $type, string $table)

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

Parameters

Builder	$parentQuery
string	$type
string	$table

Return Value

void

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

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

Parameters

array|mixed

$columns

Return Value

$this

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

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

Parameters

string	$expression
array	$bindings

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

Exceptions

InvalidArgumentException

$this addSelect(array|mixed $column)

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

Parameters

array|mixed

$column

Return Value

$this

$this distinct()

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

Return Value

$this

$this from(string $table)

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

Parameters

string

$table

Return Value

$this

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

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

Parameters

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

Return Value

$this

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

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

END_OF_DOCUMENT_MARKER

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

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

Параметры

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

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

Builder|Builder

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

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

Параметры

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

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

Builder|Builder

Builder when(bool $value, Closure $callback, Closure $default = null)

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

Параметры

bool	$value
Closure	$callback
Closure	$default

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

Builder

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

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

Параметры

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

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

$this

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

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

Параметры

array	$column
string	$boolean
string	$method

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

$this

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

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

Параметры

string	$operator
mixed	$value

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

bool

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

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

Параметры

Closure\|string	$column
string	$operator
mixed	$value

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

Builder|Builder

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

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

Параметры

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

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

Builder|Builder

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

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

Параметры

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

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

Builder|Builder

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

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

Параметры

string	$sql
mixed	$bindings
string	$boolean

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

$this

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

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

Параметры

string	$sql
array	$bindings

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

Builder|Builder

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

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

Параметры

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

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

$this

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

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

Parameters

string	$column
array	$values

Return Value

Builder|Builder

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

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

Parameters

string	$column
array	$values
string	$boolean

Return Value

Builder|Builder

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

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

Parameters

string	$column
array	$values

Return Value

Builder|Builder

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

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

Parameters

Closure	$callback
string	$boolean

Return Value

Builder|Builder

Builder forNestedWhere()

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

Return Value

Builder

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

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

Parameters

Builder\|Builder	$query
string	$boolean

Return Value

$this

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

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

Parameters

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

Return Value

$this

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

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

Параметры

Closure	$callback
string	$boolean
bool	$not

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

$this

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

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

Параметры

Closure	$callback
bool	$not

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

Builder|Builder

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

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

Параметры

Closure	$callback
string	$boolean

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

Builder|Builder

Builder|Builder orWhereNotExists(Closure $callback)

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

Параметры

Closure

$callback

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

Builder|Builder

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

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

Параметры

Builder	$query
string	$boolean
bool	$not

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

$this

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

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

Параметры

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

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

$this

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

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

Параметры

string	$column
mixed	$values

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

Builder|Builder

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

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

Parameters

string	$column
mixed	$values
string	$boolean

Return Value

Builder|Builder

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

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

Parameters

string	$column
mixed	$values

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

$this

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

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

Parameters

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

Return Value

$this

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

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

Parameters

string	$column
string	$boolean
bool	$not

Return Value

$this

Builder|Builder orWhereNull(string $column)

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

Parameters

string

$column

Return Value

Builder|Builder

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

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

Parameters

string	$column
string	$boolean

Return Value

Builder|Builder

Builder|Builder orWhereNotNull(string $column)

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

Parameters

string

$column

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

string	$column
string	$operator
string	$value

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

string	$column
string	$operator
int	$value

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

Builder|Builder

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

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

Parameters

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

Return Value

$this

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

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

Parameters

string	$value
string	$operator
bool	$useDefault

Return Value

array

Exceptions

InvalidArgumentException

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

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

Parameters

string	$method
string	$parameters

Return Value

$this

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

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

Parameters

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

Return Value

void

$this groupBy(array $groups)

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

Parameters

array

$groups

Return Value

$this

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

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

Parameters

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

Return Value

$this

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

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

Parameters

string	$column
string	$operator
string	$value

Return Value

Builder|Builder

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

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

Parameters

string	$sql
array	$bindings
string	$boolean

Return Value

$this

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

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

Parameters

string	$sql
array	$bindings

Return Value

Builder|Builder

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

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

Parameters

string	$column
string	$direction

Return Value

$this

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

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

Parameters

string

$column

Return Value

Builder|Builder

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

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

Parameters

string

$column

Return Value

Builder|Builder

$this inRandomOrder(string $seed = '')

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

Parameters

string

$seed

Return Value

$this

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

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

Параметры

string	$sql
array	$bindings

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

$this

$this offset(int $value)

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

Параметры

int

$value

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

$this

Builder|Builder skip(int $value)

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

Параметры

int

$value

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

Builder|Builder

$this limit(int $value)

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

Параметры

int

$value

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

$this

Builder|Builder take(int $value)

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

Параметры

int

$value

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

Builder|Builder

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

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

Параметры

int	$page
int	$perPage

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

Builder|Builder

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

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

Параметры

int	$perPage
int	$lastId
string	$column

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

Builder|Builder

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

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

Параметры

Builder\|Closure	$query
bool	$all

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

Builder|Builder

Builder|Builder unionAll(Builder|Closure $query)

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

Параметры

Builder|Closure

$query

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

Builder|Builder

$this lock(bool $value = true)

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

Параметры

bool

$value

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

$this

Builder lockForUpdate()

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

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

Builder

Builder sharedLock()

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

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

Builder

string toSql()

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

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

string

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

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

Параметры

int	$id
array	$columns

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

mixed|Builder

mixed value(string $column)

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

Параметры

string

$column

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

mixed

stdClass|array|null first(array $columns = ['*'])

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

Параметры

array

$columns

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

stdClass|array|null

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

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

Параметры

array

$columns

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

Collection

protected array runSelect()

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

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

array

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

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

Параметры

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

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

LengthAwarePaginator

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

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

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

Параметры

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

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

Paginator

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

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

Параметры

array

$columns

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

int

protected void backupFieldsForCount()

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

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

void

protected array clearSelectAliases(array $columns)

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

Параметры

array

$columns

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

array

protected void restoreFieldsForCount()

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

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

void

Generator cursor()

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

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

Generator

bool chunk(int $count, callable $callback)

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

Параметры

int	$count
callable	$callback

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

bool

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

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

Параметры

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

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

bool

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

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

Параметры

callable	$callback
int	$count

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

bool

Исключения

RuntimeException

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

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

Параметры

string	$column
string\|null	$key

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

Collection

protected string|null stripTableForPluck(string $column)

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

Параметры

string

$column

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

string|null

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

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

Параметры

string	$column
string	$glue

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

string

bool exists()

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

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

bool

int count(string $columns = '*')

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

Параметры

string

$columns

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

int

mixed min(string $column)

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

Параметры

string

$column

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

mixed

mixed max(string $column)

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

Параметры

string

$column

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

mixed

mixed sum(string $column)

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

Параметры

string

$column

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

mixed

mixed avg(string $column)

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

Параметры

string

$column

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

mixed

mixed average(string $column)

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

Параметры

string

$column

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

mixed

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

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

Параметры

string	$function
array	$columns

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

mixed

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

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

Параметры

string	$function
array	$columns

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

float|int

bool insert(array $values)

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

Параметры

array

$values

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

bool

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

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

Параметры

array	$values
string	$sequence

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

int

int update(array $values)

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

Параметры

array

$values

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

int

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

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

Параметры

array	$attributes
array	$values

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

bool

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

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

Параметры

string	$column
int	$amount
array	$extra

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

int

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

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

Параметры

string	$column
int	$amount
array	$extra

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

int

int delete(mixed $id = null)

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

Параметры

mixed

$id

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

int

void truncate()

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

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

void

Builder newQuery()

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

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

Builder

void mergeWheres(array $wheres, array $bindings)

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

Параметры

массив	$wheres
массив	$bindings

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

void

protected array cleanBindings(array $bindings)

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

Параметры

массив

$bindings

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

массив

Выражение raw(mixed $value)

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

Параметры

mixed

$value

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

Выражение

array getBindings()

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

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

массив

array getRawBindings()

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

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

массив

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

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

Параметры

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

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

$this

Исключения

ИсключениеНекорректногоАргумента

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

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

Параметры

mixed	$value
строка	$type

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

$this

Исключения

ИсключениеНекорректногоАргумента

$this mergeBindings(Билдeр $query)

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

Параметры

Билдeр

$query

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

$this

ИнтерфейсПодключения getConnection()

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

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

ИнтерфейсПодключения

Обработчик getProcessor()

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

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

Обработчик

Грамматика getGrammar()

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

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

Грамматика

$this useWritePdo()

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

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

$this

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

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

Условие "on" может быть цепочкой, например:

$join->on('contacts.user_id', '=', 'users.id') ->on('contacts.info_id', '=', 'info.id')

что приведет к следующему SQL:

on contacts.user_id = users.id and contacts.info_id = info.id

Параметры

Closure\|string	$first
string\|null	$operator
string\|null	$second
string	$boolean

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

$this

Исключения

InvalidArgumentException

Присоединение orOn(Closure|string $first, string|null $operator = null, string|null $second = null)

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

Параметры

Closure\|string	$first
string\|null	$operator
string\|null	$second

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

Присоединение

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