HasRelationships

trait HasRelationships (View source)

Свойства

protected массив	$relations	Загруженные отношения для модели.
protected массив	$touches	Отношения, которые должны быть изменены при сохранении.
static массив	$manyMethods	Методы отношений «многие ко многим».
static protected массив	$relationResolvers	Обратные вызовы разрешения отношений.

Методы

static void	resolveRelationUsing(string $name, Closure $callback) Определить решатель динамических отношений.
HasOne	hasOne(string $related, string\|null $foreignKey = null, string\|null $localKey = null) Определить отношение «один-к-одному».
HasOne	newHasOne(Builder $query, Model $parent, string $foreignKey, string $localKey) Создать новое отношение HasOne.
HasOneThrough	hasOneThrough(string $related, string $through, string\|null $firstKey = null, string\|null $secondKey = null, string\|null $localKey = null, string\|null $secondLocalKey = null) Определить отношение «один-через-одного».
HasOneThrough	newHasOneThrough(Builder $query, Model $farParent, Model $throughParent, string $firstKey, string $secondKey, string $localKey, string $secondLocalKey) Создать новое отношение HasOneThrough.
MorphOne	morphOne(string $related, string $name, string\|null $type = null, string\|null $id = null, string\|null $localKey = null) Определить полиморфное отношение «один-к-одному».
MorphOne	newMorphOne(Builder $query, Model $parent, string $type, string $id, string $localKey) Создать новое отношение MorphOne.
BelongsTo	belongsTo(string $related, string\|null $foreignKey = null, string\|null $ownerKey = null, string\|null $relation = null) Определить обратное отношение «один-к-одному» или «многие-к-одному».
BelongsTo	newBelongsTo(Builder $query, Model $child, string $foreignKey, string $ownerKey, string $relation) Создать новое отношение BelongsTo.
MorphTo	morphTo(string\|null $name = null, string\|null $type = null, string\|null $id = null, string\|null $ownerKey = null) Определить полиморфное, обратное отношение «один-к-одному» или «многие-к-одному».
MorphTo	morphEagerTo(string $name, string $type, string $id, string $ownerKey) Определить полиморфное, обратное отношение «один-к-одному» или «многие-к-одному».
MorphTo	morphInstanceTo(string $target, string $name, string $type, string $id, string $ownerKey) Определить полиморфное, обратное отношение «один-к-одному» или «многие-к-одному».
MorphTo	newMorphTo(Builder $query, Model $parent, string $foreignKey, string $ownerKey, string $type, string $relation) Создать новое отношение MorphTo.
static string	getActualClassNameForMorph(string $class) Получить фактическое имя класса для данного класса morph.
string	guessBelongsToRelation() Угадать имя отношения «принадлежит к».
HasMany	hasMany(string $related, string\|null $foreignKey = null, string\|null $localKey = null) Определить отношение «один-ко-многим».
HasMany	newHasMany(Builder $query, Model $parent, string $foreignKey, string $localKey) Создать новое отношение HasMany.
HasManyThrough	hasManyThrough(string $related, string $through, string\|null $firstKey = null, string\|null $secondKey = null, string\|null $localKey = null, string\|null $secondLocalKey = null) Определить отношение «многие-через-одного».
HasManyThrough	newHasManyThrough(Builder $query, Model $farParent, Model $throughParent, string $firstKey, string $secondKey, string $localKey, string $secondLocalKey) Создать новое отношение HasManyThrough.
MorphMany	morphMany(string $related, string $name, string\|null $type = null, string\|null $id = null, string\|null $localKey = null) Определить полиморфное отношение «один-ко-многим».
MorphMany	newMorphMany(Builder $query, Model $parent, string $type, string $id, string $localKey) Создать новое отношение MorphMany.
BelongsToMany	belongsToMany(string $related, string\|null $table = null, string\|null $foreignPivotKey = null, string\|null $relatedPivotKey = null, string\|null $parentKey = null, string\|null $relatedKey = null, string\|null $relation = null) Определить отношение «многие-ко-многим».
BelongsToMany	newBelongsToMany(Builder $query, Model $parent, string $table, string $foreignPivotKey, string $relatedPivotKey, string $parentKey, string $relatedKey, string\|null $relationName = null) Создать новое отношение BelongsToMany.
MorphToMany	morphToMany(string $related, string $name, string\|null $table = null, string\|null $foreignPivotKey = null, string\|null $relatedPivotKey = null, string\|null $parentKey = null, string\|null $relatedKey = null, bool $inverse = false) Определить полиморфное отношение «многие-ко-многим».
MorphToMany	newMorphToMany(Builder $query, Model $parent, string $name, string $table, string $foreignPivotKey, string $relatedPivotKey, string $parentKey, string $relatedKey, string\|null $relationName = null, bool $inverse = false) Создать новое отношение MorphToMany.

