Коллекция
класс Collection расширяет Collection и реализует QueueableCollection (View source)
Трейты
| EnumeratesValues | |
| Macroable |
Свойства
Методы
| static EnumeratesValues | make(mixed $items = [])
Создать новый экземпляр коллекции, если значение им не является. | из EnumeratesValues |
| static EnumeratesValues | wrap(mixed $value)
Оборачивает заданное значение в коллекцию, если применимо. | из EnumeratesValues |
| static array | unwrap(array|EnumeratesValues $value)
Получить базовые элементы из заданной коллекции, если применимо. | из EnumeratesValues |
| mixed | average(callable|string|null $callback = null)
Псевдоним для метода "avg". | из EnumeratesValues |
| bool | some(mixed $key, mixed $operator = null, mixed $value = null)
Псевдоним для метода "contains". | из EnumeratesValues |
| bool | containsStrict(mixed $key, mixed $value = null)
Определить, существует ли элемент, используя строгое сравнение. | из EnumeratesValues |
| void | dd(mixed ...$args)
Вывести элементы и завершить сценарий. | из EnumeratesValues |
| $this | dump()
Вывести элементы. | из EnumeratesValues |
| $this | each(callable $callback)
Выполнить обратный вызов для каждого элемента. | из EnumeratesValues |
| EnumeratesValues | eachSpread(callable $callback)
Выполнить обратный вызов для каждого вложенного фрагмента элементов. | из EnumeratesValues |
| bool | every(string|callable $key, mixed $operator = null, mixed $value = null)
Определить, удовлетворяют ли все элементы заданному тесту истинности. | из EnumeratesValues |
| mixed | firstWhere(string $key, mixed $operator = null, mixed $value = null)
Получить первый элемент по заданной паре ключ-значение. | из EnumeratesValues |
| bool | isNotEmpty()
Определить, не пуста ли коллекция. | из EnumeratesValues |
| EnumeratesValues | mapSpread(callable $callback)
Применить отображение к каждому вложенному фрагменту элементов. | из EnumeratesValues |
| EnumeratesValues | mapToGroups(callable $callback)
Применить групповое отображение к элементам. | из EnumeratesValues |
| EnumeratesValues | flatMap(callable $callback)
Применить отображение к коллекции и сгладить результат на один уровень. | из EnumeratesValues |
| EnumeratesValues | mapInto(string $class)
Преобразовать значения в новый класс. | из EnumeratesValues |
| mixed | min(callable|string|null $callback = null)
Получить минимальное значение заданного ключа. | из EnumeratesValues |
| mixed | max(callable|string|null $callback = null)
Получить максимальное значение заданного ключа. | из EnumeratesValues |
| EnumeratesValues | forPage(int $page, int $perPage)
"Разбить на страницы" коллекцию, разделив ее на более мелкие коллекции. | из EnumeratesValues |
| EnumeratesValues | partition(callable|string $key, mixed $operator = null, mixed $value = null)
Разделить коллекцию на два массива с помощью заданного обратного вызова или ключа. | из EnumeratesValues |
| mixed | sum(callable|string|null $callback = null)
Получить сумму заданных значений. | из EnumeratesValues |
| EnumeratesValues|mixed | when(bool|mixed $value, callable $callback = null, callable $default = null)
Применить обратный вызов, если значение истинно. | из EnumeratesValues |
| EnumeratesValues|mixed | whenEmpty(callable $callback, callable $default = null)
Применить обратный вызов, если коллекция пуста. | из EnumeratesValues |
| EnumeratesValues|mixed | whenNotEmpty(callable $callback, callable $default = null)
Применить обратный вызов, если коллекция не пуста. | из EnumeratesValues |
| EnumeratesValues|mixed | unless(bool $value, callable $callback, callable $default = null)
Применить обратный вызов, если значение ложно. | из EnumeratesValues |
| EnumeratesValues|смешанный | unlessEmpty(callable $callback, callable $default = null)
Применить обратный вызов, если коллекция пуста. | из EnumeratesValues |
| EnumeratesValues|смешанный | unlessNotEmpty(callable $callback, callable $default = null)
Применить обратный вызов, если коллекция не пуста. | из EnumeratesValues |
| EnumeratesValues | where(string $key, mixed $operator = null, mixed $value = null)
Фильтровать элементы по заданной паре ключ-значение. | из EnumeratesValues |
| EnumeratesValues | whereNull(string|null $key = null)
Фильтровать элементы, где заданный ключ не равен null. | из EnumeratesValues |
| EnumeratesValues | whereNotNull(string|null $key = null)
Фильтровать элементы, где заданный ключ равен null. | из EnumeratesValues |
| EnumeratesValues | whereStrict(string $key, mixed $value)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | из EnumeratesValues |
| EnumeratesValues | whereIn(string $key, mixed $values, bool $strict = false)
Фильтровать элементы по заданной паре ключ-значение. | из EnumeratesValues |
| EnumeratesValues | whereInStrict(string $key, mixed $values)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | из EnumeratesValues |
| EnumeratesValues | whereBetween(string $key, array $values)
Фильтровать элементы, значение заданного ключа находится между заданными значениями. | из EnumeratesValues |
| EnumeratesValues | whereNotBetween(string $key, array $values)
Фильтровать элементы, значение заданного ключа не находится между заданными значениями. | из EnumeratesValues |
| EnumeratesValues | whereNotIn(string $key, mixed $values, bool $strict = false)
Фильтровать элементы по заданной паре ключ-значение. | из EnumeratesValues |
| EnumeratesValues | whereNotInStrict(string $key, mixed $values)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | из EnumeratesValues |
| EnumeratesValues | whereInstanceOf(string $type)
Фильтровать элементы, удаляя элементы, которые не соответствуют заданному типу. | из EnumeratesValues |
| смешанный | pipe(callable $callback)
Передать коллекцию в заданный обратный вызов и вернуть результат. | из EnumeratesValues |
| $this | tap(callable $callback)
Передать коллекцию в заданный обратный вызов, а затем вернуть её. | из EnumeratesValues |
| EnumeratesValues | reject(callable|смешанный $callback = true)
Создать коллекцию всех элементов, которые не проходят заданный тест истинности. | из EnumeratesValues |
| EnumeratesValues | unique(string|callable|null $key = null, bool $strict = false)
Возвратить только уникальные элементы из коллекции. | |
| EnumeratesValues | uniqueStrict(string|callable|null $key = null)
Возвратить только уникальные элементы из массива коллекции с использованием строгого сравнения. | из EnumeratesValues |
| EnumeratesValues | until(mixed $value) deprecated
Взять элементы в коллекции до тех пор, пока не будет выполнено заданное условие. | из EnumeratesValues |
| Collection | collect()
Собрать значения в коллекцию. | из EnumeratesValues |
| массив | toArray()
Получить коллекцию элементов в виде простого массива. | из EnumeratesValues |
| массив | jsonSerialize()
Преобразовать объект в что-то сериализуемое в JSON. | из EnumeratesValues |
| строка | toJson(int $options = 0)
Получить коллекцию элементов в формате JSON. | из EnumeratesValues |
| CachingIterator | getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING)
Получить экземпляр CachingIterator. | из EnumeratesValues |
| string | __toString()
Преобразовать коллекцию в её строковое представление. | из EnumeratesValues |
| static void | proxy(string $method)
Добавить метод в список прокси-методов. | из EnumeratesValues |
| mixed | __get(string $key)
Динамический доступ к прокси-коллекциям. | из EnumeratesValues |
| array | getArrayableItems(mixed $items)
Получить массив элементов из коллекции или объекта Arrayable. | из EnumeratesValues |
| Closure | operatorForWhere(string $key, string|null $operator = null, mixed $value = null)
Получить обратный вызов для проверки оператора. | из EnumeratesValues |
| bool | useAsCallable(mixed $value)
Определить, является ли заданное значение вызываемым, но не строкой. | из EnumeratesValues |
| callable | valueRetriever(callable|string|null $value)
Получить обратный вызов для извлечения значения. | из EnumeratesValues |
| Closure | equality(mixed $value)
Создать функцию для проверки равенства элемента. | из EnumeratesValues |
| Closure | negate(Closure $callback)
Создать функцию, использующую другую функцию, инвертируя её результат. | из EnumeratesValues |
| Closure | 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 mixed | __callStatic(string $method, array $parameters)
Динамическая обработка вызовов класса. | из Macroable |
| mixed | __call(string $method, array $parameters)
Динамическая обработка вызовов класса. | из Macroable |
| void | __construct(mixed $items = [])
Создание новой коллекции. | из Collection |
| static Enumerable | times(int $number, callable $callback = null)
Создание новой коллекции, вызывая обратный вызов заданное количество раз. | из Collection |
| array | all()
Получить все элементы коллекции. | из Collection |
| LazyCollection | lazy()
Получить ленивую коллекцию для элементов этой коллекции. | из Collection |
| mixed | avg(callable|string|null $callback = null)
Получить среднее значение заданного ключа. | из Collection |
| mixed | median(string|array|null $key = null)
Получить медиану заданного ключа. | из Collection |
| array|null | mode(string|array|null $key = null)
Получить моду заданного ключа. | из Collection |
| Enumerable | collapse()
Схлопнуть коллекцию элементов в один массив. | |
| bool | contains(mixed $key, mixed $operator = null, mixed $value = null)
Определить, существует ли ключ в коллекции. | |
| Collection | crossJoin(mixed ...$lists)
Выполнить кросс-соединение с заданными списками, возвращая все возможные перестановки. | из Collection |
| Enumerable | diff(mixed $items)
Сравнить коллекцию с заданными элементами. | |
| Enumerable | diffUsing(mixed $items, callable $callback)
Получить элементы из коллекции, отсутствующие в заданных элементах, используя обратный вызов. | из Collection |
| Enumerable | diffAssoc(mixed $items)
Получить элементы из коллекции, у которых ключи и значения отсутствуют в заданных элементах. | из Collection |
| Enumerable | diffAssocUsing(mixed $items, callable $callback)
Получить элементы из коллекции, у которых ключи и значения отсутствуют в заданных элементах, используя обратный вызов. | из Collection |
| Enumerable | diffKeys(mixed $items)
Получить элементы в коллекции, ключи которых отсутствуют в заданных элементах. | из Collection |
| Enumerable | diffKeysUsing(mixed $items, callable $callback)
Получить элементы в коллекции, ключи которых отсутствуют в заданных элементах, используя обратный вызов. | из Collection |
| Enumerable | duplicates(callable|null $callback = null, bool $strict = false)
Получить дублирующиеся элементы из коллекции. | из Collection |
| Enumerable | duplicatesStrict(callable|null $callback = null)
Получить дублирующиеся элементы из коллекции, используя строгое сравнение. | из Collection |
| Closure | duplicateComparator(bool $strict)
Получить функцию сравнения для обнаружения дубликатов. | |
| Enumerable | except(mixed $keys)
Возвращает все модели в коллекции, за исключением моделей с указанными ключами. | |
| Enumerable | filter(callable $callback = null)
Применить фильтр к каждому элементу. | из Collection |
| mixed | first(callable $callback = null, mixed $default = null)
Получить первый элемент из коллекции, удовлетворяющий заданному условию. | из Collection |
| Collection | flatten(int $depth = INF)
Получить плоский массив элементов из коллекции. | |
| Enumerable | flip()
Поменять местами ключи и значения в коллекции. | |
| $this | forget(string|array $keys)
Удалить элемент из коллекции по ключу. | из Collection |
| mixed | get(mixed $key, mixed $default = null)
Получить элемент из коллекции по ключу. | из Collection |
| Enumerable | groupBy(array|callable|string $groupBy, bool $preserveKeys = false)
Сгруппировать ассоциативный массив по полю или с помощью обратного вызова. | из Collection |
| Enumerable | keyBy(callable|string $keyBy)
Установить ключи ассоциативного массива по полю или с помощью обратного вызова. | из Collection |
| bool | has(mixed $key)
Определить, существует ли элемент в коллекции по ключу. | из Collection |
| string | implode(string $value, string|null $glue = null)
Объединить значения заданного ключа в строку. | из Collection |
| Enumerable | intersect(mixed $items)
Пересечь коллекцию с заданными элементами. | |
| Enumerable | intersectByKeys(mixed $items)
Пересечь коллекцию с заданными элементами по ключу. | из Collection |
| bool | isEmpty()
Определить, пуста ли коллекция. | из Collection |
| string | join(string $glue, string $finalGlue = '')
Объединить все элементы из коллекции с использованием строки. Для конечных элементов можно использовать отдельную строку разделителя. | из Collection |
| Enumerable | keys()
Получить ключи элементов коллекции. | |
| mixed | last(callable $callback = null, mixed $default = null)
Получить последний элемент из коллекции. | из Collection |
| Enumerable | pluck(string|array $value, string|null $key = null)
Получить массив значений заданного ключа. | |
| Enumerable | map(callable $callback)
Применить отображение к каждому элементу. | |
| Enumerable | mapToDictionary(callable $callback)
Применить отображение словаря к элементам. | из Collection |
| Enumerable | mapWithKeys(callable $callback)
Применить ассоциативное отображение к каждому элементу. | |
| Enumerable | merge(mixed $items)
Объединить коллекцию с заданными элементами. | |
| Enumerable | mergeRecursive(mixed $items)
Рекурсивно объединить коллекцию с заданными элементами. | из Collection |
| Enumerable | combine(mixed $values)
Создать коллекцию, используя эту коллекцию для ключей и другую для значений. | из Collection |
| Enumerable | union(mixed $items)
Объединить коллекцию с заданными элементами. | из Collection |
| Enumerable | nth(int $step, int $offset = 0)
Создайте новый набор, состоящий из каждого n-го элемента. | из Коллекции |
| Enumerable | only(mixed $keys)
Возвращает только модели из набора с указанными ключами. | |
| mixed | pop()
Получить и удалить последний элемент из набора. | из Коллекции |
| $this | prepend(mixed $value, mixed $key = null)
Добавить элемент в начало набора. | из Коллекции |
| $this | push(mixed ...$values)
Добавить один или несколько элементов в конец набора. | из Коллекции |
| Enumerable | concat(iterable $source)
Добавить все заданные элементы в набор. | из Коллекции |
| mixed | pull(mixed $key, mixed $default = null)
Получить и удалить элемент из набора. | из Коллекции |
| $this | put(mixed $key, mixed $value)
Поместить элемент в набор по ключу. | из Коллекции |
| Enumerable|mixed | random(int|null $number = null)
Получить один или указанное количество элементов случайным образом из набора. | из Коллекции |
| mixed | reduce(callable $callback, mixed $initial = null)
Свести набор к одному значению. | из Коллекции |
| Enumerable | replace(mixed $items)
Заменить элементы набора заданными элементами. | из Коллекции |
| Enumerable | replaceRecursive(mixed $items)
Рекурсивно заменить элементы набора заданными элементами. | из Коллекции |
| Enumerable | reverse()
Инвертировать порядок элементов. | из Коллекции |
| mixed | search(mixed $value, bool $strict = false)
Поиск значения в наборе и возвращение соответствующего ключа, если поиск успешен. | из Коллекции |
| mixed | shift()
Получить и удалить первый элемент из набора. | из Коллекции |
| Enumerable | shuffle(int|null $seed = null)
Перемешать элементы в наборе. | из Коллекции |
| Enumerable | skip(int $count)
Пропустить первые {$count} элементов. | из Коллекции |
| Collection | skipUntil(mixed $value)
Пропустить элементы в наборе до тех пор, пока не будет выполнено заданное условие. | из Коллекции |
| Collection | skipWhile(mixed $value)
Пропустить элементы в наборе, пока выполняется заданное условие. | из Коллекции |
| Enumerable | slice(int $offset, int|null $length = null)
Выделить часть массива базовой коллекции. | из Коллекции |
| Enumerable | split(int $numberOfGroups)
Разделить набор на определенное количество групп. | из Коллекции |
| Enumerable | chunk(int $size)
Разбить набор на куски заданного размера. | из Коллекции |
| Enumerable | sort(callable|null|int $callback = null)
Отсортировать каждый элемент с помощью обратного вызова. | из Коллекции |
| Enumerable | sortDesc(int $options = SORT_REGULAR)
Отсортировать элементы в порядке убывания. | из Коллекции |
| Enumerable | sortBy(callable|string $callback, int $options = SORT_REGULAR, bool $descending = false)
Отсортировать набор с использованием заданного обратного вызова. | из Коллекции |
| Enumerable | sortByDesc(callable|string $callback, int $options = SORT_REGULAR)
Отсортировать набор в порядке убывания с использованием заданного обратного вызова. | из Коллекции |
| Enumerable | sortKeys(int $options = SORT_REGULAR, bool $descending = false)
Отсортировать ключи набора. | из Коллекции |
| Enumerable | sortKeysDesc(int $options = SORT_REGULAR)
Отсортировать ключи набора в порядке убывания. | из Коллекции |
| Коллекция | splice(int $offset, int|null $length = null, mixed $replacement = []) Вырезать часть массива базовой коллекции. | из Коллекции |
| Перечисляемый | take(int $limit) Взять первые или последние {$limit} элементы. | из Коллекции |
| Коллекция | takeUntil(mixed $value) Взять элементы из коллекции до тех пор, пока не будет выполнено заданное условие. | из Коллекции |
| Коллекция | takeWhile(mixed $value) Взять элементы из коллекции до тех пор, пока выполняется заданное условие. | из Коллекции |
| $this | transform(callable $callback) Преобразовать каждый элемент в коллекции с помощью обратного вызова. | из Коллекции |
| Перечисляемый | values() Сбросить ключи в базовом массиве. | из Коллекции |
| Коллекция | zip(mixed $items) Сжать коллекцию вместе с одним или несколькими массивами. | |
| Перечисляемый | pad(int $size, mixed $value) Заполнить коллекцию до указанной длины значением. | |
| ArrayIterator | getIterator() Получить итератор для элементов. | из Коллекции |
| int | count() Подсчитать количество элементов в коллекции. | из Коллекции |
| Перечисляемый | countBy(callable|string $countBy = null) Подсчитать количество элементов в коллекции по полю или с помощью обратного вызова. | из Коллекции |
| $this | add(mixed $item) Добавить элемент в коллекцию. | из Коллекции |
| Коллекция | toBase() Получить базовый экземпляр коллекции Support из этой коллекции. | из Коллекции |
| bool | offsetExists(mixed $key) Определить, существует ли элемент по указанному смещению. | из Коллекции |
| mixed | offsetGet(mixed $key) Получить элемент по заданному смещению. | из Коллекции |
| void | offsetSet(mixed $key, mixed $value) Установить элемент по заданному смещению. | из Коллекции |
| void | offsetUnset(string $key) Удалить элемент по заданному смещению. | из Коллекции |
| Модель|Коллекция|null | find(mixed $key, mixed $default = null) Найти модель в коллекции по ключу. | |
| $this | load(array|string $relations) Загрузить набор отношений в коллекцию. | |
| $this | loadCount(array|string $relations) Загрузить набор подсчетов отношений в коллекцию. | |
| $this | loadMissing(array|string $relations) Загрузить набор отношений в коллекцию, если они еще не загружены жадно. | |
| void | loadMissingRelation(Коллекция $models, array $path) Загрузить путь к отношению, если он еще не загружен жадно. | |
| $this | loadMorph(string $relation, array $relations) Загрузить набор отношений в смешанную коллекцию отношений. | |
| $this | loadMorphCount(string $relation, array $relations) Загрузить набор подсчетов отношений в смешанную коллекцию отношений. | |
| array | modelKeys() Получить массив первичных ключей. | |
| Коллекция | fresh(array|string $with = []) Перезагрузить свежий экземпляр модели из базы данных для всех сущностей. | |
| $this | makeHidden(array|string $attributes) Скрыть указанные атрибуты, обычно видимые, для всей коллекции. | |
| $this | makeVisible(array|string $attributes) Сделать указанные атрибуты, обычно скрытые, видимыми во всей коллекции. | |
| $this | append(array|string $attributes) Добавить атрибут ко всей коллекции. | |
| array | getDictionary(ArrayAccess|array|null $items = null) Получить словарь, индексированный первичными ключами. | |
| string|null | getQueueableClass() Получить тип сущностей, которые находятся в очереди. | |
| array | getQueueableIds() Получить идентификаторы всех сущностей. | |
| array | getQueueableRelations() Получить отношения сущностей, находящихся в очереди. | |
| string|null | getQueueableConnection() Получить соединение сущностей, находящихся в очереди. | |
| Билдер | toQuery() Получить Eloquent-билдер запроса из коллекции. |
Подробности
static EnumeratesValues make(mixed $items = [])
Создать новый экземпляр коллекции, если значение не является коллекцией.
static EnumeratesValues wrap(mixed $value)
Оборачивает заданное значение в коллекцию, если применимо.
static array unwrap(array|EnumeratesValues $value)
Получить базовые элементы из заданной коллекции, если применимо.
mixed average(callable|string|null $callback = null)
Псевдоним для метода "avg".
bool some(mixed $key, mixed $operator = null, mixed $value = null)
Псевдоним для метода "contains".
bool containsStrict(mixed $key, mixed $value = null)
Определяет, существует ли элемент, используя строгое сравнение.
void dd(mixed ...$args)
Вывести элементы и завершить скрипт.
$this dump()
Вывести элементы.
$this each(callable $callback)
Выполнить обратный вызов для каждого элемента.
EnumeratesValues eachSpread(callable $callback)
Выполнить обратный вызов для каждого вложенного фрагмента элементов.
bool every(string|callable $key, mixed $operator = null, mixed $value = null)
Определить, проходят ли все элементы заданный тест истинности.
mixed firstWhere(string $key, mixed $operator = null, mixed $value = null)
Получить первый элемент по заданной паре ключ-значение.
bool isNotEmpty()
Определить, не является ли коллекция пустой.
EnumeratesValues mapSpread(callable $callback)
Применить отображение к каждому вложенному фрагменту элементов.
EnumeratesValues mapToGroups(callable $callback)
Применить групповое отображение к элементам.
Обратный вызов должен возвращать ассоциативный массив с единственной парой ключ/значение.
EnumeratesValues flatMap(callable $callback)
Применить отображение к коллекции и уплостить результат на один уровень.
EnumeratesValues mapInto(string $class)
Применить отображение к значениям в новый класс.
mixed min(callable|string|null $callback = null)
Получить минимальное значение заданного ключа.
mixed max(callable|string|null $callback = null)
Получить максимальное значение заданного ключа.
EnumeratesValues forPage(int $page, int $perPage)
Разбить коллекцию на более мелкие коллекции.
EnumeratesValues partition(callable|string $key, mixed $operator = null, mixed $value = null)
Разделить коллекцию на два массива с помощью заданного обратного вызова или ключа.
mixed sum(callable|string|null $callback = null)
Получить сумму заданных значений.
EnumeratesValues|mixed when(bool|mixed $value, callable $callback = null, callable $default = null)
Применить обратный вызов, если значение истинно.
EnumeratesValues|mixed whenEmpty(callable $callback, callable $default = null)
Применить обратный вызов, если коллекция пустая.
EnumeratesValues|mixed whenNotEmpty(callable $callback, callable $default = null)
Применить обратный вызов, если коллекция не пустая.
EnumeratesValues|mixed unless(bool $value, callable $callback, callable $default = null)
Применить обратный вызов, если значение ложно.
EnumeratesValues|mixed unlessEmpty(callable $callback, callable $default = null)
Применить обратный вызов, если коллекция не пустая.
EnumeratesValues|mixed unlessNotEmpty(callable $callback, callable $default = null)
Применить обратный вызов, если коллекция пустая.
EnumeratesValues where(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, mixed $values, bool $strict = false)
Фильтровать элементы по заданной паре ключ-значение.
EnumeratesValues whereInStrict(string $key, mixed $values)
Фильтровать элементы по заданной паре ключ-значение, используя строгое сравнение.
EnumeratesValues whereBetween(string $key, array $values)
Фильтровать элементы так, чтобы значение заданного ключа находилось между заданными значениями.
EnumeratesValues whereNotBetween(string $key, array $values)
Фильтровать элементы так, чтобы значение заданного ключа не находилось между заданными значениями.
EnumeratesValues whereNotIn(string $key, mixed $values, bool $strict = false)
Фильтровать элементы по заданной паре ключ-значение.
EnumeratesValues whereNotInStrict(string $key, mixed $values)
Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.
EnumeratesValues whereInstanceOf(string $type)
Фильтровать элементы, удаляя любые элементы, которые не соответствуют заданному типу.
mixed pipe(callable $callback)
Передать коллекцию заданному обратному вызову и вернуть результат.
$this tap(callable $callback)
Передать коллекцию заданному обратному вызову и затем вернуть ее.
EnumeratesValues reject(callable|mixed $callback = true)
Создать коллекцию всех элементов, которые не проходят заданный тест истинности.
EnumeratesValues unique(string|callable|null $key = null, bool $strict = false)
Возвратить только уникальные элементы из коллекции.
EnumeratesValues uniqueStrict(string|callable|null $key = null)
Возвратить только уникальные элементы из массива коллекции, используя строгое сравнение.
EnumeratesValues until(mixed $value) deprecated
deprecated
Получить элементы в коллекции до тех пор, пока не выполнено заданное условие.
Это псевдоним метода "takeUntil".
Collection collect()
Собрать значения в коллекцию.
array toArray()
Получить коллекцию элементов как обычный массив.
array jsonSerialize()
Преобразовать объект в что-то сериализуемое в JSON.
string toJson(int $options = 0)
Получить коллекцию элементов как JSON.
CachingIterator getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING)
Получить экземпляр CachingIterator.
string __toString()
Преобразовать коллекцию в ее строковое представление.
static void proxy(string $method)
Добавить метод в список проксируемых методов.
mixed __get(string $key)
Динамический доступ к коллекциям-прокси.
protected array getArrayableItems(mixed $items)
Массив элементов из коллекции или Arrayable.
protected Closure operatorForWhere(string $key, string|null $operator = null, mixed $value = null)
Получить обратный вызов для проверки оператора.
protected bool useAsCallable(mixed $value)
Определить, является ли заданное значение вызываемым, но не строкой.
protected callable valueRetriever(callable|string|null $value)
Получить обратный вызов для извлечения значения.
protected Closure equality(mixed $value)
Создать функцию для проверки равенства элемента.
protected Closure negate(Closure $callback)
Создать функцию, используя другую функцию, инвертируя ее результат.
protected Closure identity()
Создать функцию, которая возвращает то, что ей передано.
static void macro(string $name, object|callable $macro)
Зарегистрировать пользовательский макрос.
static void mixin(object $mixin, bool $replace = true)
Добавить другой объект в класс.
static bool hasMacro(string $name)
Проверяет, зарегистрирован ли макрос.
static mixed __callStatic(string $method, array $parameters)
Динамическое обращение к классу.
mixed __call(string $method, array $parameters)
Динамическое обращение к классу.
void __construct(mixed $items = [])
Создать новую коллекцию.
static Enumerable times(int $number, callable $callback = null)
Создать новую коллекцию, вызвав обратный вызов заданное количество раз.
array all()
Получить все элементы в коллекции.
LazyCollection lazy()
Получить ленивую коллекцию для элементов в этой коллекции.
mixed avg(callable|string|null $callback = null)
Получить среднее значение заданного ключа.
mixed median(string|array|null $key = null)
Получить медиану заданного ключа.
array|null mode(string|array|null $key = null)
Получить моду данной ключа.
Enumerable collapse()
Сгруппировать элементы коллекции в один массив.
bool contains(mixed $key, mixed $operator = null, mixed $value = null)
Определить, существует ли ключ в коллекции.
Collection crossJoin(mixed ...$lists)
Выполнить декартово произведение с заданными списками, вернув все возможные перестановки.
Enumerable diff(mixed $items)
Разность коллекций с заданными элементами.
Enumerable diffUsing(mixed $items, callable $callback)
Получить элементы в коллекции, отсутствующие в заданных элементах, используя обратный вызов.
Enumerable diffAssoc(mixed $items)
Получить элементы коллекции, ключи и значения которых отсутствуют в заданных элементах.
Enumerable diffAssocUsing(mixed $items, callable $callback)
Получить элементы коллекции, ключи и значения которых отсутствуют в заданных элементах, используя обратный вызов.
Enumerable diffKeys(mixed $items)
Получить элементы коллекции, ключи которых отсутствуют в заданных элементах.
Enumerable diffKeysUsing(mixed $items, callable $callback)
Получить элементы коллекции, ключи которых отсутствуют в заданных элементах, используя обратный вызов.
Enumerable duplicates(callable|null $callback = null, bool $strict = false)
Получить дубликаты из коллекции.
Enumerable duplicatesStrict(callable|null $callback = null)
Получить дубликаты из коллекции с использованием строгого сравнения.
protected Closure duplicateComparator(bool $strict)
Получить функцию сравнения для обнаружения дубликатов.
Enumerable except(mixed $keys)
Возвращает все модели в коллекции, за исключением моделей со специфицированными ключами.
Enumerable filter(callable $callback = null)
Применить фильтр к каждому элементу.
mixed first(callable $callback = null, mixed $default = null)
Получить первый элемент в коллекции, удовлетворяющий заданному условию.
Collection flatten(int $depth = INF)
Получить плоский массив элементов коллекции.
Enumerable flip()
Перевернуть элементы в коллекции.
$this forget(string|array $keys)
Удалить элемент из коллекции по ключу.
mixed get(mixed $key, mixed $default = null)
Получить элемент из коллекции по ключу.
Enumerable groupBy(array|callable|string $groupBy, bool $preserveKeys = false)
Сгруппировать ассоциативный массив по полю или с помощью обратного вызова.
Enumerable keyBy(callable|string $keyBy)
Установить ключи ассоциативного массива по полю или с помощью обратного вызова.
bool has(mixed $key)
Определить, существует ли элемент в коллекции по ключу.
string implode(string $value, string|null $glue = null)
Объединить значения заданного ключа в строку.
Enumerable intersect(mixed $items)
Пересечение коллекции с заданными элементами.
Enumerable intersectByKeys(mixed $items)
Пересечение коллекции с заданными элементами по ключу.
bool isEmpty()
Определить, пустая ли коллекция.
string join(string $glue, string $finalGlue = '')
Объединить все элементы коллекции с помощью строки. Для последних элементов можно использовать отдельную строку склейки.
Enumerable keys()
Получить ключи элементов коллекции.
mixed last(callable $callback = null, mixed $default = null)
Получить последний элемент из коллекции.
Enumerable pluck(string|array $value, string|null $key = null)
Получить массив со значениями заданного ключа.
Enumerable map(callable $callback)
Применить отображение к каждому из элементов.
Enumerable mapToDictionary(callable $callback)
Применить отображение словаря к элементам.
Обратный вызов должен возвращать ассоциативный массив с единственной парой ключ/значение.
Enumerable mapWithKeys(callable $callback)
Применить отображение ассоциативного массива к каждому из элементов.
Обратный вызов должен возвращать ассоциативный массив с единственной парой ключ/значение.
Enumerable merge(mixed $items)
Объединить коллекцию с заданными элементами.
Enumerable mergeRecursive(mixed $items)
Рекурсивно объединить коллекцию с заданными элементами.
Enumerable combine(mixed $values)
Создать коллекцию, используя эту коллекцию для ключей и другую для значений.
Enumerable union(mixed $items)
Объединить коллекцию с заданными элементами.
Enumerable nth(int $step, int $offset = 0)
Создать новую коллекцию, состоящую из каждого n-го элемента.
Enumerable only(mixed $keys)
Возвращает только модели из коллекции с указанными ключами.
mixed pop()
Получить и удалить последний элемент из коллекции.
$this prepend(mixed $value, mixed $key = null)
Добавить элемент в начало коллекции.
$this push(mixed ...$values)
Добавить один или несколько элементов в конец коллекции.
Enumerable concat(iterable $source)
Добавить все заданные элементы в коллекцию.
mixed pull(mixed $key, mixed $default = null)
Получить и удалить элемент из коллекции.
$this put(mixed $key, mixed $value)
Поместить элемент в коллекцию по ключу.
Enumerable|mixed random(int|null $number = null)
Получить один или заданное количество элементов случайным образом из коллекции.
mixed reduce(callable $callback, mixed $initial = null)
Свести коллекцию к одному значению.
Enumerable replace(mixed $items)
Заменить элементы коллекции заданными элементами.
Enumerable replaceRecursive(mixed $items)
Рекурсивно заменить элементы коллекции заданными элементами.
Enumerable reverse()
Инвертировать порядок элементов.
mixed search(mixed $value, bool $strict = false)
Поиск значения в коллекции и возврат соответствующего ключа при успехе.
mixed shift()
Получить и удалить первый элемент из коллекции.
Enumerable shuffle(int|null $seed = null)
Перемешать элементы в коллекции.
Enumerable skip(int $count)
Пропустить первые {$count} элементов.
Collection skipUntil(mixed $value)
Пропустить элементы в коллекции до тех пор, пока не будет выполнено заданное условие.
Collection skipWhile(mixed $value)
Пропустить элементы в коллекции, пока выполняется заданное условие.
Enumerable slice(int $offset, int|null $length = null)
Вырезать часть массива базовой коллекции.
Enumerable split(int $numberOfGroups)
Разделить коллекцию на определенное количество групп.
Enumerable chunk(int $size)
Разбить коллекцию на части заданного размера.
Enumerable sort(callable|null|int $callback = null)
Сортировать каждый элемент с помощью обратного вызова.
Enumerable sortDesc(int $options = SORT_REGULAR)
Сортировать элементы в порядке убывания.
Enumerable sortBy(callable|string $callback, int $options = SORT_REGULAR, bool $descending = false)
Сортировать коллекцию с помощью заданного обратного вызова.
Enumerable sortByDesc(callable|string $callback, int $options = SORT_REGULAR)
Сортировать коллекцию в порядке убывания с помощью заданного обратного вызова.
Enumerable sortKeys(int $options = SORT_REGULAR, bool $descending = false)
Сортировать ключи коллекции.
Enumerable sortKeysDesc(int $options = SORT_REGULAR)
Сортировать ключи коллекции в порядке убывания.
Collection splice(int $offset, int|null $length = null, mixed $replacement = [])
Вставить/удалить часть массива базовой коллекции.
Enumerable take(int $limit)
Взять первые или последние {$limit} элементов.
Collection takeUntil(mixed $value)
Взять элементы в коллекции до тех пор, пока выполняется заданное условие.
Collection takeWhile(mixed $value)
Взять элементы в коллекции, пока выполняется заданное условие.
$this transform(callable $callback)
Преобразовать каждый элемент в коллекции с помощью обратного вызова.
Enumerable values()
Сбросить ключи в базовом массиве.
Collection zip(mixed $items)
Объединить коллекцию с одним или несколькими массивами.
Enumerable pad(int $size, mixed $value)
Заполнить коллекцию до указанной длины заданным значением.
ArrayIterator getIterator()
Получить итератор для элементов.
int count()
Подсчитать количество элементов в коллекции.
Enumerable countBy(callable|string $countBy = null)
Подсчитать количество элементов в коллекции по полю или с помощью обратного вызова.
$this add(mixed $item)
Добавить элемент в коллекцию.
Collection toBase()
Получить базовый экземпляр коллекции Support из этой коллекции.
bool offsetExists(mixed $key)
Определить, существует ли элемент по данному смещению.
mixed offsetGet(mixed $key)
Получить элемент по заданному смещению.
void offsetSet(mixed $key, mixed $value)
Установить элемент по заданному смещению.
void offsetUnset(string $key)
Удалить элемент по заданному смещению.
Model|Collection|null find(mixed $key, mixed $default = null)
Найти модель в коллекции по ключу.
$this load(array|string $relations)
Загрузить набор отношений для коллекции.
$this loadCount(array|string $relations)
Загрузить подсчет отношений для коллекции.
$this loadMissing(array|string $relations)
Загрузить набор отношений в коллекцию, если они еще не загружены жадно.
protected void loadMissingRelation(Collection $models, array $path)
Загрузить путь к отношениям, если он еще не загружен жадно.
$this loadMorph(string $relation, array $relations)
Загрузить набор отношений в смешанную коллекцию отношений.
$this loadMorphCount(string $relation, array $relations)
Загрузить набор подсчетов отношений в смешанную коллекцию отношений.
array modelKeys()
Получить массив первичных ключей.
Collection fresh(array|string $with = [])
Перезагрузить свежий экземпляр модели из базы данных для всех сущностей.
$this makeHidden(array|string $attributes)
Скрыть заданные, обычно видимые, атрибуты для всей коллекции.
$this makeVisible(array|string $attributes)
Сделать заданные, обычно скрытые, атрибуты видимыми для всей коллекции.
$this append(array|string $attributes)
Добавить атрибут ко всей коллекции.
array getDictionary(ArrayAccess|array|null $items = null)
Получить словарь, индексированный первичными ключами.
string|null getQueueableClass()
Получить тип сущностей, которые будут помещены в очередь.
array getQueueableIds()
Получить идентификаторы всех сущностей.
array getQueueableRelations()
Получить связи сущностей, которые будут помещены в очередь.
string|null getQueueableConnection()
Получить соединение сущностей, которые будут помещены в очередь.
Builder toQuery()
Получить Eloquent-запрос из коллекции.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/7.x/Illuminate/Database/Eloquent/Collection.html