Коллекция
класс Collection реализует ArrayAccess, Arrayable, Countable, IteratorAggregate, Jsonable, JsonSerializable (Просмотреть исходный код)
Трейты
| Macroable |
Свойства
| статический защищенный массив | $macros | Зарегистрированные строковые макросы. | из Macroable |
| защищенный массив | $items | Элементы, содержащиеся в коллекции. | |
| статический защищенный массив | $proxies | Методы, которые могут быть проксированы. |
Методы
| static void | macro(string $name, object|callable $macro) Зарегистрировать пользовательское макро. | from Macroable |
| static void | mixin(object $mixin) Смешать другой объект в класс. | 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(mixed $items = []) Создать новую коллекцию. | |
| static Collection | make(mixed $items = []) Создать новый экземпляр коллекции, если значение не является коллекцией. | |
| static Collection | wrap(mixed $value) Оборачивает данное значение в коллекцию, если применимо. | |
| static array | unwrap(array|Collection $value) Получить базовые элементы из заданной коллекции, если применимо. | |
| static Collection | times(int $number, callable $callback = null) Создать новую коллекцию, вызвав обратный вызов заданное количество раз. | |
| array | all() Получить все элементы в коллекции. | |
| mixed | avg(callable|string|null $callback = null) Получить среднее значение заданного ключа. | |
| mixed | average(callable|string|null $callback = null) Псевдоним для метода "avg". | |
| mixed | median(null $key = null) Получить медиану заданного ключа. | |
| array|null | mode(mixed $key = null) Получить моду заданного ключа. | |
| Collection | collapse() Сжать коллекцию элементов в один массив. | |
| bool | contains(mixed $key, mixed $operator = null, mixed $value = null) Определить, существует ли элемент в коллекции. | |
| bool | containsStrict(mixed $key, mixed $value = null) Определить, существует ли элемент в коллекции с использованием строгого сравнения. | |
| Collection | crossJoin(mixed $lists) Перекрестное объединение с заданными списками, возвращая все возможные перестановки. | |
| void | dd() Вывести коллекцию и завершить скрипт. | |
| $this | dump() Вывести коллекцию. | |
| Collection | diff(mixed $items) Получить элементы в коллекции, которых нет в заданных элементах. | |
| Collection | diffAssoc(mixed $items) Получить элементы в коллекции, у которых ключи и значения не присутствуют в заданных элементах. | |
| Collection | diffKeys(mixed $items) Получить элементы в коллекции, у которых ключи не присутствуют в заданных элементах. | |
| $this | each(callable $callback) Выполнить обратный вызов для каждого элемента. | |
| Collection | eachSpread(callable $callback) Выполнить обратный вызов над каждым вложенным фрагментом элементов. | |
| bool | every(string|callable $key, mixed $operator = null, mixed $value = null) Определить, проходят ли все элементы в коллекции заданный тест. | |
| Collection | except(mixed $keys) Получить все элементы, кроме тех, у которых указаны ключи. | |
| Collection | filter(callable $callback = null) Применить фильтр к каждому из элементов. | |
| mixed | when(bool $value, callable $callback, callable $default = null) Применить обратный вызов, если значение истинно. | |
| mixed | unless(bool $value, callable $callback, callable $default = null) Применить обратный вызов, если значение ложно. | |
| Collection | where(string $key, mixed $operator, mixed $value = null) Фильтровать элементы по заданной паре ключ-значение. | |
| Closure | operatorForWhere(string $key, string $operator, mixed $value) Получить обратный вызов для проверки оператора. | |
| Collection | whereStrict(string $key, mixed $value) Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | |
| Collection | whereIn(string $key, mixed $values, bool $strict = false) Фильтровать элементы по заданной паре ключ-значение. | |
| Collection | whereInStrict(string $key, mixed $values) Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | |
| Collection | whereNotIn(string $key, mixed $values, bool $strict = false) Фильтровать элементы по заданной паре ключ-значение. | |
| Collection | whereNotInStrict(string $key, mixed $values) Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения. | |
| mixed | first(callable $callback = null, mixed $default = null) Получить первый элемент из коллекции. | |
| Collection | flatten(int $depth = INF) Получить уплощённый массив элементов в коллекции. |
| Коллекция | flip() Перевернуть элементы в коллекции. | |
| $this | forget(string|array $keys) Удалить элемент из коллекции по ключу. | |
| mixed | get(mixed $key, mixed $default = null) Получить элемент из коллекции по ключу. | |
| Коллекция | groupBy(callable|string $groupBy, bool $preserveKeys = false) Сгруппировать ассоциативный массив по полю или с помощью обратного вызова. | |
| Коллекция | keyBy(callable|string $keyBy) Сделать ключ ассоциативного массива по полю или с помощью обратного вызова. | |
| bool | has(mixed $key) Определить, существует ли элемент в коллекции по ключу. | |
| string | implode(string $value, string $glue = null) Конкатенировать значения заданного ключа в строку. | |
| Коллекция | intersect(mixed $items) Пересечь коллекцию с заданными элементами. | |
| Коллекция | intersectByKeys(mixed $items) Пересечь коллекцию с заданными элементами по ключу. | |
| bool | isEmpty() Определить, пуста ли коллекция. | |
| bool | isNotEmpty() Определить, не пуста ли коллекция. | |
| bool | useAsCallable(mixed $value) Определить, является ли заданное значение вызываемым, но не строкой. | |
| Коллекция | keys() Получить ключи элементов коллекции. | |
| mixed | last(callable $callback = null, mixed $default = null) Получить последний элемент из коллекции. | |
| Коллекция | pluck(string|array $value, string|null $key = null) Получить значения заданного ключа. | |
| Коллекция | map(callable $callback) Применить преобразование к каждому элементу. | |
| Коллекция | mapSpread(callable $callback) Применить преобразование к каждому вложенному блоку элементов. | |
| Коллекция | mapToGroups(callable $callback) Применить группирующее преобразование к элементам. | |
| Коллекция | mapWithKeys(callable $callback) Применить ассоциативное преобразование к каждому элементу. | |
| Коллекция | flatMap(callable $callback) Преобразовать коллекцию и уплосштить результат на один уровень. | |
| Коллекция | mapInto(string $class) Преобразовать значения в новый класс. | |
| mixed | max(callable|string|null $callback = null) Получить максимальное значение заданного ключа. | |
| Коллекция | merge(mixed $items) Объединить коллекцию с заданными элементами. | |
| Коллекция | combine(mixed $values) Создать коллекцию, используя эту коллекцию для ключей и другую для значений. | |
| Коллекция | union(mixed $items) Объединить коллекцию с заданными элементами. | |
| mixed | min(callable|string|null $callback = null) Получить минимальное значение заданного ключа. | |
| Коллекция | nth(int $step, int $offset) Создать новую коллекцию, состоящую из каждого n-го элемента. | |
| Коллекция | only(mixed $keys) Получить элементы со значениями заданных ключей. | |
| Коллекция | forPage(int $page, int $perPage) Разбить коллекцию на страницы, создав более мелкие коллекции. | |
| Коллекция | partition(callable|string $callback) Разделить коллекцию на две части, используя заданный обратный вызов или ключ. | |
| mixed | pipe(callable $callback) Передать коллекцию в заданный обратный вызов и вернуть результат. | |
| mixed | pop() Получить и удалить последний элемент из коллекции. | |
| $this | prepend(mixed $value, mixed $key = null) Добавить элемент в начало коллекции. | |
| $this | push(mixed $value) Добавить элемент в конец коллекции. | |
| $this | concat(Traversable $source) Добавить все заданные элементы в коллекцию. | |
| mixed | pull(mixed $key, mixed $default = null) Получить и удалить элемент из коллекции. | |
| $this | put(mixed $key, mixed $value) Поместить элемент в коллекцию по ключу. | |
| mixed | random(int|null $number = null) Случайно получить один или несколько элементов из коллекции. | |
| mixed | reduce(callable $callback, mixed $initial = null) Свести коллекцию к одному значению. | |
| Коллекция | reject(callable|mixed $callback) Создать коллекцию всех элементов, которые не прошли заданный тест истинности. | |
| Коллекция | reverse() Перевернуть порядок элементов. | |
| mixed | search(mixed $value, bool $strict = false) Найти в коллекции заданное значение и вернуть соответствующий ключ, если поиск успешен. | |
| mixed | shift() Получить и удалить первый элемент из коллекции. |
| Коллекция | shuffle(int $seed = null) Перемешать элементы в коллекции. | |
| Коллекция | slice(int $offset, int $length = null) Выделить фрагмент массива коллекции. | |
| Коллекция | split(int $numberOfGroups) Разделить коллекцию на определенное количество групп. | |
| Коллекция | chunk(int $size) Разбить массив коллекции на части. | |
| Коллекция | sort(callable $callback = null) Отсортировать каждый элемент с помощью обратного вызова. | |
| Коллекция | sortBy(callable|string $callback, int $options = SORT_REGULAR, bool $descending = false) Отсортировать коллекцию с помощью заданного обратного вызова. | |
| Коллекция | sortByDesc(callable|string $callback, int $options = SORT_REGULAR) Отсортировать коллекцию в обратном порядке с помощью заданного обратного вызова. | |
| Коллекция | splice(int $offset, int|null $length = null, mixed $replacement = []) Вставить/удалить фрагмент массива коллекции. | |
| mixed | sum(callable|string|null $callback = null) Получить сумму заданных значений. | |
| Коллекция | take(int $limit) Получить первые или последние {$limit} элементов. | |
| $this | tap(callable $callback) Передать коллекцию в заданный обратный вызов, а затем вернуть её. | |
| $this | transform(callable $callback) Преобразовать каждый элемент в коллекции с помощью обратного вызова. | |
| Коллекция | unique(string|callable|null $key = null, bool $strict = false) Возвратить только уникальные элементы из массива коллекции. | |
| Коллекция | uniqueStrict(string|callable|null $key = null) Возвратить только уникальные элементы из массива коллекции, используя строгое сравнение. | |
| Коллекция | values() Сбросить ключи в базовом массиве. | |
| callable | valueRetriever(string $value) Получить обратный вызов для извлечения значения. | |
| Коллекция | zip(mixed $items) Скомпоновать коллекцию вместе с одним или несколькими массивами. | |
| Коллекция | pad(int $size, mixed $value) Заполнить коллекцию до указанной длины значением. | |
| массив | toArray() Получить коллекцию элементов в виде простого массива. | |
| массив | jsonSerialize() Преобразовать объект в что-то сериализуемое в JSON. | |
| строка | toJson(int $options) Получить коллекцию элементов в формате JSON. | |
| ArrayIterator | getIterator() Получить итератор для элементов. | |
| CachingIterator | getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING) Получить экземпляр CachingIterator. | |
| целое число | count() Подсчитать количество элементов в коллекции. | |
| Коллекция | toBase() Получить базовый экземпляр коллекции Support из этой коллекции. | |
| boolean | offsetExists(mixed $key) Определить, существует ли элемент по заданному смещению. | |
| mixed | offsetGet(mixed $key) Получить элемент по заданному смещению. | |
| void | offsetSet(mixed $key, mixed $value) Установить элемент по заданному смещению. | |
| void | offsetUnset(string $key) Удалить элемент по заданному смещению. | |
| строка | __toString() Преобразовать коллекцию в строковое представление. | |
| массив | getArrayableItems(mixed $items) Массив результатов элементов из коллекции или Arrayable. | |
| static void | proxy(string $method) Добавить метод в список проксируемых методов. | |
| mixed | __get(string $key) Динамический доступ к прокси коллекции. |
Подробности
static void macro(string $name, object|callable $macro)
Зарегистрировать пользовательский макрос.
static void mixin(object $mixin)
Смешать другой объект в класс.
static bool hasMacro(string $name)
Проверяет, зарегистрирован ли макрос.
static mixed __callStatic(string $method, array $parameters)
Динамически обрабатывать вызовы к классу.
смешанный тип __call(строка $method, массив $parameters)
Динамически обрабатывать вызовы класса.
void __construct(смешанный тип $items = [])
Создать новую коллекцию.
статический Коллекция make(смешанный тип $items = [])
Создать новый экземпляр коллекции, если значение не является коллекцией.
статический Коллекция wrap(смешанный тип $value)
Оборачивает заданное значение в коллекцию, если это возможно.
статический массив unwrap(массив|Коллекция $value)
Получить базовые элементы из заданной коллекции, если это возможно.
статический Коллекция times(целое число $number, вызываемый объект $callback = null)
Создать новую коллекцию, вызвав обратный вызов заданное количество раз.
массив all()
Получить все элементы в коллекции.
смешанный тип avg(вызываемый объект|строка|null $callback = null)
Получить среднее значение заданного ключа.
смешанный тип average(вызываемый объект|строка|null $callback = null)
Псевдоним для метода "avg".
смешанный тип median(null $key = null)
Получить медиану заданного ключа.
массив|null mode(смешанный тип $key = null)
Получить моду заданного ключа.
Коллекция collapse()
Сжать коллекцию элементов в один массив.
логический тип contains(смешанный тип $key, смешанный тип $operator = null, смешанный тип $value = null)
Определить, существует ли элемент в коллекции.
логический тип containsStrict(смешанный тип $key, смешанный тип $value = null)
Определить, существует ли элемент в коллекции, используя строгое сравнение.
Коллекция crossJoin(смешанный тип $lists)
Перекрестное соединение со списками, возвращая все возможные перестановки.
void dd()
Вывести коллекцию и завершить сценарий.
$this dump()
Вывести коллекцию.
Коллекция diff(смешанный тип $items)
Получить элементы в коллекции, которых нет в заданных элементах.
Коллекция diffAssoc(смешанный тип $items)
Получить элементы в коллекции, ключи и значения которых отсутствуют в заданных элементах.
Коллекция diffKeys(смешанный тип $items)
Получить элементы в коллекции, ключи которых отсутствуют в заданных элементах.
$this each(вызываемый объект $callback)
Выполнить обратный вызов для каждого элемента.
Коллекция eachSpread(callable $callback)
Выполнить обратный вызов для каждого вложенного набора элементов.
bool every(string|callable $key, mixed $operator = null, mixed $value = null)
Определить, проходят ли все элементы в коллекции заданный тест.
Коллекция except(mixed $keys)
Получить все элементы, кроме тех, ключи которых указаны.
Коллекция filter(callable $callback = null)
Применить фильтр ко всем элементам.
mixed when(bool $value, callable $callback, callable $default = null)
Применить обратный вызов, если значение истинно.
mixed unless(bool $value, callable $callback, callable $default = null)
Применить обратный вызов, если значение ложно.
Коллекция where(string $key, mixed $operator, mixed $value = null)
Отфильтровать элементы по заданной паре ключ-значение.
protected Замыкание operatorForWhere(string $key, string $operator, mixed $value)
Получить обратный вызов для проверки оператора.
Коллекция whereStrict(string $key, mixed $value)
Отфильтровать элементы по заданной паре ключ-значение, используя строгое сравнение.
Коллекция whereIn(string $key, mixed $values, bool $strict = false)
Отфильтровать элементы по заданной паре ключ-значение.
Коллекция whereInStrict(string $key, mixed $values)
Отфильтровать элементы по заданной паре ключ-значение, используя строгое сравнение.
Коллекция whereNotIn(string $key, mixed $values, bool $strict = false)
Отфильтровать элементы по заданной паре ключ-значение.
Коллекция whereNotInStrict(string $key, mixed $values)
Отфильтровать элементы по заданной паре ключ-значение, используя строгое сравнение.
mixed first(callable $callback = null, mixed $default = null)
Получить первый элемент из коллекции.
Коллекция flatten(int $depth = INF)
Получить сплющенную массив элементов из коллекции.
Коллекция flip()
Перевернуть элементы в коллекции.
$this forget(string|array $keys)
Удалить элемент из коллекции по ключу.
mixed get(mixed $key, mixed $default = null)
Получить элемент из коллекции по ключу.
Коллекция groupBy(callable|string $groupBy, bool $preserveKeys = false)
Сгруппировать ассоциативный массив по полю или с помощью обратного вызова.
Коллекция keyBy(callable|string $keyBy)
Установить ключи ассоциативного массива по полю или с помощью обратного вызова.
bool has(mixed $key)
Определить, существует ли элемент в коллекции по ключу.
string implode(string $value, string $glue = null)
Склеить значения заданного ключа в строку.
Коллекция intersect(mixed $items)
Пересечь коллекцию с заданными элементами.
Коллекция intersectByKeys(mixed $items)
Пересечь коллекцию с заданными элементами по ключу.
bool isEmpty()
Определить, пуста ли коллекция.
bool isNotEmpty()
Определить, не пуста ли коллекция.
protected bool useAsCallable(mixed $value)
Определить, является ли данное значение вызываемым, но не строкой.
Коллекция keys()
Получить ключи элементов коллекции.
mixed last(callable $callback = null, mixed $default = null)
Получить последний элемент из коллекции.
Коллекция pluck(string|array $value, string|null $key = null)
Получить значения заданного ключа.
Коллекция map(callable $callback)
Применить отображение ко всем элементам.
Коллекция mapSpread(callable $callback)
Применить отображение к каждой вложенной группе элементов.
Коллекция mapToGroups(callable $callback)
Применить отображение для группировки элементов.
Обратный вызов должен возвращать ассоциативный массив с единственной парой ключ/значение.
Коллекция mapWithKeys(callable $callback)
Применить ассоциативное отображение ко всем элементам.
Обратный вызов должен возвращать ассоциативный массив с единственной парой ключ/значение.
Коллекция flatMap(callable $callback)
Применить отображение к коллекции и уплостить результат на один уровень.
Коллекция mapInto(string $class)
Применить отображение к значениям в новый класс.
mixed max(callable|string|null $callback = null)
Получить максимальное значение заданного ключа.
Коллекция merge(mixed $items)
Объединить коллекцию с заданными элементами.
Collection combine(mixed $values)
Создать коллекцию, используя эту коллекцию для ключей и другую для значений.
Collection union(mixed $items)
Объединить коллекцию с заданными элементами.
mixed min(callable|string|null $callback = null)
Получить минимальное значение заданного ключа.
Collection nth(int $step, int $offset)
Создать новую коллекцию, состоящую из каждого n-го элемента.
Collection only(mixed $keys)
Получить элементы со значениями указанных ключей.
Collection forPage(int $page, int $perPage)
«Разбить» коллекцию на части меньшего размера.
Collection partition(callable|string $callback)
Разбить коллекцию на два массива с помощью заданной функции обратного вызова или ключа.
mixed pipe(callable $callback)
Передать коллекцию в заданную функцию обратного вызова и вернуть результат.
mixed pop()
Получить и удалить последний элемент из коллекции.
$this prepend(mixed $value, mixed $key = null)
Добавить элемент в начало коллекции.
$this push(mixed $value)
Добавить элемент в конец коллекции.
$this concat(Traversable $source)
Добавить все заданные элементы в коллекцию.
mixed pull(mixed $key, mixed $default = null)
Получить и удалить элемент из коллекции.
$this put(mixed $key, mixed $value)
Поместить элемент в коллекцию по ключу.
mixed random(int|null $number = null)
Получить один или заданное количество случайных элементов из коллекции.
mixed reduce(callable $callback, mixed $initial = null)
Свести коллекцию к одному значению.
Collection reject(callable|mixed $callback)
Создать коллекцию из всех элементов, которые не удовлетворяют заданному тесту истинности.
Collection reverse()
Перевернуть порядок элементов.
mixed search(mixed $value, bool $strict = false)
Найти в коллекции заданное значение и вернуть соответствующий ключ, если поиск успешен.
mixed shift()
Получить и удалить первый элемент из коллекции.
Коллекция shuffle(int $seed = null)
Перемешать элементы в коллекции.
Коллекция slice(int $offset, int $length = null)
Вырезать часть массива лежащей в основе коллекции.
Коллекция split(int $numberOfGroups)
Разделить коллекцию на определенное количество групп.
Коллекция chunk(int $size)
Разбить массив лежащий в основе коллекции на куски.
Коллекция sort(callable $callback = null)
Отсортировать каждый элемент с помощью обратного вызова.
Коллекция sortBy(callable|string $callback, int $options = SORT_REGULAR, bool $descending = false)
Сортировать коллекцию с помощью предоставленного обратного вызова.
Коллекция sortByDesc(callable|string $callback, int $options = SORT_REGULAR)
Сортировать коллекцию в обратном порядке с помощью предоставленного обратного вызова.
Коллекция splice(int $offset, int|null $length = null, mixed $replacement = [])
Вставить часть массива, лежащего в основе коллекции.
mixed sum(callable|string|null $callback = null)
Получить сумму заданных значений.
Коллекция take(int $limit)
Взять первые или последние {$limit} элементов.
$this tap(callable $callback)
Передать коллекцию в предоставленный обратный вызов, а затем вернуть ее.
$this transform(callable $callback)
Преобразовать каждый элемент в коллекции с помощью обратного вызова.
Коллекция unique(string|callable|null $key = null, bool $strict = false)
Возвратить только уникальные элементы из массива коллекции.
Коллекция uniqueStrict(string|callable|null $key = null)
Возвратить только уникальные элементы из массива коллекции с использованием строгого сравнения.
Коллекция values()
Сбросить ключи в базовом массиве.
protected callable valueRetriever(string $value)
Получить обратный вызов для получения значения.
Коллекция zip(mixed $items)
Объединить коллекцию с одним или несколькими массивами.
Например: new Collection([1, 2, 3])->zip([4, 5, 6]); => [[1, 4], [2, 5], [3, 6]]
Коллекция pad(int $size, mixed $value)
Добавить значения к коллекции до указанной длины.
array toArray()
Получить коллекцию элементов в виде простого массива.
array jsonSerialize()
Преобразовать объект в сериализуемый в JSON формат.
string toJson(int $options)
Получить коллекцию элементов в формате JSON.
ArrayIterator getIterator()
Получить итератор для элементов.
CachingIterator getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING)
Получить экземпляр CachingIterator.
int count()
Подсчитать количество элементов в коллекции.
Collection toBase()
Получить базовый экземпляр коллекции Support из этой коллекции.
bool offsetExists(mixed $key)
Определить, существует ли элемент по заданному смещению.
mixed offsetGet(mixed $key)
Получить элемент по заданному смещению.
void offsetSet(mixed $key, mixed $value)
Установить элемент по заданному смещению.
void offsetUnset(string $key)
Удалить элемент по заданному смещению.
string __toString()
Преобразовать коллекцию в строковое представление.
protected array getArrayableItems(mixed $items)
Получить массив элементов из Collection или Arrayable.
static void proxy(string $method)
Добавить метод в список прокси-методов.
mixed __get(string $key)
Динамический доступ к прокси-объектам коллекции.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.5/Illuminate/Support/Collection.html
