HasOne

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

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

Параметры

массив

$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)

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

Параметры

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

Значение результата

массив

Builder getQuery()

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

Значение результата

Builder

Builder getBaseQuery()

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

Значение результата

Builder

Модель getParent()

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

Значение результата

Модель

строка getQualifiedParentKeyName()

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

Значение результата

строка

Модель getRelated()

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

Значение результата

Модель

строка createdAt()

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

Значение результата

строка

строка updatedAt()

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

Значение результата

строка

строка relatedUpdatedAt()

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

Значение результата

строка

строка wrap(string $value)

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

Параметры

строка

$value

Значение результата

строка

static массив morphMap(array $map = null, bool $merge = true)

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

Параметры

массив	$map
bool	$merge

Значение результата

массив

static protected массив|null buildMorphMapFromModels(array $models = null)

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

Параметры

массив

$models

Значение результата

массив|null

mixed __call(string $method, array $parameters)

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

Параметры

строка	$method
массив	$parameters

Значение результата

mixed

void __clone()

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

Значение результата

void

Builder getRelationCountQueryForSelfRelation(Builder $query, Builder $parent)

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

Параметры

Builder	$query
Builder	$parent

Значение результата

Builder

строка getRelationCountHash()

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

Значение результата

строка

массив matchOne(array $models, Collection $results, string $relation)

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

Параметры

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

Значение результата

массив

массив matchMany(array $models, Collection $results, string $relation)

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

Параметры

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

Значение результата

массив

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.1/Illuminate/Database/Eloquent/Relations/HasOne.html