MorphToMany	morphedByMany(string $related, string $name, string\|null $table = null, string\|null $foreignPivotKey = null, string\|null $relatedPivotKey = null, string\|null $parentKey = null, string\|null $relatedKey = null) Определить полиморфное, обратное многие-ко-многим отношение.
string\|null	guessBelongsToManyRelation() Получить имя отношения belongsToMany.
string	joiningTable(string $related, Model\|null $instance = null) Получить имя таблицы соединения для отношения многие-ко-многим.
string	joiningTableSegment() Получить часть имени промежуточной таблицы для отношений belongsToMany.
bool	touches(string $relation) Определить, касается ли модель заданного отношения.
void	touchOwners() Обновить связанные отношения модели.
array	getMorphs(string $name, string $type, string $id) Получить столбцы полиморфного отношения.
string	getMorphClass() Получить имя класса для полиморфных отношений.
mixed	newRelatedInstance(string $class) Создать новый экземпляр модели для связанной модели.
array	getRelations() Получить все загруженные отношения для экземпляра.
mixed	getRelation(string $relation) Получить указанное отношение.
bool	relationLoaded(string $key) Определить, загружено ли данное отношение.
$this	setRelation(string $relation, mixed $value) Установить заданное отношение для модели.
$this	unsetRelation(string $relation) Удалить загруженное отношение.
$this	setRelations(array $relations) Установить весь массив отношений для модели.
$this	withoutRelations() Создать копию экземпляра и удалить все загруженные отношения.
$this	unsetRelations() Удалить все загруженные отношения для экземпляра.
array	getTouchedRelations() Получить отношения, которые обновляются при сохранении.
$this	setTouchedRelations(array $touches) Установить отношения, которые обновляются при сохранении.

Details

static void resolveRelationUsing(string $name, Closure $callback)

Определить динамический решатель отношений.

Parameters

string	$name
Closure	$callback

Return Value

void

HasOne hasOne(string $related, string|null $foreignKey = null, string|null $localKey = null)

Определить отношение один-к-одному.

Parameters

string	$related
string\|null	$foreignKey
string\|null	$localKey

Return Value

HasOne

protected HasOne newHasOne(Builder $query, Model $parent, string $foreignKey, string $localKey)

Инициализировать новое отношение HasOne.

Parameters

Builder	$query
Model	$parent
string	$foreignKey
string	$localKey

Return Value

HasOne

HasOneThrough hasOneThrough(string $related, string $through, string|null $firstKey = null, string|null $secondKey = null, string|null $localKey = null, string|null $secondLocalKey = null)

Определить отношение has-one-through.

Parameters

string	$related
string	$through
string\|null	$firstKey
string\|null	$secondKey
string\|null	$localKey
string\|null	$secondLocalKey

Return Value

HasOneThrough

protected HasOneThrough newHasOneThrough(Builder $query, Model $farParent, Model $throughParent, string $firstKey, string $secondKey, string $localKey, string $secondLocalKey)

Инициализировать новое отношение HasOneThrough.

Parameters

Builder	$query
Model	$farParent
Model	$throughParent
string	$firstKey
string	$secondKey
string	$localKey
string	$secondLocalKey

Return Value

HasOneThrough

MorphOne morphOne(string $related, string $name, string|null $type = null, string|null $id = null, string|null $localKey = null)

Определить полиморфное отношение один-к-одному.

Parameters

string	$related
string	$name
string\|null	$type
string\|null	$id
string\|null	$localKey

Return Value

MorphOne

END_OF_DOCUMENT_MARKER

