所有 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); } } ~~~ ~~~