laravel eloquent 必备的实用技巧
1. 递增和递减
要代替以下实现:
$article = article::find($article_id);$article->read_count++;$article->save();
你可以这样做:
$article = article::find($article_id);$article->increment('read_count');
以下这些方法也可以实现:
article::find($article_id)->increment('read_count');article::find($article_id)->increment('read_count', 10); // +10product::find($produce_id)->decrement('stock'); // -1
2. 先执行 x 方法,x 方法执行不成功则执行 y 方法
eloquent 有相当一部分函数可以把两个方法结合在一起使用, 例如 『 请先执行 x 方法, x 方法执行不成功则执行 y 方法 』。
实例 1 -- findorfail():
要替代以下代码的实现:
$user = user::find($id);if (!$user) { abort (404); }
你可以这样写:
$user = user::findorfail($id);
实例 2 -- firstorcreate():
要替代以下代码的实现:
$user = user::where('email', $email)->first();if (!$user) { user::create([ 'email' => $email ]);}
这样写就可以了:
$user = user::firstorcreate(['email' => $email]);
3. 模型的 boot() 方法
在一个 eloquent 模型中,有个神奇的地方,叫 boot(),在那里,你可以覆盖默认的行为:
class user extends model{ public static function boot() { parent::boot(); static::updating(function($model) { // 写点日志啥的 // 覆盖一些属性,类似这样 $model->something = transform($something); }); }}
在创建模型对象时设置某些字段的值,大概是最受欢迎的例子之一了。 一起来看看在创建模型对象时,你想要生成 uuid 字段 该怎么做。
public static function boot(){ parent::boot(); self::creating(function ($model) { $model->uuid = (string)uuid::generate(); });}
4. 带条件与排序的关联关系
定义关联关系的一般方式:
public function users(){ return $this->hasmany('app\user');}
你知道吗?也可以在上面的基础上增加 where 或者 orderby,
举个例子,如果你想关联某些类型的用户,同时使用 email 字段排序,你可以这样做:
public function approvedusers() { return $this->hasmany('app\user')->where('approved', 1)->orderby('email');}
5. 模型特性:时间、追加等
eloquent 模型有些参数,使用类的属性形式。最常用是:
class user extends model{ protected $table = 'users'; protected $fillable = ['email', 'password']; // 可以被批量赋值字段,如 user::create() 新增时,可使用字段 protected $dates = ['created_at', 'deleted_at']; // 需要被carbon维护的字段名 protected $appends = ['field1', 'field2']; // json返回时,附加的字段}
不只这些,还有:
protected $primarykey = 'uuid'; // 更换主键public $incrementing = false; // 设置 不自增长protected $perpage = 25; // 定义分页每页显示数量(默认15)const created_at = 'created_at';const updated_at = 'updated_at'; //重写 时间字段名public $timestamps = false; // 设置不需要维护时间字段
还有更多,我只列出了一些有意思的特性,具体参考文档 abstract model class 了解所有特性.
6. 通过 id 查询多条记录
所有人都知道 find() 方法,对吧?
$user = user::find(1);
我十分意外竟然很少人知道这个方法可以接受多个 id 的数组作为参数:
$users = user::find([1,2,3]);
7. wherex
有一种优雅的方式能将这种代码:
$users = user::where('approved', 1)->get();
转换成这种:
$users = user::whereapproved(1)->get();
对,你没有看错,使用字段名作为后缀添加到 where 后面,它就能通过魔术方法运行了。
另外,在 eloquent 里也有些和时间相关的预定义方法:
user::wheredate('created_at', date('y-m-d'));user::whereday('created_at', date('d'));user::wheremonth('created_at', date('m'));user::whereyear('created_at', date('y'));
8. 通过关系排序
一个复杂一点的「技巧」。你想对论坛话题按最新发布的帖子来排序?论坛中最新更新的主题在最前面是很常见的需求,对吧?
首先,为主题的最新帖子定义一个单独的关系:
public function latestpost(){ return $this->hasone(\app\post::class)->latest();}
然后,在控制器中,我们可以实现这个「魔法」:
$users = topic::with('latestpost')->get()->sortbydesc('latestpost.created_at');
9. eloquent::when() -- 不再使用 if-else
很多人都喜欢使用"if-else"来写查询条件,像这样:
if (request('filter_by') == 'likes') { $query->where('likes', '>', request('likes_amount', 0));}if (request('filter_by') == 'date') { $query->orderby('created_at', request('ordering_rule', 'desc'));}
有一种更好的方法 -- 使用 when()
$query = author::query();$query->when(request('filter_by') == 'likes', function ($q) { return $q->where('likes', '>', request('likes_amount', 0));});$query->when(request('filter_by') == 'date', function ($q) { return $q->orderby('created_at', request('ordering_rule', 'desc'));});
它可能看上去不是很优雅,但它强大的功能是传递参数:
$query = user::query();$query->when(request('role', false), function ($q, $role) { return $q->where('role_id', $role);});$authors = $query->get();
10. belongsto 默认模型
假如有一个 post 模型附属于 author 模型,在 blade 模板里可以写作如下代码:
{{ $post->author->name }}
但是如果作者被删除了,或者因为某些原因未设置?你就会得到一个错误信息,类似「不存在的对象属性」。
那么,你可以这么避免它:
{{ $post->author->name '' }}
但是你可以在 eloquent 关系模型级别做到这种效果:
public function author(){ return $this->belongsto('app\author')->withdefault();}
这个例子中,如果帖子没有作者的话,author() 关系方法会返回一个空的 app\author 模型对象。
此外,我们还可以为默认模型分配一个默认的属性值。
public function author(){ return $this->belongsto('app\author')->withdefault([ 'name' => 'guest author' ]);}
11. 通过赋值函数进行排序
想象一下你有这样的代码:
function getfullnameattribute(){ return $this->attributes['first_name'] . ' ' . $this->attributes['last_name'];}
现在,你想要通过 "full_name" 进行排序? 发现是没有效果的:
$clients = client::orderby('full_name')->get(); //没有效果
解决办法很简单.我们需要在获取结果后对结果进行排序.
$clients = client::get()->sortby('full_name'); // 成功!
注意的是方法名称是不相同的 -- 它不是 orderby,而是 sortby
12. 全局作用域下的默认排序
如果你想要 user::all() 总是按照 name 字段来排序呢? 你可以给它分配一个全局作用域。让我们回到 boot() 这个我们在上文提到过的方法:
protected static function boot(){ parent::boot(); // 按照 name 正序排序 static::addglobalscope('order', function (builder $builder) { $builder->orderby('name', 'asc'); });}
扩展阅读 查询作用域 。
13. 原生查询方法
有时候,我们需要在 eloquent 语句中添加原生查询。 幸运的是,确实有这样的方法。
// whereraw$orders = db::table('orders') ->whereraw('price > if(state = "tx", ?, 100)', [200]) ->get();// havingrawproduct::groupby('category_id')->havingraw('count(*) > 1')->get();// orderbyrawuser::where('created_at', '>', '2016-01-01') ->orderbyraw('(updated_at - created_at) desc') ->get();
14. 复制:复制一行的副本
很简单。说明不是很深入,下面是复制数据库实体(一条数据)的最佳方法:
$task = tasks::find(1);$newtask = $task->replicate();$newtask->save();
15. chunk() 方法之大块数据
与 eloquent 不完全相关,它更多的关于 collection (集合),但是对于处理大数据集合,仍然是很有用的。你可以使用 chunk() 将这些数据分割成小数据块
修改前:
$users = user::all();foreach ($users as $user) { // ...
你可以这样做:
user::chunk(100, function ($users) { foreach ($users as $user) { // ... }});
16. 创建模型的时候增加额外操作
我们都知道这条 artisan 命令:
php artisan make:model company
但是你知道有三个十分有用的标志符可用于生成模型相关文件
php artisan make:model company -mcr
-m 创建迁移文件
-c 创建控制器文件
-r 为控制器添加资源操作方法
17. 调用 save 方法的时候指定 updated_at
你知道 ->save() 方法可以接受参数吗? 我们可以通过传入参数阻止它的默认行为:更新 updated_at 的值为当前时间戳。
$product = product::find($id);$product->updated_at = '2019-01-01 10:00:00';$product->save(['timestamps' => false]);
这样,我们成功在 save 时指定了 updated_at 的值。
18. update() 的结果是什么?
你是否想知道这段代码实际上返回什么?
$result = $products->wherenull('category_id')->update(['category_id' => 2]);
我是说,更新操作是在数据库中执行的,但 $result 会包含什么?
答案是受影响的行。 因此如果你想检查多少行受影响, 你不需要额外调用其他任何内容 -- update() 方法会给你返回此数字。
19. 把括号转换成 eloquent 查询
如果你有个 and 和 or 混合的 sql 查询,像这样子的:
... where (gender = 'male' and age >= 18) or (gender = 'female' and age >= 65)
怎么用 eloquent 来翻译它呢? 下面是一种错误的方式:
$q->where('gender', 'male');$q->orwhere('age', '>=', 18);$q->where('gender', 'female');$q->orwhere('age', '>=', 65);
顺序就没对。正确的打开方式稍微复杂点,使用闭包作为子查询:
$q->where(function ($query) { $query->where('gender', 'male') ->where('age', '>=', 18);})->orwhere(function($query) { $query->where('gender', 'female') ->where('age', '>=', 65);})
20. 复数参数的 orwhere
终于,你可以传递阵列参数给 orwhere()。平常的方式:
$q->where('a', 1);$q->orwhere('b', 2);$q->orwhere('c', 3);
你可以这样做:
$q->where('a', 1);$q->orwhere(['b' => 2, 'c' => 3]);
更多laravel框架相关技术文章,请访问laravel教程栏目!
以上就是laravel eloquent 必备的实用技巧的详细内容。
