HasMany

class HasMany extends HasOneOrMany (View source)

Свойства

protected Builder	$query	Экземпляр билдера запросов Eloquent.	из Relation
protected Model	$parent	Экземпляр родительской модели.	из Relation
protected Model	$related	Экземпляр связанной модели.	из Relation
static protected bool	$constraints	Указывает, добавляет ли отношение ограничения.	из Relation
static protected array	$morphMap	Массив для сопоставления имен классов с их именами морфизма в базе данных.	из Relation
protected string	$foreignKey	Внешний ключ родительской модели.	из HasOneOrMany
protected string	$localKey	Локальный ключ родительской модели.	из HasOneOrMany

Методы

void	__construct(Builder $query, Model $parent, string $foreignKey, string $localKey) Создать новый экземпляр отношения один-к-одному или один-ко-многим.	из HasOneOrMany
void	addConstraints() Установить базовые ограничения на запрос отношения.	из HasOneOrMany
void	addEagerConstraints(array $models) Установить ограничения для жадного загрузки отношения.	из HasOneOrMany
array	initRelation(array $models, string $relation) Инициализировать отношение для набора моделей.
array	match(array $models, Collection $results, string $relation) Сопоставить загруженные с жадной загрузкой результаты с их родительскими элементами.
mixed	getResults() Получить результаты отношения.
Collection	getEager() Получить отношение для жадной загрузки.	из Relation
void	touch() Обновить метку времени для всех связанных моделей в рамках отношения.	из Relation
int	rawUpdate(array $attributes = []) Выполнить прямое обновление базового запроса.	из Relation
Builder	getRelationCountQuery(Builder $query, Builder $parent) Добавить ограничения для запроса подсчёта отношения.	из HasOneOrMany
static mixed	noConstraints(Closure $callback) Выполнить обратный вызов без ограничений на отношении.	из Relation
array	getKeys(array $models, string $key = null) Получить все первичные ключи для массива моделей.	из Relation
Builder	getQuery() Получить базовый запрос для отношения.	из Relation
Builder	getBaseQuery() Получить базовый объект построения запроса, управляющий объектом построения Eloquent.	из Relation
Model	getParent() Получить родительскую модель отношения.	из Relation
string	getQualifiedParentKeyName() Получить полностью квалифицированное имя родительского ключа.	из HasOneOrMany
Model	getRelated() Получить связанную модель отношения.	из Relation
string	createdAt() Получить имя столбца «created at».	из Relation
string	updatedAt() Получить имя столбца «updated at».	из Relation
string	relatedUpdatedAt() Получить имя столбца «updated at» связанной модели.	из Relation
string	wrap(string $value) Обернуть заданное значение с использованием грамматики родительского запроса.	из Relation
static array	morphMap(array $map = null, bool $merge = true) Установить или получить морф-справочник для полиморфных отношений.	из Relation
static array\|null	buildMorphMapFromModels(array $models = null) Создаёт таблично-ключевой массив из имён классов моделей.	из Relation
mixed	__call(string $method, array $parameters) Обработать вызовы динамических методов отношения.	из Relation
void	__clone() Выполнить принудительное клонирование объекта базового построения запроса при клонировании.	из Relation
Builder	getRelationCountQueryForSelfRelation(Builder $query, Builder $parent) Добавить ограничения для запроса подсчёта отношения на одной таблице.	из HasOneOrMany
string	getRelationCountHash() Получить хэш таблицы соединения отношения.	из HasOneOrMany
array	matchOne(array $models, Collection $results, string $relation) Сопоставить загруженные с жадной загрузкой результаты с их единственным родителем.	из HasOneOrMany
array	matchMany(array $models, Collection $results, string $relation) Сопоставить загруженные с жадной загрузкой результаты с их множеством родителей.	из HasOneOrMany

массив	matchOneOrMany(массив $models, Collection $results, строка $relation, строка $type) Сопоставить загруженные с жадностью результаты с их родительскими элементами во множественном числе.	из HasOneOrMany
смешанный	getRelationValue(массив $dictionary, строка $key, строка $type) Получить значение связи по типу один или много.	из HasOneOrMany
массив	buildDictionary(Collection $results) Создать словарь моделей, индексированный по внешнему ключу связи.	из HasOneOrMany
Модель\|ложь	save(Модель $model) Прикрепить экземпляр модели к родительской модели.	из HasOneOrMany
Collection\|массив	saveMany(Collection\|массив $models) Прикрепить коллекцию моделей к экземпляру родителя.	из HasOneOrMany
Collection\|Модель	findOrNew(смешанный $id, массив $columns = ['*']) Найти модель по её первичному ключу или вернуть новый экземпляр связанной модели.	из HasOneOrMany
Модель	firstOrNew(массив $attributes) Получить первую связанную модель, соответствующую атрибутам, или создать её.	из HasOneOrMany
Модель	firstOrCreate(массив $attributes) Получить первую связанную запись, соответствующую атрибутам, или создать её.	из HasOneOrMany
Модель	updateOrCreate(массив $attributes, массив $values = []) Создать или обновить связанную запись, соответствующую атрибутам, и заполнить её значениями.	из HasOneOrMany
Модель	create(массив $attributes) Создать новый экземпляр связанной модели.	из HasOneOrMany
массив	createMany(массив $records) Создать массив новых экземпляров связанной модели.	из HasOneOrMany
целое	update(массив $attributes) Выполнить обновление всех связанных моделей.	из HasOneOrMany
строка	getHasCompareKey() Получить ключ для сравнения с родительским ключом в запросе "has".	из HasOneOrMany
строка	getForeignKey() Получить внешний ключ для связи.	из HasOneOrMany
строка	getPlainForeignKey() Получить простой внешний ключ.	из HasOneOrMany
смешанный	getParentKey() Получить значение ключа родительского локального ключа.	из HasOneOrMany

