Spec-Zone.ru › Laravel 7

HasMany

класс HasMany расширяет HasOneOrMany (Просмотреть исходный код)

Свойства

ForwardsCalls
Macroable

Свойства

static protected array $macros

Зарегистрированные макросы строк.

 from Macroable
protected Builder $query

Экземпляр Eloquent-строителя запросов.

 from Relation
protected Model $parent

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

 from Relation
protected Model $related

Экземпляр связанной модели.

 from Relation
static protected bool $constraints

Указывает, добавляет ли отношение ограничения.

 from Relation
static array $morphMap

Массив для сопоставления имён классов с их именами морфизма в базе данных.

 from Relation
protected string $foreignKey

Внешний ключ родительской модели.

 from HasOneOrMany
protected string $localKey

Локальный ключ родительской модели.

 from HasOneOrMany
static protected int $selfJoinCount

Количество самосоединений.

 from HasOneOrMany

Методы

mixed forwardCallTo(mixed $object, string $method, array $parameters)

Передать вызов метода заданному объекту.

 from ForwardsCalls
static void throwBadMethodCallException(string $method)

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

 from ForwardsCalls
static void macro(string $name, object|callable $macro)

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

 from Macroable
static void mixin(object $mixin, bool $replace = true)

Смешать другой объект в класс.

 from Macroable
static bool hasMacro(string $name)

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

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

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

 from Macroable
mixed __call(string $method, array $parameters)

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

 from Macroable
void __construct(Builder $query, Model $parent, string $foreignKey, string $localKey)

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

 from HasOneOrMany
static mixed noConstraints(Closure $callback)

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

 from Relation
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()

Получить результаты связи.
Коллекция getEager()

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

 из Отношения
Коллекция get(array $columns = ['*'])

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

 из Отношения
void touch()

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

 из Отношения
int rawUpdate(array $attributes = [])

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

 из Отношения
Библиотека getRelationExistenceCountQuery(Библиотека $query, Библиотека $parentQuery)

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

 из Отношения
Библиотека getRelationExistenceQuery(Библиотека $query, Библиотека $parentQuery, array|mixed $columns = ['*'])

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

 из ОдинК одному или многоК одному