protected MorphOne newMorphOne(Builder $query, Model $parent, string $type, string $id, string $localKey)

Создать новое отношение MorphOne.

Параметры

Builder	$query
Model	$parent
string	$type
string	$id
string	$localKey

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

MorphOne

BelongsTo belongsTo(string $related, string|null $foreignKey = null, string|null $ownerKey = null, string|null $relation = null)

Определить обратное отношение один-к-одному или один-ко-многим.

Параметры

string	$related
string\|null	$foreignKey
string\|null	$ownerKey
string\|null	$relation

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

BelongsTo

protected BelongsTo newBelongsTo(Builder $query, Model $child, string $foreignKey, string $ownerKey, string $relation)

Создать новое отношение BelongsTo.

Параметры

Builder	$query
Model	$child
string	$foreignKey
string	$ownerKey
string	$relation

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

BelongsTo

MorphTo morphTo(string|null $name = null, string|null $type = null, string|null $id = null, string|null $ownerKey = null)

Определить полиморфное обратное отношение один-к-одному или один-ко-многим.

Параметры

string\|null	$name
string\|null	$type
string\|null	$id
string\|null	$ownerKey

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

MorphTo

protected MorphTo morphEagerTo(string $name, string $type, string $id, string $ownerKey)

Определить полиморфное обратное отношение один-к-одному или один-ко-многим.

Параметры

string	$name
string	$type
string	$id
string	$ownerKey

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

MorphTo

protected MorphTo morphInstanceTo(string $target, string $name, string $type, string $id, string $ownerKey)

Определить полиморфное обратное отношение один-к-одному или один-ко-многим.

Параметры

string	$target
string	$name
string	$type
string	$id
string	$ownerKey

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

MorphTo

protected MorphTo newMorphTo(Builder $query, Model $parent, string $foreignKey, string $ownerKey, string $type, string $relation)

Создать новое полиморфное отношение MorphTo.

Параметры

Builder	$query
Model	$parent
string	$foreignKey
string	$ownerKey
string	$type
string	$relation

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

MorphTo

static string getActualClassNameForMorph(string $class)

Получить фактическое имя класса для заданного класса morph.

Параметры

string

$class

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

string

protected string guessBelongsToRelation()

Угадать имя отношения "belongs to".

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

string

HasMany hasMany(string $related, string|null $foreignKey = null, string|null $localKey = null)

Определить отношение один-ко-многим.

Параметры

string	$related
string\|null	$foreignKey
string\|null	$localKey

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

HasMany

protected HasMany newHasMany(Builder $query, Model $parent, string $foreignKey, string $localKey)

Создать новое отношение HasMany.

Параметры

Builder	$query
Model	$parent
string	$foreignKey
string	$localKey

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

HasMany

HasManyThrough hasManyThrough(string $related, string $through, string|null $firstKey = null, string|null $secondKey = null, string|null $localKey = null, string|null $secondLocalKey = null)

Определить отношение has-many-through.

Параметры

string	$related
string	$through
string\|null	$firstKey
string\|null	$secondKey
string\|null	$localKey
string\|null	$secondLocalKey

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

HasManyThrough

END_OF_DOCUMENT_MARKER

protected HasManyThrough newHasManyThrough(Builder $query, Model $farParent, Model $throughParent, string $firstKey, string $secondKey, string $localKey, string $secondLocalKey)

Создать новое отношение HasManyThrough.

Параметры

Builder	$query
Model	$farParent
Model	$throughParent
string	$firstKey
string	$secondKey
string	$localKey
string	$secondLocalKey

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

HasManyThrough

MorphMany morphMany(string $related, string $name, string|null $type = null, string|null $id = null, string|null $localKey = null)

Определить полиморфное отношение один-ко-многим.

Параметры

string	$related
string	$name
string\|null	$type
string\|null	$id
string\|null	$localKey

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

MorphMany

protected MorphMany newMorphMany(Builder $query, Model $parent, string $type, string $id, string $localKey)

Создать новое полиморфное отношение MorphMany.

Параметры

Builder	$query
Model	$parent
string	$type
string	$id
string	$localKey

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

MorphMany

