Collections to potężny, płynny wrapper wokół tablic, zapewniający dziesiątki łańcuchowanych metod do eleganckich operacji na danych (map, filter, reduce, groupBy, itp.). Wyniki zapytań Eloquent'a są zwracane jako Collections, więc używasz ich stale.
$collection = collect([1, 2, 3, 4, 5]);
$result = $collection
->filter(fn($n) => $n % 2 === 0) // [2, 4]
->map(fn($n) => $n * 10) // [20, 40]
->values(); // re-index
$collection->sum(); // 15
$collection->avg(); // 3
$collection->max(); // 5
Collection opakowuje tablicę i oferuje płynny, łańchuchwany API — znacznie bardziej wyrazisty niż ręczne funkcje tablic, i łańchuchwany dla czystych pipelinów danych.
$users = User::all(); // returns a Collection of User models
$users->where('active', true) // filter
->sortBy('name')
->map(fn($u) => $u->name)
->take(10);
$users->pluck('email'); // extract one field → a collection of emails
$users->groupBy('role'); // group by a field → role => [users]
$users->keyBy('id'); // index by id
Ponieważ Eloquent zwraca Collections, możesz elegancko transformować wyniki zapytań w PHP — jednak dla dużych zbiorów danych preferuj zapytania bazodanowe zamiast pobierania wszystkiego i filtrowania w PHP.
map, filter, reduce, each transform/iterate
pluck, keyBy, groupBy, partition restructure
sum, avg, min, max, count aggregate
sort, sortBy, reverse, unique order/dedup
first, last, take, skip, chunk slice
contains, every, some, where query
implode, flatten, collapse, merge combine
Collections to ważna, wszechobecna funkcja Laravel'a — sprawiają, że praca z tablicami i danymi jest elegancka i wyrażista, a ponieważ wyniki zapytań Eloquent'a są Collections, używasz ich stale podczas obsługi danych z bazy danych, co czyni je codzienną, niezbędną wiedzą.
Rdzenna wartość leży w płynnym, łańchuchowanym API: zamiast zagmatwanych, imperatywnych manipulacji tablicami, Collections pozwalają ci wyrażać transformacje danych (filtrowanie, mapowanie, grupowanie, agregacja, sortowanie) jako czytelne, komponowalne łańcuchy metod — co przynosi znaczącą korzyść w produktywności i czytelności, wcielając elegancki styl Laravel'a.
Zrozumienie bogatego zestawu metod (map/filter/reduce dla transformacji, pluck/groupBy/keyBy dla restrukturyzacji, metody agregacji i sortowania) pozwala ci czyszczać przetwarzanie danych i jest niezbędne do efektywnej pracy z wynikami Eloquent'a (które zwracają Collections, które następnie transformujesz).
Znajomość Collections — ich płynnego API, szerokości dostępnych metod i faktu, że Eloquent je używa — jest fundamentalna dla produktywnego rozwoju Laravel'a, ponieważ manipulacja danymi jest ciągła, a Collections to sposób, w jaki Laravel czyni to eleganckie. (Jedno ważne praktyczne zastrzeżenie: do filtrowania/sortowania dużych zbiorów danych preferuj robienie pracy w zapytaniu bazodanowym zamiast pobierania wszystkich rekordów do Collection'a i przetwarzania w PHP — Collections są do manipulacji danymi w pamięci, nie do zastępowania efektywnych zapytań.) Biegłość w Collections to znamię idiomatycznego, produktywnego kodu Laravel'a.