所有 Eloquent 查詢返回的數據，如果結果多于一條，不管是經由 get 方法或是 relationship，都會轉換成集合對象返回。這個對象實現了 IteratorAggregate PHP 接口，所以可以像數組一般進行遍歷。而集合對象本身還擁有很多有用的方法可以操作模型數據。 確認集合中里是否包含特定鍵值 例如，我們可以使用 contains 方法，確認結果數據中，是否包含主鍵為特定值的對象。 ~~~ $roles = User::find(1)->roles; if ($roles->contains(2)) { // } ~~~ 集合也可以轉換成數組或 JSON： ~~~ $roles = User::find(1)->roles->toArray(); $roles = User::find(1)->roles->toJson(); ~~~ 如果集合被轉換成字符串類型，會返回 JSON 格式： ~~~ $roles = (string) User::find(1)->roles; ~~~ ## 集合遍歷 Eloquent 集合里包含了一些有用的方法可以進行循環或是進行過濾： ~~~ $roles = $user->roles->each(function($role) { // }); ~~~ ## 集合過濾 過濾集合時，回調函數的使用方式和 array_filter 里一樣。 ~~~ $users = $users->filter(function($user) { return $user->isAdmin(); }); ~~~ > 注意： 如果要在過濾集合之后轉成 JSON，轉換之前先調用 values 方法重設數組的鍵值。 遍歷傳入集合里的每個對象到回調函數 ~~~ $roles = User::find(1)->roles; $roles->each(function($role) { // }); ~~~ ## 依照屬性值排序 ~~~ $roles = $roles->sortBy(function($role) { return $role->created_at; }); ~~~ ## 依照屬性值排序 ~~~ $roles = $roles->sortBy('created_at'); ~~~ ## 返回自定義的集合對象 有時您可能想要返回自定義的集合對象，讓您可以在集合類里加入想要的方法。可以在 Eloquent 模型類里重寫 newCollection 方法： ~~~ class User extends Model { public function newCollection(array $models = []) { return new CustomCollection($models); } } ~~~