BelongsToMany belongsToMany(string $related, string|null $table = null, string|null $foreignPivotKey = null, string|null $relatedPivotKey = null, string|null $parentKey = null, string|null $relatedKey = null, string|null $relation = null)

Определить отношение многие-ко-многим.

Параметры

string	$related
string\|null	$table
string\|null	$foreignPivotKey
string\|null	$relatedPivotKey
string\|null	$parentKey
string\|null	$relatedKey
string\|null	$relation

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

BelongsToMany

protected BelongsToMany newBelongsToMany(Builder $query, Model $parent, string $table, string $foreignPivotKey, string $relatedPivotKey, string $parentKey, string $relatedKey, string|null $relationName = null)

Создать новое отношение BelongsToMany.

Параметры

Builder	$query
Model	$parent
string	$table
string	$foreignPivotKey
string	$relatedPivotKey
string	$parentKey
string	$relatedKey
string\|null	$relationName

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

BelongsToMany

MorphToMany morphToMany(string $related, string $name, string|null $table = null, string|null $foreignPivotKey = null, string|null $relatedPivotKey = null, string|null $parentKey = null, string|null $relatedKey = null, bool $inverse = false)

Определить полиморфное отношение многие-ко-многим.

Параметры

string	$related
string	$name
string\|null	$table
string\|null	$foreignPivotKey
string\|null	$relatedPivotKey
string\|null	$parentKey
string\|null	$relatedKey
bool	$inverse

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

MorphToMany

protected MorphToMany newMorphToMany(Builder $query, Model $parent, string $name, string $table, string $foreignPivotKey, string $relatedPivotKey, string $parentKey, string $relatedKey, string|null $relationName = null, bool $inverse = false)

Создать новое полиморфное отношение MorphToMany.

Параметры

Builder	$query
Model	$parent
string	$name
string	$table
string	$foreignPivotKey
string	$relatedPivotKey
string	$parentKey
string	$relatedKey
string\|null	$relationName
bool	$inverse

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

MorphToMany

MorphToMany morphedByMany(string $related, string $name, string|null $table = null, string|null $foreignPivotKey = null, string|null $relatedPivotKey = null, string|null $parentKey = null, string|null $relatedKey = null)

Определить полиморфное обратное отношение многие-ко-многим.

Параметры

string	$related
string	$name
string\|null	$table
string\|null	$foreignPivotKey
string\|null	$relatedPivotKey
string\|null	$parentKey
string\|null	$relatedKey

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

MorphToMany

protected string|null guessBelongsToManyRelation()

Получить имя отношения belongsToMany.

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

string|null

string joiningTable(string $related, Модель|null $instance = null)

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

Параметры

string	$related
Модель\|null	$instance

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

string

string joiningTableSegment()

Получить часть имени промежуточной таблицы для отношений принадлежности-ко-многим.

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

string

bool touches(string $relation)

Определить, касается ли модель заданного отношения.

Параметры

string

$relation

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

bool

void touchOwners()

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

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

void

protected array getMorphs(string $name, string $type, string $id)

Получить столбцы полиморфного отношения.

Параметры

string	$name
string	$type
string	$id

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

array

string getMorphClass()

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

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

string

protected mixed newRelatedInstance(string $class)

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

Параметры

string

$class

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

mixed

array getRelations()

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

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

array

mixed getRelation(string $relation)

Получить указанное отношение.

Параметры

string

$relation

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

mixed

bool relationLoaded(string $key)

Определить, загружено ли заданное отношение.

Параметры

string

$key

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

bool

$this setRelation(string $relation, mixed $value)

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

Параметры

string	$relation
mixed	$value

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

$this

$this unsetRelation(string $relation)

Удалить загруженное отношение.

Параметры

string

$relation

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

$this

$this setRelations(array $relations)

Установить весь массив отношений в модели.

Параметры

array

$relations

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

$this

$this withoutRelations()

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

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

$this

$this unsetRelations()

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

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

$this

array getTouchedRelations()

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

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

array

$this setTouchedRelations(array $touches)

Установить отношения, которые затрагиваются при сохранении.

Параметры

array

$touches

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

$this

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/7.x/Illuminate/Database/Eloquent/Concerns/HasRelationships.html