引言
laravel在功能拆分上相当灵活,其中查询返回的数据集,虽然继承了基类集合, 但是有一些特定的方法和用法。很多小白在写的时候,往往分不清到底是用的哪个类的哪个方法,导致凭空报错。本文就来为大家梳理梳理。
代码时间
laravel系统的基类就是Illuminate\Support\Collection,同时提供了一个快捷助手函数collect 用于实例化一个集合类。该助手函数的代码很简单,就是new一个对象:
newCollection($value);
比如有一个数组,将其实例化为一个集合类:
$collection=collect([1,2,3]);
集合类可以调用系统提供的方法,非常灵活地操作数据。比如将上述数组内所有的偶数剔除掉:
$odds=$collection->reject(function($item){
return$item%2===;});
reject方法接收一个匿名函数,满足条件的将被从集合中剔除。
或者把集合内所有的数据乘以10返回,我们调用map方法进行遍历:
$multiplied = $collection->map(function ($item) {
return $item * 10;
});
上面说的方法都是链式可操作的,可以把操作一气呵成,比如返回数组中所有的偶数,并将所有元素乘以10,最后求和。直接贴代码:
$sum=$collection->filter(function($item){
return$item%2==;})->map(function($item){
return$item*10;})->sum();
是不是比写foreach循环操作数组流畅直观的多了?
虽然eloquent collection继承了基类Collection的特性,但是对于模型类的特性 有许多独特的方法。比如 modelKeys() 返回所有集合模型的primary key。比如调用 find($id) 的方法返回的是根据模型实例的primary id查找到的模型对象。
这与原始的集合的方法都有着本质的不同。系统自带的方法在复杂应用下不能满足多元化的需求, 我们这时就需要手动自建集合类,用于特定的操作。
比如在订单模型内,把所有已经支付的订单进行求和返回。我们手动创建一个eloquent collection 用于操作query builder返回的数据集合。
useIlluminate\Database\Eloquent\Collection;classOrderCollectionextendsCollection{
publicfunctionsumBillableAmount()
{
return$this->reduce(function($carry,$order){
return$carry+($order->billable?$order->amount:);
},);
}
}
然后在模型内进行注册:
classOrderextendsModel{
publicfunctionnewCollection(array$models=[])
{
returnnewOrderCollection($models);
}
}
那么在代码中就可以这样用:
$orders=Order::all();
$billableAmount=$orders->sumBillableAmount();
注意使用all方法返回的是一个eloquent collection集合。这样把一些运算操作放在程序内,而非数据库SQL 语句内进行,可进一步提高效率。
对于集合的序列化操作,其实有很标准的写法,比如 toArray toJson这些方法, 可以在返回的数据集对象上直接调用:
$contactArray=Contact::first()->toArray();
$contactJson=Contact::first()->toJson();
$contactsArray=Contact::all()->toArray();
$contactsJson=Contact::all()->toJson();
序列化,或者说格式化牵涉的内容比较多,实际使用也很复杂。此处我们不展开说明了。
写在最后
本文展示了eloquent collection对象的相关操作和方法,大家注意区别于常规的集合类。
Happy coding :-)
我是@程序员小助手,持续分享编程知识,欢迎关注。