Подробности

пустое __construct(Builder $query, Модель $parent, строка $foreignKey, строка $localKey)

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

Параметры

Builder	$query
Модель	$parent
строка	$foreignKey
строка	$localKey

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

пустое

пустое addConstraints()

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

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

пустое

пустое addEagerConstraints(массив $models)

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

Параметры

массив

$models

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

пустое

массив initRelation(массив $models, строка $relation)

Инициализировать связь для набора моделей.

Параметры

массив	$models
строка	$relation

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

массив

массив match(массив $models, Collection $results, строка $relation)

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

Параметры

массив	$models
Collection	$results
строка	$relation

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

массив

смешанный getResults()

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

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

смешанный

Collection getEager()

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

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

Collection

пустое touch()

Обновить все связанные модели для связи.

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

пустое

int rawUpdate(array $attributes = [])

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

Параметры

array

$attributes

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

int

Builder getRelationCountQuery(Builder $query, Builder $parent)

Добавить ограничения для запроса подсчёта отношений.

Параметры

Builder	$query
Builder	$parent

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

Builder

static mixed noConstraints(Closure $callback)

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

Параметры

Closure

$callback

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

mixed

protected array getKeys(array $models, string $key = null)

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

Параметры

array	$models
string	$key

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

array

Builder getQuery()

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

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

Builder

Builder getBaseQuery()

Получить базовую конструкцию запроса, управляющую Eloquent-конструкцией запроса.

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

Builder

Model getParent()

Получить родительскую модель отношения.

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

Model

string getQualifiedParentKeyName()

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

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

string

Model getRelated()

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

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

Model

string createdAt()

Получить имя столбца "created at".

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

string

string updatedAt()

Получить имя столбца "updated at".

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

string

string relatedUpdatedAt()

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

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

string

string wrap(string $value)

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

Параметры

string

$value

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

string

static array morphMap(array $map = null, bool $merge = true)

Установить или получить морф-отображение для полиморфных отношений.

Параметры

array	$map
bool	$merge

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

array

static protected array|null buildMorphMapFromModels(array $models = null)

Создаёт таблично-ключевой массив из имён классов моделей.

Параметры

array

$models

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

array|null

mixed __call(string $method, array $parameters)

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

Параметры

string	$method
array	$parameters

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

mixed

void __clone()

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

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

void

Builder getRelationCountQueryForSelfRelation(Builder $query, Builder $parent)

Добавить ограничения для запроса подсчёта отношений на одной таблице.

Параметры

Builder	$query
Builder	$parent

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

Builder

string getRelationCountHash()

Получить хэш таблицы соединения отношений.

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

string

array matchOne(array $models, Collection $results, string $relation)

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

Параметры

array	$models
Collection	$results
string	$relation

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

array

array matchMany(array $models, Collection $results, string $relation)

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

Параметры

array	$models
Collection	$results
string	$relation

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

array

protected array matchOneOrMany(array $models, Collection $results, string $relation, string $type)

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

Parameters

array	$models
Collection	$results
string	$relation
string	$type

Return Value

array

protected mixed getRelationValue(array $dictionary, string $key, string $type)

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

Parameters

array	$dictionary
string	$key
string	$type

Return Value

mixed

protected array buildDictionary(Collection $results)

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

Parameters

Collection

$results

Return Value

array

Model|false save(Model $model)

Присоединить экземпляр модели к родительской модели.

Parameters

Model

$model

Return Value

Model|false

Collection|array saveMany(Collection|array $models)

Присоединить коллекцию моделей к родительскому экземпляру.

Parameters

Collection|array

$models

Return Value

Collection|array

Collection|Model findOrNew(mixed $id, array $columns = ['*'])

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

Parameters

mixed	$id
array	$columns

Return Value

Collection|Model

Model firstOrNew(array $attributes)

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

Parameters

array

$attributes

Return Value

Model

Model firstOrCreate(array $attributes)

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

Parameters

array

$attributes

Return Value

Model

Model updateOrCreate(array $attributes, array $values = [])

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

Parameters

array	$attributes
array	$values

Return Value

Model

Model create(array $attributes)

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

Parameters

array

$attributes

Return Value

Model

array createMany(array $records)

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

Parameters

array

$records

Return Value

array

int update(array $attributes)

Выполнить обновление всех связанных моделей.

Parameters

array

$attributes

Return Value

int

string getHasCompareKey()

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

Return Value

string

string getForeignKey()

Получить внешний ключ для связи.

Return Value

string

string getPlainForeignKey()

Получить простой внешний ключ.

Return Value

string

mixed getParentKey()

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

Return Value

mixed

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.4/Illuminate/Database/Eloquent/Relations/HasMany.html