Collections yra galingas, sklandus masyvų apvalkalas, suteikiantis dešimtis sujungiamų metodų duomenims elegantiškai apdoroti (map, filter, reduce, groupBy ir kt.). Eloquent užklausų rezultatai grąžinami kaip Collections, todėl jūs juos naudojate nuolat.
$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 suvynioja masyvą ir siūlo sklandų, sujungiamą API — daug išraiškingesnis nei rankiniai masyvo funkcijos, ir sujungiamas grynoms duomenų linijoms.
$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
Kadangi Eloquent grąžina Collections, galite elegantiškai transformuoti užklausų rezultatus PHP — nors didelėms duomenų rinkmenoms geriau pageidautina duomenų bazės užklausų vietoj visam atsisiunčiant ir filtruojant 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 yra svarbi, visur paplitusi Laravel savybė — jos padaro masyvų ir duomenų apdorojimą elegantišku ir išraiškiniu, ir kadangi Eloquent užklausų rezultatai yra Collections, jūs juos naudojate nuolat dirbant su duomenų bazės duomenimis, todėl jie yra kasdienės, esminės žinios.
Pagrindinė vertė yra sklandžias, sujungiamas API: vietoj išsamaus, imperatyvaus masyvo manipuliavimo, Collections leidžia jums išreikšti duomenų transformacijas (filtravimą, žymėjimą, grupavimą, agregavimą, rūšiavimą) kaip skaitytinus, sudarytinus metodų grandinės — didelės produktyvumo ir skaitomų naudą, kuri atspindi Laravel elegantišką stilių.
Supratimas apie turtingą metodų rinkinį (map/filter/reduce transformacijai, pluck/groupBy/keyBy restruktūrizavimui, agregavimo ir rūšiavimo metodai) leidžia jums švariai apdoroti duomenis ir yra būtinas norint efektyviai dirbti su Eloquent rezultatais (kurie grąžina Collections, kuriuos jūs transformuojate).
Collections žinojimas — jų sklandžias API, turimų metodų platus asortimentas, ir tai, kad Eloquent juos naudoja — yra esmingas produktyviam Laravel programavimui, nes duomenų manipuliavimas yra pastovus ir Collections yra tai, kaip Laravel daro jį elegantišku. (Vienas svarbus praktinis įspėjimas: filtruojant/rūšiuojant didelės duomenų bazes, pageidautina darbą atlikti duomenų bazės užklausoje vietoj visų įrašų atsisiunčiamo į Collection ir apdorojimo PHP — Collections yra skirtos atmintyje laikomos duomenų manipuliavimui, o ne efektyvių užklausų pakaitalui.) Fluency naudojant Collections yra idiomatingos, produktyvios Laravel kodo žymė.