Collections ovat tehokas, fluent-tyylinen kääre taulukoiden ympärillä, jotka tarjoavat kymmeniä ketjutettavia metodeja datan eleganttiin käsittelyyn (map, filter, reduce, groupBy jne.). Eloquent-kyselyjen tulokset palautetaan Collections-objekteina, joten käytät niitä jatkuvasti.
$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 käärii taulukon ja tarjoaa fluent, ketjutettavan API:n — paljon ekspressiivisempi kuin manuaaliset taulukofunktiot, ja ketjutettava puhtaiden datapipelinejen luomiseen.
$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
Koska Eloquent palauttaa Collections-objekteja, voit eleganttisti muuntaa kyselyjen tuloksia PHP:ssä — suurten datasettien tapauksessa on kuitenkin parempi suosia tietokannan kyselyitä kuin kaiken hakemista ja PHP:ssä suodattamista.
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 ovat tärkeä, läpitunkeva Laravel-ominaisuus — ne tekevät taulukoiden ja datan käsittelystä elegantia ja ekspressiivistä, ja koska Eloquent-kyselyjen tulokset ovat Collections, käytät niitä jatkuvasti tietokannan datan käsittelyyn, mikä tekee niistä jokapäiväistä, olennaista tietoa.
Ydinarvona on fluent, ketjutettava API: verbose, imperatiivisen taulukon käsittelyn sijaan Collections antaa sinulle mahdollisuuden ilmaista datan muunnokset (suodatus, kartoitus, ryhmittely, aggregointi, lajittelu) luettaviksi, kompostoitaviksi metodiketjuiksi — merkittävä tuottavuuden ja luettavuuden hyöty, joka ilmentää Laravelin elegantia tyyliä.
Monipuolisen metodijoukon ymmärtäminen (map/filter/reduce muunnokselle, pluck/groupBy/keyBy uudelleenjärjestelylle, aggregointi- ja lajittelumenetelmät) antaa sinulle mahdollisuuden käsitellä dataa puhtaasti ja on välttämätöntä Eloquent-tulosten tehokkaan käsittelyn kannalta (jotka palauttavat Collections-objekteja, joita sitten muunnat).
Collectionsin tunteminen — niiden fluent-API, saatavilla olevien metodien laajuus ja se, että Eloquent käyttää niitä — on perustavanlaatuista tuottavalle Laravel-kehitykselle, koska datan manipulointi on jatkuvaa ja Collections ovat se, kuinka Laravel tekee siitä elegantia. (Yksi tärkeä käytännöllinen varoitus: suurten datasettien suodatukseen/lajitteluun, suosi töiden tekemistä tietokantakyselyssä sen sijaan, että noutaisit kaikki tietueet Collections-objektiin ja käsittelisit niitä PHP:ssä — Collections ovat muistin sisäiselle datan manipuloinnille, eivät tehokkkaiden kyselyjen korvike.) Sujuvuus Collections-käytössä on idiomaattisen, tuottavan Laravel-koodin tunnusmerkki.