Коллекция
класс Коллекция расширяет Коллекцию и реализует QueueableCollection (Просмотреть исходный код)
Трейты
| Взаимодействие со словарем | |
| Перечисление значений | |
| Макрообъект | |
| Условный |
Свойства
| HigherOrderCollectionProxy только для чтения | $takeWhile | из EnumeratesValues | |
| HigherOrderCollectionProxy только для чтения | $unique | из EnumeratesValues | |
| HigherOrderCollectionProxy только для чтения | $unless | из EnumeratesValues | |
| HigherOrderCollectionProxy только для чтения | $until | из EnumeratesValues | |
| HigherOrderCollectionProxy только для чтения | $when | из EnumeratesValues | |
| static protected array | $macros | Зарегистрированные строковые макросы. | из Macroable |
| protected | $items | из Collection |
Методы
| $this|TWhenReturnType | when($value = null, callable|null $callback = null, callable|null $default = null)
Применить обратный вызов, если заданное «значение» истинно (или разрешается до истинного). | из Conditionable |
| $this|TUnlessReturnType | unless($value = null, callable|null $callback = null, callable|null $default = null)
Применить обратный вызов, если заданное «значение» ложно (или разрешается до ложного). | из Conditionable |
| static | make($items = []) Описание отсутствует | из EnumeratesValues |
| static | wrap($value) Описание отсутствует | из EnumeratesValues |
| static | unwrap($value) Описание отсутствует | из EnumeratesValues |
| static EnumeratesValues | empty()
Создать новый экземпляр без элементов. | из EnumeratesValues |
| static | times($number, callable|null $callback = null) Описание отсутствует | из EnumeratesValues |
| float|int|null | avg($callback = null)
Получить среднее значение заданного ключа. | из EnumeratesValues |
| float|int|null | average($callback = null)
Псевдоним метода «avg». | из EnumeratesValues |
| bool | some($key, mixed $operator = null, mixed $value = null)
Псевдоним метода «contains». | из EnumeratesValues |
| never | dd(mixed ...$args)
Вывести заданные аргументы и завершить выполнение. | из EnumeratesValues |
| $this | dump(mixed ...$args)
Вывести элементы. | из EnumeratesValues |
| $this | each(callable $callback)
Выполнить обратный вызов для каждого элемента. | из EnumeratesValues |
| EnumeratesValues | eachSpread(callable $callback)
Выполнить обратный вызов для каждого вложенного фрагмента элементов. | из EnumeratesValues |
| bool | every($key, mixed $operator = null, mixed $value = null)
Определить, проходят ли все элементы заданный тест на истинность. | из EnumeratesValues |
| TValue|null | firstWhere(callable|string $key, mixed $operator = null, mixed $value = null)
Получить первый элемент по заданной паре ключ-значение. | из EnumeratesValues |
| value($key, $default = null) Описание отсутствует | из EnumeratesValues | |
| ensure($type) Описание отсутствует | из EnumeratesValues | |
| bool | isNotEmpty()
Определить, не является ли коллекция пустой. | из EnumeratesValues |
| mapSpread(callable $callback) Описание отсутствует | из EnumeratesValues | |
| mapToGroups(callable $callback) Описание отсутствует | из EnumeratesValues | |
| flatMap(callable $callback) Описание отсутствует | из EnumeratesValues | |
| mapInto($class) Описание отсутствует | из EnumeratesValues | |
| mixed | min($callback = null)
Получить минимальное значение заданного ключа. | из EnumeratesValues |
| mixed | max($callback = null)
Получить максимальное значение заданного ключа. | из EnumeratesValues |
| EnumeratesValues | forPage(int $page, int $perPage)
«Разбить» коллекцию на более мелкие, используя срезы. | из EnumeratesValues |
| partition($key, $operator = null, $value = null) Описание отсутствует | из EnumeratesValues | |
| float|null | percentage(callable $callback, int $precision = 2)
Рассчитать процент элементов, проходящих заданный тест на истинность. | из EnumeratesValues |
| mixed | sum($callback = null)
Получить сумму заданных значений. | из EnumeratesValues |
| $this|TWhenEmptyReturnType | whenEmpty(callable $callback, callable|null $default = null)
Применить обратный вызов, если коллекция пустая. | из EnumeratesValues |
| $this|TWhenNotEmptyReturnType | whenNotEmpty(callable $callback, callable|null $default = null)
Применить обратный вызов, если коллекция не пуста. | from EnumeratesValues |
| $this|TUnlessEmptyReturnType | unlessEmpty(callable $callback, callable|null $default = null)
Применить обратный вызов, если коллекция пуста. | from EnumeratesValues |
| $this|TUnlessNotEmptyReturnType | unlessNotEmpty(callable $callback, callable|null $default = null)
Применить обратный вызов, если коллекция не пуста. | from EnumeratesValues |
| EnumeratesValues | where(callable|string $key, mixed $operator = null, mixed $value = null)
Фильтровать элементы по заданной паре ключ-значение. | from EnumeratesValues |
| EnumeratesValues | whereNull(string|null $key = null)
Фильтровать элементы, где значение для данного ключа равно null. | from EnumeratesValues |
| EnumeratesValues | whereNotNull(string|null $key = null)
Фильтровать элементы, где значение для данного ключа не равно null. | from EnumeratesValues |
| EnumeratesValues | whereStrict(string $key, mixed $value)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | from EnumeratesValues |
| EnumeratesValues | whereIn(string $key, Arrayable|iterable $values, bool $strict = false)
Фильтровать элементы по заданной паре ключ-значение. | from EnumeratesValues |
| EnumeratesValues | whereInStrict(string $key, Arrayable|iterable $values)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | from EnumeratesValues |
| EnumeratesValues | whereBetween(string $key, Arrayable|iterable $values)
Фильтровать элементы так, чтобы значение заданного ключа находилось между заданными значениями. | from EnumeratesValues |
| EnumeratesValues | whereNotBetween(string $key, Arrayable|iterable $values)
Фильтровать элементы так, чтобы значение заданного ключа не находилось между заданными значениями. | from EnumeratesValues |
| EnumeratesValues | whereNotIn(string $key, Arrayable|iterable $values, bool $strict = false)
Фильтровать элементы по заданной паре ключ-значение. | from EnumeratesValues |
| EnumeratesValues | whereNotInStrict(string $key, Arrayable|iterable $values)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | from EnumeratesValues |
| whereInstanceOf($type) Без описания | from EnumeratesValues | |
| TPipeReturnType | pipe(callable $callback)
Передать коллекцию заданному обратному вызову и вернуть результат. | from EnumeratesValues |
| TPipeIntoValue | pipeInto(TPipeIntoValue> $class)
Передать коллекцию в новый класс. | from EnumeratesValues |
| mixed | pipeThrough(callable[] $callbacks)
Пропустить коллекцию через серию обратных вызовов-фильтров и вернуть результат. | from EnumeratesValues |
| TReduceReturnType | reduce(callable $callback, TReduceInitial $initial = null)
Свести коллекцию к одному значению. | from EnumeratesValues |
| array | reduceSpread(callable $callback, mixed ...$initial)
Свести коллекцию к нескольким агрегированным значениям. | from EnumeratesValues |
| TReduceWithKeysReturnType | reduceWithKeys(callable $callback, TReduceWithKeysInitial $initial = null)
Свести ассоциативную коллекцию к одному значению. | from EnumeratesValues |
| EnumeratesValues | reject($callback = true)
Создать коллекцию из всех элементов, которые не проходят заданный тест истинности. | from EnumeratesValues |
| $this | tap(callable $callback)
Передать коллекцию заданному обратному вызову, а затем вернуть ее. | from EnumeratesValues |
| Enumerable | unique($key = null, bool $strict = false) Без описания |
| EnumeratesValues | uniqueStrict($key = null)
Возвращает только уникальные элементы из массива коллекции, используя строгое сравнение. | из EnumeratesValues |
| TValue> | collect()
Собрать значения в коллекцию. | из EnumeratesValues |
| toArray() Без описания | из EnumeratesValues | |
| array | jsonSerialize() Без описания | из EnumeratesValues |
| string | toJson(int $options = 0)
Получить коллекцию элементов в формате JSON. | из EnumeratesValues |
| CachingIterator | getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING)
Получить экземпляр CachingIterator. | из EnumeratesValues |
| string | __toString()
Преобразовать коллекцию в её строковое представление. | из EnumeratesValues |
| $this | escapeWhenCastingToString(bool $escape = true)
Указать, что строковое представление модели должно быть экранировано при вызове __toString. | из EnumeratesValues |
| static void | proxy(string $method)
Добавить метод в список проксируемых методов. | из EnumeratesValues |
| mixed | __get(string $key)
Динамический доступ к проксированию коллекции. | из EnumeratesValues |
| getArrayableItems($items) Без описания | из EnumeratesValues | |
| Closure | operatorForWhere(callable|string $key, string|null $operator = null, mixed $value = null)
Получить обратный вызов для проверки оператора. | из EnumeratesValues |
| bool | useAsCallable(mixed $value)
Определить, является ли данное значение вызываемым, но не строкой. | из EnumeratesValues |
| callable | valueRetriever(callable|string|null $value)
Получить обратный вызов для извлечения значения. | из EnumeratesValues |
| equality(mixed $value)
Создать функцию для проверки равенства элемента. | из EnumeratesValues | |
| Closure | negate(Closure $callback)
Создать функцию, использующую другую функцию, инвертируя её результат. | из EnumeratesValues |
| identity()
Создать функцию, возвращающую переданное ей значение. | из EnumeratesValues | |
| static void | macro(string $name, object|callable $macro)
Зарегистрировать пользовательское макро. | из Macroable |
| static void | mixin(object $mixin, bool $replace = true)
Смешать другой объект в класс. | из Macroable |
| static bool | hasMacro(string $name)
Проверяет, зарегистрировано ли макро. | из Macroable |
| static void | flushMacros()
Очистить существующие макросы. | из Macroable |
| static mixed | __callStatic(string $method, array $parameters)
Динамически обработать вызовы к классу. | из Macroable |
| mixed | __call(string $method, array $parameters)
Динамически обработать вызовы к классу. | из Macroable |
| void | __construct(TValue>|TValue>|null $items = [])
Создать новую коллекцию. | из Collection |
| static Enumerable | range(int $from, int $to) Без описания | из Collection |
| array | all() Без описания | из Collection |
| TValue> | lazy()
Получить ленивую коллекцию для элементов в этой коллекции. | из Collection |
| float|int|null | median(string|array<array-key,string>|null $key = null)
Получить медиану заданного ключа. | из Collection |
| array<int,float|int>|null | mode(string|array<array-key,string>|null $key = null)
Получить моду заданного ключа. | из Collection |
| collapse()
Сжать коллекцию элементов в один массив. | ||
| bool | contains($key, mixed $operator = null, mixed $value = null)
Определить, существует ли ключ в коллекции. |
| bool | containsStrict($key, TValue|null $value = null)
Определить, существует ли элемент, используя строгое сравнение. | из Коллекции |
| bool | doesntContain(mixed $key, mixed $operator = null, mixed $value = null)
Определить, не содержит ли коллекция элемент. | из Коллекции |
| crossJoin(...$lists) Описание отсутствует | из Коллекции | |
| Enumerable | diff(TValue>|TValue> $items)
Разница между коллекцией и заданными элементами. | |
| Enumerable | diffUsing(TValue>|TValue> $items, callable $callback)
Получить элементы из коллекции, которых нет в заданных элементах, используя функцию обратного вызова. | из Коллекции |
| Enumerable | diffAssoc(TValue>|TValue> $items)
Получить элементы из коллекции, у которых ключи и значения отсутствуют в заданных элементах. | из Коллекции |
| Enumerable | diffAssocUsing(TValue>|TValue> $items, callable $callback)
Получить элементы из коллекции, у которых ключи и значения отсутствуют в заданных элементах, используя функцию обратного вызова. | из Коллекции |
| Enumerable | diffKeys(TValue>|TValue> $items)
Получить элементы из коллекции, у которых ключи отсутствуют в заданных элементах. | из Коллекции |
| Enumerable | diffKeysUsing(TValue>|TValue> $items, callable $callback)
Получить элементы из коллекции, у которых ключи отсутствуют в заданных элементах, используя функцию обратного вызова. | из Коллекции |
| Enumerable | duplicates($callback = null, bool $strict = false)
Получить дублируемые элементы из коллекции. | из Коллекции |
| Enumerable | duplicatesStrict($callback = null)
Получить дублируемые элементы из коллекции с использованием строгого сравнения. | из Коллекции |
| duplicateComparator(bool $strict)
Получить функцию сравнения для обнаружения дубликатов. | ||
| Enumerable | except(TKey>|TKey> $keys) Описание отсутствует | |
| Enumerable | filter(callable|null $callback = null)
Применить фильтр к каждому элементу. | из Коллекции |
| first(callable|null $callback = null, $default = null) Описание отсутствует | из Коллекции | |
| Enumerable | flatten(int $depth = INF)
Получить плоский массив элементов из коллекции. | |
| flip()
Поменять местами элементы в коллекции. | ||
| $this | forget($keys)
Удалить элемент из коллекции по ключу. | из Коллекции |
| get($key, $default = null) Описание отсутствует | из Коллекции | |
| getOrPut($key, $value) Описание отсутствует | из Коллекции | |
| groupBy($groupBy, $preserveKeys = false) Описание отсутствует | из Коллекции | |
| keyBy($keyBy) Описание отсутствует | из Коллекции | |
| bool | has(TKey|TKey> $key)
Определить, существует ли элемент в коллекции по ключу. | из Коллекции |
| bool | hasAny(mixed $key)
Определить, существуют ли какие-либо ключи в коллекции. | из Коллекции |
| string | implode(callable|string $value, string|null $glue = null)
Объединить значения заданного ключа в строку. | из Коллекции |
| Enumerable | intersect(TValue>|TValue> $items)
Пересечение коллекции с заданными элементами. | |
| Enumerable | intersectUsing(TValue>|TValue> $items, callable $callback)
Пересечение коллекции с заданными элементами, используя функцию обратного вызова. | из Коллекции |
| Enumerable | intersectAssoc(TValue>|TValue> $items)
Пересечение коллекции с заданными элементами с дополнительной проверкой индекса. | из Коллекции |
| Enumerable | intersectAssocUsing(TValue>|TValue> $items, callable $callback)
Пересечение коллекции с заданными элементами с дополнительной проверкой индекса, используя функцию обратного вызова. | из Коллекции |
| Enumerable | intersectByKeys(TValue>|TValue> $items)
Пересечение коллекции с заданными элементами по ключу. | из Коллекции |
| bool | isEmpty()
Определить, пустой ли набор. | из Collection |
| bool | containsOneItem()
Определить, содержит ли набор один элемент. | из Collection |
| string | join(string $glue, string $finalGlue = '')
Объединить все элементы набора с помощью строки. Для последних элементов можно использовать отдельную разделительную строку. | из Collection |
| keys()
Получить ключи элементов набора. | ||
| last(callable|null $callback = null, $default = null) Без описания | из Collection | |
| pluck($value, $key = null)
Получить массив со значениями заданного ключа. | ||
| map(callable $callback) Без описания | ||
| mapToDictionary(callable $callback) Без описания | из Collection | |
| mapWithKeys(callable $callback) Без описания | ||
| Enumerable | merge(TValue>|TValue> $items)
Объединить набор с заданными элементами. | |
| mergeRecursive($items) Без описания | из Collection | |
| Collection | multiply(int $multiplier)
Умножить элементы набора на множитель. | из Collection |
| combine($values) Без описания | из Collection | |
| Enumerable | union(TValue>|TValue> $items)
Объединить набор с заданными элементами. | из Collection |
| Enumerable | nth(int $step, int $offset = 0)
Создать новый набор, содержащий каждый n-й элемент. | из Collection |
| Enumerable | only(TKey>|TKey>|string $keys) Без описания | |
| Collection | select(TKey>|TKey>|string|null $keys)
Выбрать определенные значения из элементов внутри набора. | из Collection |
| pop($count = 1) Без описания | из Collection | |
| $this | prepend(TValue $value, TKey $key = null)
Добавить элемент в начало набора. | из Collection |
| $this | push(TValue ...$values)
Добавить один или несколько элементов в конец набора. | из Collection |
| $this | unshift(TValue ...$values)
Добавить один или несколько элементов в начало набора. | из Collection |
| concat($source) Без описания | из Collection | |
| pull($key, $default = null) Без описания | из Collection | |
| $this | put(TKey $key, TValue $value)
Поместить элемент в набор по ключу. | из Collection |
| random($number = null, $preserveKeys = false) Без описания | из Collection | |
| Enumerable | replace(TValue>|TValue> $items)
Заменить элементы набора на заданные элементы. | из Collection |
| Enumerable | replaceRecursive(TValue>|TValue> $items)
Рекурсивно заменить элементы набора на заданные элементы. | из Collection |
| Enumerable | reverse()
Перевернуть порядок элементов. | из Collection |
| TKey|bool | search($value, bool $strict = false)
Найти значение в наборе и вернуть соответствующий ключ, если поиск успешен. | из Collection |
| TValue|null | before($value, bool $strict = false)
Получить элемент, предшествующий заданному элементу. | из Collection |
| TValue|null | after($value, bool $strict = false)
Получить элемент, следующий за заданным элементом. | из Collection |
| shift($count = 1) Без описания | из Collection | |
| Enumerable | shuffle()
Перемешать элементы в наборе. | из Collection |
| sliding($size = 2, $step = 1) Без описания | из Collection | |
| Enumerable | skip(int $count)
Пропустить первые {$count} элементов. | из Collection |
| Перечисляемый | skipUntil($value)
Пропустить элементы в коллекции до тех пор, пока не будет выполнено заданное условие. | из Коллекции |
| Перечисляемый | skipWhile($value)
Пропустить элементы в коллекции, пока выполняется заданное условие. | из Коллекции |
| Перечисляемый | slice(int $offset, int|null $length = null)
Выделить часть массива базовой коллекции. | из Коллекции |
| split($numberOfGroups) Описание отсутствует | из Коллекции | |
| splitIn($numberOfGroups) Описание отсутствует | из Коллекции | |
| TValue | sole($key = null, mixed $operator = null, mixed $value = null)
Получить первый элемент в коллекции, только если существует ровно один элемент. В противном случае выбросить исключение. | из Коллекции |
| TValue | firstOrFail($key = null, mixed $operator = null, mixed $value = null)
Получить первый элемент в коллекции, но выбросить исключение, если соответствующие элементы отсутствуют. | из Коллекции |
| chunk($size) Описание отсутствует | из Коллекции | |
| chunkWhile(callable $callback) Описание отсутствует | из Коллекции | |
| Перечисляемый | sort($callback = null)
Отсортировать каждый элемент с помощью обратного вызова. | из Коллекции |
| Перечисляемый | sortDesc(int $options = SORT_REGULAR)
Отсортировать элементы в порядке убывания. | из Коллекции |
| Перечисляемый | sortBy($callback, int $options = SORT_REGULAR, bool $descending = false)
Отсортировать коллекцию с помощью заданного обратного вызова. | из Коллекции |
| Коллекция | sortByMany(array $comparisons = [], int $options = SORT_REGULAR)
Отсортировать коллекцию, используя несколько сравнений. | из Коллекции |
| Перечисляемый | sortByDesc($callback, int $options = SORT_REGULAR)
Отсортировать коллекцию в порядке убывания, используя заданный обратный вызов. | из Коллекции |
| Перечисляемый | sortKeys(int $options = SORT_REGULAR, bool $descending = false)
Отсортировать ключи коллекции. | из Коллекции |
| Перечисляемый | sortKeysDesc(int $options = SORT_REGULAR)
Отсортировать ключи коллекции в порядке убывания. | из Коллекции |
| Перечисляемый | sortKeysUsing(callable $callback)
Отсортировать ключи коллекции с помощью обратного вызова. | из Коллекции |
| Коллекция | splice(int $offset, int|null $length = null, TValue> $replacement = [])
Вставить часть массива базовой коллекции. | из Коллекции |
| Перечисляемый | take(int $limit)
Взять первые или последние {$limit} элементов. | из Коллекции |
| Перечисляемый | takeUntil($value)
Взять элементы в коллекции до тех пор, пока не будет выполнено заданное условие. | из Коллекции |
| Перечисляемый | takeWhile($value)
Взять элементы в коллекции, пока выполняется заданное условие. | из Коллекции |
| $this | transform(callable $callback)
Преобразовать каждый элемент в коллекции с помощью обратного вызова. | из Коллекции |
| Коллекция | dot()
Распаковать многомерный ассоциативный массив с точками. | из Коллекции |
| Перечисляемый | undot()
Преобразовать распакованный массив с нотацией "точка" в расширенный массив. | из Коллекции |
| values() Описание отсутствует | из Коллекции | |
| zip($items)
Объединить коллекцию с одним или несколькими массивами. | ||
| pad($size, $value)
Заполнить коллекцию до указанной длины значением. | ||
| Traversable | getIterator()
Получить итератор для элементов. | из Коллекции |
| int | count()
Подсчитать количество элементов в коллекции. | из Коллекции |
| countBy($countBy = null)
Подсчитать количество элементов в коллекции по полю или с помощью обратного вызова. |
| $this | add(TValue $item)
Добавить элемент в коллекцию. | из Collection |
| TValue> | toBase()
Получить базовый экземпляр коллекции Support из этой коллекции. | из Collection |
| bool | offsetExists(TKey $key)
Определить, существует ли элемент по заданному смещению. | из Collection |
| mixed | offsetGet(TKey $key)
Получить элемент по заданному смещению. | из Collection |
| void | offsetSet(TKey|null $key, TValue $value)
Установить элемент по заданному смещению. | из Collection |
| void | offsetUnset(TKey $key)
Удалить элемент по заданному смещению. | из Collection |
| mixed | getDictionaryKey(mixed $attribute)
Получить атрибут ключа словаря, при необходимости преобразовав его в строку. | из InteractsWithDictionary |
| find($key, $default = null) Без описания | ||
| $this | load($relations)
Загрузить набор отношений в коллекцию. | |
| $this | loadAggregate($relations, string $column, string|null $function = null)
Загрузить набор агрегаций по столбцу отношения в коллекцию. | |
| $this | loadCount($relations)
Загрузить набор подсчётов отношений в коллекцию. | |
| $this | loadMax($relations, string $column)
Загрузить набор максимальных значений столбца отношения в коллекцию. | |
| $this | loadMin($relations, string $column)
Загрузить набор минимальных значений столбца отношения в коллекцию. | |
| $this | loadSum($relations, string $column)
Загрузить набор сумм значений столбца отношения в коллекцию. | |
| $this | loadAvg($relations, string $column)
Загрузить набор средних значений столбца отношения в коллекцию. | |
| $this | loadExists($relations)
Загрузить набор существований связанных сущностей в коллекцию. | |
| $this | loadMissing($relations)
Загрузить набор отношений в коллекцию, если они ещё не загружены жадно. | |
| void | loadMissingRelation(Collection $models, array $path)
Загрузить путь отношения, если он ещё не загружен жадно. | |
| $this | loadMorph(string $relation, $relations)
Загрузить набор отношений в коллекцию смешанных отношений. | |
| $this | loadMorphCount(string $relation, $relations)
Загрузить набор подсчётов отношений в коллекцию смешанных отношений. | |
| array<int,array-key> | modelKeys()
Получить массив первичных ключей. | |
| Collection | fresh(array<array-key,string>|string $with = [])
Перезагрузить свежий экземпляр модели из базы данных для всех сущностей. | |
| $this | makeHidden(array<array-key,string>|string $attributes)
Скрыть указанные, обычно видимые, атрибуты для всей коллекции. | |
| $this | makeVisible(array<array-key,string>|string $attributes)
Сделать указанные, обычно скрытые, атрибуты видимыми для всей коллекции. | |
| $this | setVisible(array<int,string> $visible)
Установить видимые атрибуты для всей коллекции. | |
| $this | setHidden(array<int,string> $hidden)
Установить скрытые атрибуты для всей коллекции. | |
| $this | append(array<array-key,string>|string $attributes)
Добавить атрибут к всей коллекции. | |
| TModel> | getDictionary(TModel>|null $items = null)
Получить словарь, индексированный по первичным ключам. | |
| string|null | getQueueableClass()
Получить тип сущностей, которые отправляются в очередь. | |
| string | getQueueableModelClass(Model $model)
Получить имя класса сущности, которая отправляется в очередь, для заданной модели. | |
| array<int,mixed> | getQueueableIds()
Получить идентификаторы всех сущностей. | |
| array<int,string> | getQueueableRelations()
Получить отношения сущностей, которые отправляются в очередь. | |
| string|null | getQueueableConnection()
Получить подключение к базе данных для сущностей, которые отправляются в очередь. | |
| TModel> | toQuery()
Получить Eloquent-объект Query Builder из коллекции. |
Подробности
$this|TWhenReturnType when($value = null, callable|null $callback = null, callable|null $default = null)
Применить обратный вызов, если заданное «значение» истинно.
$this|TUnlessReturnType unless($value = null, callable|null $callback = null, callable|null $default = null)
Применить обратный вызов, если заданное «значение» ложно.
static make($items = [])
Без описания
static wrap($value)
Без описания
static unwrap($value)
Без описания
static EnumeratesValues empty()
Создать новый экземпляр без элементов.
static times($number, callable|null $callback = null)
Без описания
float|int|null avg($callback = null)
Получить среднее значение заданного ключа.
float|int|null average($callback = null)
Псевдоним для метода "avg".
bool some($key, mixed $operator = null, mixed $value = null)
Псевдоним для метода "contains".
never dd(mixed ...$args)
Вывести заданные аргументы и завершить выполнение.
$this dump(mixed ...$args)
Вывести элементы.
$this each(callable $callback)
Выполнить обратный вызов для каждого элемента.
EnumeratesValues eachSpread(callable $callback)
Выполнить обратный вызов для каждой вложенной группы элементов.
bool every($key, mixed $operator = null, mixed $value = null)
Определить, проходят ли все элементы заданный логический тест.
TValue|null firstWhere(callable|string $key, mixed $operator = null, mixed $value = null)
Получить первый элемент по заданной паре ключ-значение.
value($key, $default = null)
Без описания
ensure($type)
Без описания
bool isNotEmpty()
Определить, не пуст ли набор.
mapSpread(callable $callback)
Без описания
mapToGroups(callable $callback)
Без описания
flatMap(callable $callback)
Без описания
mapInto($class)
Без описания
mixed min($callback = null)
Получить минимальное значение заданного ключа.
mixed max($callback = null)
Получить максимальное значение заданного ключа.
EnumeratesValues forPage(int $page, int $perPage)
Разбить коллекцию на страницы путём среза.
partition($key, $operator = null, $value = null)
Без описания
float|null percentage(callable $callback, int $precision = 2)
Вычислить процент элементов, удовлетворяющих заданному условию истинности.
mixed sum($callback = null)
Получить сумму заданных значений.
$this|TWhenEmptyReturnType whenEmpty(callable $callback, callable|null $default = null)
Применить обратный вызов, если коллекция пуста.
$this|TWhenNotEmptyReturnType whenNotEmpty(callable $callback, callable|null $default = null)
Применить обратный вызов, если коллекция не пуста.
$this|TUnlessEmptyReturnType unlessEmpty(callable $callback, callable|null $default = null)
Применить обратный вызов, если коллекция не пуста.
$this|TUnlessNotEmptyReturnType unlessNotEmpty(callable $callback, callable|null $default = null)
Применить обратный вызов, если коллекция пуста.
EnumeratesValues where(callable|string $key, mixed $operator = null, mixed $value = null)
Фильтровать элементы по заданной паре ключ-значение.
EnumeratesValues whereNull(string|null $key = null)
Фильтровать элементы, где значение для заданного ключа равно null.
EnumeratesValues whereNotNull(string|null $key = null)
Фильтровать элементы, где значение для заданного ключа не равно null.
EnumeratesValues whereStrict(string $key, mixed $value)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.
EnumeratesValues whereIn(string $key, Arrayable|iterable $values, bool $strict = false)
Фильтровать элементы по заданной паре ключ-значение.
EnumeratesValues whereInStrict(string $key, Arrayable|iterable $values)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.
EnumeratesValues whereBetween(string $key, Arrayable|iterable $values)
Фильтровать элементы так, чтобы значение заданного ключа находилось между заданными значениями.
EnumeratesValues whereNotBetween(string $key, Arrayable|iterable $values)
Фильтровать элементы так, чтобы значение заданного ключа не находилось между заданными значениями.
EnumeratesValues whereNotIn(string $key, Arrayable|iterable $values, bool $strict = false)
Фильтровать элементы по заданной паре ключ-значение.
EnumeratesValues whereNotInStrict(string $key, Arrayable|iterable $values)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.
whereInstanceOf($type)
Без описания
TPipeReturnType pipe(callable $callback)
Передать коллекцию заданному обращению и вернуть результат.
TPipeIntoValue pipeInto(TPipeIntoValue> $class)
Передать коллекцию в новый класс.
mixed pipeThrough(callable[] $callbacks)
Передать коллекцию через серию вызовов и вернуть результат.
TReduceReturnType reduce(callable $callback, TReduceInitial $initial = null)
Свести коллекцию к одному значению.
array reduceSpread(callable $callback, mixed ...$initial)
Свести коллекцию к нескольким агрегированным значениям.
TReduceWithKeysReturnType reduceWithKeys(callable $callback, TReduceWithKeysInitial $initial = null)
Свести ассоциативную коллекцию к одному значению.
EnumeratesValues reject($callback = true)
Создать коллекцию всех элементов, которые не проходят заданный тест истинности.
$this tap(callable $callback)
Передать коллекцию заданному обращению, а затем вернуть её.
Enumerable unique($key = null, bool $strict = false)
Без описания
EnumeratesValues uniqueStrict($key = null)
Возвращают только уникальные элементы из массива коллекции с использованием строгого сравнения.
TValue> collect()
Собрать значения в коллекцию.
toArray()
Без описания
array jsonSerialize()
Без описания
string toJson(int $options = 0)
Получить коллекцию элементов в формате JSON.
CachingIterator getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING)
Получить экземпляр CachingIterator.
string __toString()
Преобразовать коллекцию в строковое представление.
$this escapeWhenCastingToString(bool $escape = true)
Укажите, что строковое представление модели должно быть экранировано при вызове __toString.
static void proxy(string $method)
Добавить метод в список проксируемых методов.
mixed __get(string $key)
Динамический доступ к прокси коллекций.
protected getArrayableItems($items)
Без описания
protected Closure operatorForWhere(callable|string $key, string|null $operator = null, mixed $value = null)
Получить коллбек-функцию для проверки оператора.
protected bool useAsCallable(mixed $value)
Определить, является ли заданное значение вызываемым, но не строкой.
protected callable valueRetriever(callable|string|null $value)
Получить коллбек для извлечения значения.
protected equality(mixed $value)
Создать функцию для проверки равенства элемента.
protected Closure negate(Closure $callback)
Создать функцию, используя другую функцию, инвертируя её результат.
protected identity()
Создать функцию, возвращающую переданное ей значение.
static void macro(string $name, object|callable $macro)
Зарегистрировать пользовательский макрос.
static void mixin(object $mixin, bool $replace = true)
Смешать другой объект в класс.
static bool hasMacro(string $name)
Проверяет, зарегистрирован ли макрос.
static void flushMacros()
Очистить существующие макросы.
static mixed __callStatic(string $method, array $parameters)
Динамически обрабатывать вызовы к классу.
mixed __call(string $method, array $parameters)
Динамически обрабатывать вызовы к классу.
void __construct(TValue>|TValue>|null $items = [])
Создать новую коллекцию.
static Enumerable range(int $from, int $to)
Без описания
array all()
Без описания
TValue> lazy()
Получить ленивую коллекцию для элементов в этой коллекции.
float|int|null median(string|array<array-key,string>|null $key = null)
Получить медиану заданного ключа.
array<int,float|int>|null mode(string|array<array-key,string>|null $key = null)
Получить моду данных для заданного ключа.
collapse()
Сжатие коллекции элементов в один массив.
bool contains($key, mixed $operator = null, mixed $value = null)
Определить, существует ли ключ в коллекции.
bool containsStrict($key, TValue|null $value = null)
Определить, существует ли элемент, используя строгое сравнение.
bool doesntContain(mixed $key, mixed $operator = null, mixed $value = null)
Определить, не содержится ли элемент в коллекции.
crossJoin(...$lists)
Без описания
Enumerable diff(TValue>|TValue> $items)
Разность коллекций с заданными элементами.
Enumerable diffUsing(TValue>|TValue> $items, callable $callback)
Получить элементы в коллекции, отсутствующие в заданных элементах, используя функцию обратного вызова.
Enumerable diffAssoc(TValue>|TValue> $items)
Получить элементы коллекции, у которых ключи и значения отсутствуют в заданных элементах.
Enumerable diffAssocUsing(TValue>|TValue> $items, callable $callback)
Получить элементы коллекции, у которых ключи и значения отсутствуют в заданных элементах, используя функцию обратного вызова.
Enumerable diffKeys(TValue>|TValue> $items)
Получить элементы коллекции, у которых ключи отсутствуют в заданных элементах.
Enumerable diffKeysUsing(TValue>|TValue> $items, callable $callback)
Получить элементы коллекции, у которых ключи отсутствуют в заданных элементах, используя функцию обратного вызова.
Enumerable duplicates($callback = null, bool $strict = false)
Получить дубликаты из коллекции.
Enumerable duplicatesStrict($callback = null)
Получить дубликаты из коллекции, используя строгое сравнение.
protected duplicateComparator(bool $strict)
Получить функцию сравнения для обнаружения дубликатов.
Enumerable except(TKey>|TKey> $keys)
Без описания
Enumerable filter(callable|null $callback = null)
Применить фильтр к каждому элементу.
first(callable|null $callback = null, $default = null)
Без описания
Enumerable flatten(int $depth = INF)
Получить плоский массив элементов коллекции.
flip()
Перевернуть элементы в коллекции.
$this forget($keys)
Удалить элемент из коллекции по ключу.
\Illuminate\Contracts\Support\Arrayable<array-key, TValue>|iterable<array-key, TKey>|TKey $keys
get($key, $default = null)
Описание отсутствует
getOrPut($key, $value)
Описание отсутствует
groupBy($groupBy, $preserveKeys = false)
Описание отсутствует
keyBy($keyBy)
Описание отсутствует
bool has(TKey|TKey> $key)
Определить, существует ли элемент в коллекции по ключу.
bool hasAny(mixed $key)
Определить, существуют ли какие-либо ключи в коллекции.
string implode(callable|string $value, string|null $glue = null)
Объединить значения заданного ключа в строку.
Enumerable intersect(TValue>|TValue> $items)
Пересечение коллекции с заданными элементами.
Enumerable intersectUsing(TValue>|TValue> $items, callable $callback)
Пересечение коллекции с заданными элементами с использованием обратного вызова.
Enumerable intersectAssoc(TValue>|TValue> $items)
Пересечение коллекции с заданными элементами с дополнительной проверкой индекса.
Enumerable intersectAssocUsing(TValue>|TValue> $items, callable $callback)
Пересечение коллекции с заданными элементами с дополнительной проверкой индекса с использованием обратного вызова.
Enumerable intersectByKeys(TValue>|TValue> $items)
Пересечение коллекции с заданными элементами по ключу.
bool isEmpty()
Определить, пуста ли коллекция.
bool containsOneItem()
Определить, содержит ли коллекция один элемент.
string join(string $glue, string $finalGlue = '')
Объединить все элементы из коллекции, используя строку. Для последних элементов можно использовать отдельную строку склеивания.
keys()
Получить ключи элементов коллекции.
last(callable|null $callback = null, $default = null)
Описание отсутствует
pluck($value, $key = null)
Получить массив со значениями заданного ключа.
map(callable $callback)
Описание отсутствует
mapToDictionary(callable $callback)
Описание отсутствует
mapWithKeys(callable $callback)
Описание отсутствует
Enumerable merge(TValue>|TValue> $items)
Объединить коллекцию с заданными элементами.
mergeRecursive($items)
Без описания
Collection multiply(int $multiplier)
Умножить элементы в коллекции на множитель.
combine($values)
Без описания
Enumerable union(TValue>|TValue> $items)
Объединить коллекцию с заданными элементами.
Enumerable nth(int $step, int $offset = 0)
Создать новую коллекцию, содержащую каждый n-й элемент.
Enumerable only(TKey>|TKey>|string $keys)
Без описания
Collection select(TKey>|TKey>|string|null $keys)
Выбрать определенные значения из элементов внутри коллекции.
pop($count = 1)
Без описания
$this prepend(TValue $value, TKey $key = null)
Добавить элемент в начало коллекции.
$this push(TValue ...$values)
Добавить один или несколько элементов в конец коллекции.
$this unshift(TValue ...$values)
Добавить один или несколько элементов в начало коллекции.
concat($source)
Без описания
pull($key, $default = null)
Без описания
$this put(TKey $key, TValue $value)
Поместить элемент в коллекцию по ключу.
random($number = null, $preserveKeys = false)
Без описания
Enumerable replace(TValue>|TValue> $items)
Заменить элементы коллекции заданными элементами.
Enumerable replaceRecursive(TValue>|TValue> $items)
Рекурсивно заменить элементы коллекции заданными элементами.
Enumerable reverse()
Инвертировать порядок элементов.
TKey|bool search($value, bool $strict = false)
Найти в коллекции заданное значение и вернуть соответствующий ключ, если поиск успешен.
TValue|null before($value, bool $strict = false)
Получить элемент, предшествующий заданному элементу.
TValue|null after($value, bool $strict = false)
Получить элемент, следующий за заданным элементом.
shift($count = 1)
Описание отсутствует
Enumerable shuffle()
Перемешать элементы в коллекции.
sliding($size = 2, $step = 1)
Описание отсутствует
Enumerable skip(int $count)
Пропустить первые {$count} элементов.
Enumerable skipUntil($value)
Пропустить элементы в коллекции до тех пор, пока не будет выполнено заданное условие.
Enumerable skipWhile($value)
Пропустить элементы в коллекции, пока выполняется заданное условие.
Enumerable slice(int $offset, int|null $length = null)
Выделить фрагмент из базового массива коллекции.
split($numberOfGroups)
Описание отсутствует
splitIn($numberOfGroups)
Описание отсутствует
TValue sole($key = null, mixed $operator = null, mixed $value = null)
Получить первый элемент в коллекции, только если существует ровно один элемент. В противном случае выбросить исключение.
TValue firstOrFail($key = null, mixed $operator = null, mixed $value = null)
Получить первый элемент в коллекции, но выбросить исключение, если соответствующие элементы не найдены.
chunk($size)
Описание отсутствует
chunkWhile(callable $callback)
Описание отсутствует
Enumerable sort($callback = null)
Отсортировать каждый элемент с помощью обратного вызова.
Enumerable sortDesc(int $options = SORT_REGULAR)
Отсортировать элементы в порядке убывания.
Enumerable sortBy($callback, int $options = SORT_REGULAR, bool $descending = false)
Отсортировать коллекцию с использованием данного обратного вызова.
protected Collection sortByMany(array $comparisons = [], int $options = SORT_REGULAR)
Отсортировать коллекцию, используя несколько сравнений.
Enumerable sortByDesc($callback, int $options = SORT_REGULAR)
Отсортировать коллекцию в порядке убывания с использованием заданного обратного вызова.
Enumerable sortKeys(int $options = SORT_REGULAR, bool $descending = false)
Сортировка ключей коллекции.
Enumerable sortKeysDesc(int $options = SORT_REGULAR)
Сортировка ключей коллекции в порядке убывания.
Enumerable sortKeysUsing(callable $callback)
Сортировка ключей коллекции с использованием обратного вызова.
Collection splice(int $offset, int|null $length = null, TValue> $replacement = [])
Вставка в массив коллекции.
Enumerable take(int $limit)
Получение первых или последних {$limit} элементов.
Enumerable takeUntil($value)
Получение элементов из коллекции до тех пор, пока не будет выполнено заданное условие.
Enumerable takeWhile($value)
Получение элементов из коллекции, пока выполняется заданное условие.
$this transform(callable $callback)
Преобразование каждого элемента в коллекции с помощью обратного вызова.
Collection dot()
Развернуть многомерный ассоциативный массив с точками.
Enumerable undot()
Преобразовать массив в формате «точка» в расширенный массив.
values()
Без описания
zip($items)
Объединить коллекцию с одним или несколькими массивами.
pad($size, $value)
Дополнить коллекцию до указанной длины значением.
Traversable getIterator()
Получить итератор для элементов.
int count()
Подсчитать количество элементов в коллекции.
countBy($countBy = null)
Подсчитать количество элементов в коллекции по полю или с помощью обратного вызова.
$this add(TValue $item)
Добавить элемент в коллекцию.
TValue> toBase()
Получить базовый экземпляр коллекции Support из этой коллекции.
bool offsetExists(TKey $key)
Определить, существует ли элемент по заданному смещению.
mixed offsetGet(TKey $key)
Получить элемент по заданному смещению.
void offsetSet(TKey|null $key, TValue $value)
Установить элемент по заданному смещению.
void offsetUnset(TKey $key)
Удалить элемент по заданному смещению.
protected mixed getDictionaryKey(mixed $attribute)
Получить атрибут ключа словаря — при необходимости привести его к строковому типу.
find($key, $default = null)
Без описания
$this load($relations)
Загрузить набор взаимосвязей в коллекцию.
$this loadAggregate($relations, string $column, string|null $function = null)
Загрузить набор агрегаций по столбцу взаимосвязи в коллекцию.
$this loadCount($relations)
Загрузить набор подсчетов взаимосвязей в коллекцию.
$this loadMax($relations, string $column)
Загрузить набор максимальных значений столбца взаимосвязи в коллекцию.
$this loadMin($relations, string $column)
Загрузить набор минимальных значений столбца взаимосвязи в коллекцию.
$this loadSum($relations, string $column)
Загрузить набор сумм значений столбца взаимосвязи в коллекцию.
$this loadAvg($relations, string $column)
Загрузить набор средних значений столбца взаимосвязи в коллекцию.
$this loadExists($relations)
Загрузить набор значений существования связанных элементов в коллекцию.
$this loadMissing($relations)
Загрузить набор взаимосвязей в коллекцию, если они еще не загружены.
protected void loadMissingRelation(Collection $models, array $path)
Загрузить путь взаимосвязи, если он еще не загружен.
$this loadMorph(string $relation, $relations)
Загрузить набор взаимосвязей в коллекцию смешанных взаимосвязей.
$this loadMorphCount(string $relation, $relations)
Загрузить набор подсчетов взаимосвязей в коллекцию смешанных взаимосвязей.
array<int,array-key> modelKeys()
Получить массив первичных ключей.
Collection fresh(array<array-key,string>|string $with = [])
Перезагрузить свежую модель из базы данных для всех сущностей.
$this makeHidden(array<array-key,string>|string $attributes)
Скрыть указанные, обычно видимые, атрибуты во всей коллекции.
$this makeVisible(array<array-key,string>|string $attributes)
Сделать указанные, обычно скрытые, атрибуты видимыми во всей коллекции.
$this setVisible(array<int,string> $visible)
Установить видимые атрибуты во всей коллекции.
$this setHidden(array<int,string> $hidden)
Установить скрытые атрибуты во всей коллекции.
$this append(array<array-key,string>|string $attributes)
Добавить атрибут ко всей коллекции.
TModel> getDictionary(TModel>|null $items = null)
Получить словарь, индексированный первичными ключами.
string|null getQueueableClass()
Получить тип сущностей, которые будут помещены в очередь.
protected string getQueueableModelClass(Model $model)
Получить имя класса, отвечающего за размещение модели в очереди.
array<int,mixed> getQueueableIds()
Получить идентификаторы всех сущностей.
array<int,string> getQueueableRelations()
Получить отношения сущностей, которые будут помещены в очередь.
string|null getQueueableConnection()
Получить соединение для сущностей, которые будут помещены в очередь.
TModel> toQuery()
Получить Eloquent-строитель запроса из коллекции.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/11.x/Illuminate/Database/Eloquent/Collection.html
