Eloquent ORM ―― 集合

Eloquent ORM —— 集合

1、簡介

Eloquent的方法。

當然，所有集合也是迭代器，允許你像數組一樣對其進行循環(huán)：

$users = App\User::where('active', 1)->get();

foreach ($users as $user) {
    echo $user->name;
}

然而，集合比數組更加強大，使用直觀的接口提供了各種映射/簡化操作。例如，讓我們移除所有無效的模型并聚合還存在的用戶的名字：

$users = App\User::where('active', 1)->get();

$names = $users->reject(function ($user) {
    return $user->active === false;})->map(function ($user) {
    return $user->name;
});

2、可用方法

所有的Eloquent集合繼承自Laravel集合基類，因此，它們繼承所有集合基類提供的強大方法：

all
chunk
collapse
contains
count
diff
each
filter
first
flatten
flip
forget
forPage
get
groupBy
has
implode
intersect
isEmpty
keyBy
keys
last
map
merge
pluck
pop
prepend
pull
push
put
random
reduce
reject
reverse
search
shift
shuffle
slice
sort
sortBy
sortByDesc
splice
sum
take
toArray
toJson
transform
unique
values
where
whereLoose
zip

3、自定義集合

如果你需要在自己擴展的方法中使用自定義的集合對象，可以重寫模型上的newCollection方法：

<?php

namespace App;

use App\CustomCollection;
use Illuminate\Database\Eloquent\Model;

class User extends Model{
    /**
     * 創(chuàng)建一個新的Eloquent集合實例
     *
     * @param  array  $models
     * @return \Illuminate\Database\Eloquent\Collection
     */
    public function newCollection(array $models = [])
    {
        return new CustomCollection($models);
    }
}

定義好newCollection方法后，無論何時Eloquent返回該模型的Collection實例你都會獲取到自定義的集合。如果你想要在應用中的每一個模型中使用自定義集合，需要在模型基類中重寫newCollection方法。