Collections janë një rrëmues i fuqishëm dhe i njohur rreth arrayeve, që ofrojnë dhjetëra metoda të zinxhirëzueshme për të punuar me të dhëna në mënyrë elegante (map, filter, reduce, groupBy, etj.). Rezultatet e pyetjeve të Eloquent-it kthehen si Collections, kështu që i përdorni gjatë kohës.
$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
Një Collection mbështjell një array dhe ofron një API të njohur dhe të zinxhirëzueshme — shumë më shprehëse se funksionet manuale të arrayit, dhe e zinxhirëzueshme për tubacione të pastra të të dhënave.
$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
Sepse Eloquent kthen Collections, mund të transformoni elegantisht rezultatet e pyetjeve në PHP — megjithatë, për bashkësi të mëdha të dhënash, preferohet pyetjet e bazës së të dhënave mbi marrjen e gjithçkaje dhe filtrimin në 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 janë një tipar i rëndësishëm, i përhapur i Laravel — ato bëjnë punën me arrayat dhe të dhënat elegante dhe shprehëse, dhe meqenëse rezultatet e pyetjeve të Eloquent janë Collections, i përdorni vazhdimisht kur trajtoni të dhëna nga baza e të dhënave, duke i bërë ato njohuri të përditshme, thelbësore.
Vlera themelore është API-ja e njohur dhe e zinxhirëzueshme: në vend të manipulimit të arrayit të verbose dhe urdhërues, Collections ju lejojnë të shprehni transformimet e të dhënave (filtrimi, hartëzimi, grupimi, grumbullimi, renditja) si zinxhire metodash të lexueshëm dhe të përbërë — një përfitim produktiviteti dhe lexueshmërie të madh që shfaq stilin elegant të Laravel.
Përfaqja e grupit të pasur të metodave (map/filter/reduce për transformim, pluck/groupBy/keyBy për ristrukturimin, metodat e grumbullimit dhe renditjes) ju lejon të përpunoni të dhënat në mënyrë të pastër dhe është e nevojshme për të punuar në mënyrë efektive me rezultatet e Eloquent (të cilat kthehen Collections që më pas transformoni).
Faqja e Collections — API-ja e tyre e njohur, gjerësia e metodave të disponueshme, dhe fakti se Eloquent i përdor ato — është thelbësore për zhvillimin produktiv të Laravel, meqenëse manipulimi i të dhënave është konstant dhe Collections janë mënyra e Laravel për ta bërë atë elegante. (Një kufizim praktik i rëndësishëm: për filtrimin/renditjen e bashkësive të mëdha të të dhënash, preferohet të bëni punën në pyetjen e bazës së të dhënave në vend që të marrni të gjitha regjistrat në një Collection dhe përpunimin në PHP — Collections janë për manipulimin e të dhënave në memorie, jo një zëvendësim për pyetje efikase.) Aftësia me Collections është një shenjë e kodit Laravel idiomatik, produktiv.