array getKeys(array $models, string|null $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()

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

 из Relation
string relatedUpdatedAt()

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

 из Relation
string whereInMethod(Model $model, string $key)

Получить имя метода "where in" для ленивой загрузки.

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

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

 из Relation
static array|null buildMorphMapFromModels(array $models = null)

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

 из Relation
static string|null getMorphedModel(string $alias)

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

 из Relation
void __clone()

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

 из Relation
Модель make(array $attributes = [])

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

 из HasOneOrMany
Коллекция makeMany(iterable $records)

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

 из HasOneOrMany
массив matchOne(array $models, Коллекция $results, string $relation)

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

 из HasOneOrMany
массив matchMany(array $models, Коллекция $results, string $relation)

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

 из HasOneOrMany
массив matchOneOrMany(array $models, Коллекция $results, string $relation, string $type)

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

 из HasOneOrMany
смешанный тип getRelationValue(array $dictionary, string $key, string $type)

Получить значение отношения по типу один-к-одному или один-ко-многим.

 из HasOneOrMany
array buildDictionary(Collection $results)

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

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

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

 from HasOneOrMany
Model firstOrNew(array $attributes, array $values = [])

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

 from HasOneOrMany
Model firstOrCreate(array $attributes, array $values = [])

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

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

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

 from HasOneOrMany
Модель|false сохранить(Модель $model)

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

 из HasOneOrMany
iterable сохранитьМножество(iterable $models)

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

 из HasOneOrMany
Модель создать(array $attributes = [])

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

 из HasOneOrMany
Коллекция создатьМножество(iterable $records)

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

 из HasOneOrMany
void установитьВнешниеАтрибутыДляСоздание(Модель $model)

Установить внешний идентификатор для создания связанной модели.

 из HasOneOrMany
Builder getRelationExistenceQueryForSelfRelation(Builder $query, Builder $parentQuery, array|mixed $columns = ['*'])

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

 from HasOneOrMany
string getRelationCountHash()

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

 from HasOneOrMany
string getExistenceCompareKey()

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

 from HasOneOrMany
mixed getParentKey()

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

 from HasOneOrMany
string getForeignKeyName()

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

 from HasOneOrMany
string getQualifiedForeignKeyName()

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

 from HasOneOrMany
string getLocalKeyName()

Получить локальный ключ для отношения.

 из HasOneOrMany

Подробности

protected mixed forwardCallTo(mixed $object, string $method, array $parameters)

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

Параметры

mixed $object
string $method
array $parameters

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

mixed

Исключения

BadMethodCallException

static protected void throwBadMethodCallException(string $method)

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

Параметры

string $method

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

void

Исключения

BadMethodCallException

static void macro(string $name, object|callable $macro)

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

Параметры

string $name
object|callable $macro

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

void

static void mixin(object $mixin, bool $replace = true)

Смешать другой объект в класс.

Параметры

object $mixin
bool $replace

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

void

Исключения

ReflectionException

static bool hasMacro(string $name)

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

Параметры

string $name

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

bool

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

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

Параметры

string $method
array $parameters

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

mixed

Исключения

BadMethodCallException

mixed __call(string $method, array $parameters)

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

Параметры

string $method
array $parameters

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

mixed

Исключения

BadMethodCallException

void __construct(Builder $query, Model $parent, string $foreignKey, string $localKey)

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

Параметры

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

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

void

static mixed noConstraints(Closure $callback)

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

Параметры

Closure $callback

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

mixed

void addConstraints()

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

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

void

void addEagerConstraints(array $models)

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

Параметры

array $models

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

void

array initRelation(array $models, string $relation)

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

Параметры

array $models
string $relation

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

array

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

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

Параметры

array $models
Collection $results
string $relation

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

array

mixed getResults()

Получить результаты отношения.

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

mixed

Collection getEager()

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

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

Collection

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

Выполнить запрос как операцию "выбор".

Параметры

array $columns

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

Collection

void touch()

Коснитесь всех связанных моделей для отношения.

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

void

int rawUpdate(array $attributes = [])

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

Параметры

array $attributes

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

int

Builder getRelationExistenceCountQuery(Builder $query, Builder $parentQuery)

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

Параметры

Builder $query
Builder $parentQuery

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

Builder

Builder getRelationExistenceQuery(Builder $query, Builder $parentQuery, array|mixed $columns = ['*'])

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

Параметры

Builder $query
Builder $parentQuery
array|mixed $columns

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

Builder

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

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

Параметры

array $models
string|null $key

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

array

Builder getQuery()

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

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

Builder

Builder getBaseQuery()

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

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

Builder

Модель getParent()

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

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

Модель

string getQualifiedParentKeyName()

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

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

string

Модель getRelated()

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

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

Модель

string createdAt()

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

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

string

string updatedAt()

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

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

string

string relatedUpdatedAt()

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

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

string

protected string whereInMethod(Model $model, string $key)

Получить имя метода "where in" для леничной загрузки.

Параметры

Model $model
string $key

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

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

static string|null getMorphedModel(string $alias)

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

Параметры

string $alias

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

string|null

void __clone()

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

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

void

Модель make(array $attributes = [])

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

Параметры

array $attributes

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

Модель

Коллекция makeMany(iterable $records)

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

Параметры

iterable $records

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

Коллекция

array matchOne(array $models, Коллекция $results, string $relation)

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

Параметры

array $models
Коллекция $results
string $relation

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

array

array matchMany(array $models, Коллекция $results, string $relation)

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

Параметры

array $models
Коллекция $results
string $relation

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

array

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

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

Параметры

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

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

array

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

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

Параметры

array $dictionary
string $key
string $type

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

mixed

protected array buildDictionary(Collection $results)

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

Параметры

Collection $results

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

array

Collection|Модель findOrNew(mixed $id, array $columns = ['*'])

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

Параметры

mixed $id
array $columns

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

Collection|Модель

Модель firstOrNew(array $attributes, array $values = [])

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

Параметры

array $attributes
array $values

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

Модель

Модель firstOrCreate(array $attributes, array $values = [])

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

Параметры

array $attributes
array $values

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

Модель

Модель updateOrCreate(array $attributes, array $values = [])

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

Параметры

array $attributes
array $values

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

Модель

Модель|false save(Модель $model)

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

Параметры

Модель $model

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

Модель|false

iterable saveMany(iterable $models)

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

Параметры

iterable $models

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

iterable

Модель create(array $attributes = [])

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

Параметры

array $attributes

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

Модель

Коллекция createMany(iterable $records)

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

Параметры

iterable $records

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

Коллекция

protected void setForeignAttributesForCreate(Модель $model)

Установить внешний идентификатор для создания связанной модели.

Параметры

Модель $model

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

void

Билдер getRelationExistenceQueryForSelfRelation(Билдер $query, Билдер $parentQuery, array|mixed $columns = ['*'])

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

Параметры

Билдер $query
Билдер $parentQuery
array|mixed $columns

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

Билдер

string getRelationCountHash()

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

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

string

string getExistenceCompareKey()

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

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

string

mixed getParentKey()

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

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

mixed

string getForeignKeyName()

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

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

string

string getQualifiedForeignKeyName()

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

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

string

string getLocalKeyName()

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

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

string

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API