Personnaliser les collections

• Eloquent Return Tous les jeux de résultats multiples sont des IlluminateDatabaseEloquentCollection< Instances d'objets /code>, y compris les résultats récupérés via la méthode get ou obtenus en accédant aux relations. L'objet collection d'Eloquent hérite de la classe de base de collection de Laravel, il hérite donc naturellement également de dizaines de méthodes capables de gérer avec élégance le tableau sous-jacent de modèles Eloquent. De plus, toutes les collections peuvent être utilisées comme itérateurs, et vous pouvez les parcourir comme un simple tableau PHP :

$users = App\User::where('active', 1)->get();
foreach ($users as $user) { 
   echo $user->name;
 }

• Cependant, les collections sont plus puissantes que les tableaux, exposant des appels chaînables via une interface map/reduce et plus intuitive. d'autres opérations. Par exemple, supprimons tous les utilisateurs inactifs et collectons les noms des utilisateurs restants :

  $users = App\User::all();
  $names = $users->reject(function ($user) { 
     return $user->active === false;
   })->map(function ($user) { 
     return $user->name;
   });

  {note} La plupart des méthodes de collecte Eloquent renvoient de nouvelles instances de collection Eloquent, mais pluck, les exceptions sont les Méthodes keys, zip, collapse, flatten et flip, qui renvoient une collection instance de classe de base. De même, si une opération map renvoie une collection qui ne contient aucun modèle Eloquent, elle est automatiquement convertie en classe de base de collection.

Méthodes disponibles

IlluminateDatabaseEloquentCollection 对象的实例，包括通过 get 方法检索或通过访问关联关系获取到的结果。 Eloquent 的集合对象继承了 Laravel 的 集合基类，因此它自然也继承了数十种能优雅地处理 Eloquent 模型底层数组的方法。

而且，所有的集合都可以作为迭代器，你可以像遍历简单的 PHP 数组一样来遍历它们：

<?php
    namespace App;
    use App\CustomCollection;
    use Illuminate\Database\Eloquent\Model;
    class User extends Model{   
     /**
     * 创建一个新的 Eloquent 集合实例对象。
     *
     * @param  array  $models
     * @return \Illuminate\Database\Eloquent\Collection
     */    
     public function newCollection(array $models = [])  
       {   
            return new CustomCollection($models);    
        }
    }

不过，集合比数组更加强大，它通过更加直观的接口暴露出可链式调用的 map /reduce 等操作。例如，让我们移除所有未激活的用户并收集剩余用户的名字：