Apakah Laravel Collection?

Question

Accepted Answer

**Collection** ialah pembalut yang berkuasa dan fasih sekitar array, menyediakan berpuluh-puluh method boleh-rantai untuk bekerja dengan data secara elegan (`map`, `filter`, `reduce`, `groupBy`, dll.). Hasil query Eloquent dipulangkan sebagai Collection, jadi anda menggunakannya secara berterusan.

## Collection membalut array dengan method fasih

```php
$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
```

Sebuah Collection membalut array dan menawarkan API yang fasih dan boleh dirantai — jauh lebih ekspresif daripada fungsi array manual, dan boleh dirantai untuk pipeline data yang bersih.

## Hasil Eloquent IALAH Collection

```php
$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
```

Kerana Eloquent memulangkan Collection, anda boleh mengubah hasil query secara elegan dalam PHP — walaupun untuk set data yang besar, lebih baik gunakan query pangkalan data berbanding mengambil semuanya dan menapis dalam PHP.

## Set method yang kaya

```text
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
```

## Mengapa ia penting

Collection ialah ciri Laravel yang penting dan menyeluruh — ia menjadikan kerja dengan array dan data elegan serta ekspresif, dan kerana **hasil query Eloquent ialah Collection**, anda menggunakannya secara berterusan apabila mengendalikan data pangkalan data, menjadikannya pengetahuan harian yang penting.

Nilai terasnya ialah API yang fasih dan boleh dirantai: daripada manipulasi array yang berjela-jela dan imperatif, Collection membenarkan anda menyatakan transformasi data (menapis, memetakan, mengumpulkan, mengagregat, menyusun) sebagai rantaian method yang mudah dibaca dan boleh dikarang — satu manfaat produktiviti dan kebolehbacaan yang besar yang merangkumi gaya elegan Laravel.

Memahami set method yang kaya (`map`/`filter`/`reduce` untuk transformasi, `pluck`/`groupBy`/`keyBy` untuk penyusunan semula, method agregasi dan penyusunan) membolehkan anda memproses data dengan bersih dan perlu untuk bekerja dengan berkesan dengan hasil Eloquent (yang memulangkan Collection yang kemudian anda ubah).

Mengetahui Collection — API fasihnya, keluasan method yang tersedia, dan bahawa Eloquent menggunakannya — adalah asas untuk pembangunan Laravel yang produktif, kerana manipulasi data adalah berterusan dan Collection ialah cara Laravel menjadikannya elegan. (Satu kaveat praktikal yang penting: untuk menapis/menyusun set data yang besar, lebih baik lakukan kerja itu dalam **query pangkalan data** berbanding mengambil semua rekod ke dalam Collection dan memprosesnya dalam PHP — Collection adalah untuk manipulasi data dalam memori, bukan pengganti untuk query yang cekap.) Kefasihan dengan Collection ialah ciri khas kod Laravel yang idiomatik dan produktif.