20 个 Laravel Eloquent 必备的实用技巧

clipboard.png

Eloquent ORM 看起来是一个简单的机制,可是在底层,有不少半隐藏的函数和不为人知的方式来实现更多功能。在这篇文章中,我将演示几个小技巧。php

1. 递增和递减

要代替如下实现:laravel

$article = Article::find($article_id);
$article->read_count++;
$article->save();

你能够这样作:git

$article = Article::find($article_id);
$article->increment('read_count');

如下这些方法也能够实现:github

Article::find($article_id)->increment('read_count');
Article::find($article_id)->increment('read_count', 10); // +10
Product::find($produce_id)->decrement('stock'); // -1
        • *

2. 先执行 X 方法,X 方法执行不成功则执行 Y 方法

Eloquent 有至关一部分函数能够把两个方法结合在一块儿使用, 例如 『 请先执行 X 方法, X 方法执行不成功则执行 Y 方法 』。web

实例 1 -- findOrFail():数据库

要替代如下代码的实现:json

$user = User::find($id);
if (!$user) { abort (404); }

你能够这样写:数组

$user = User::findOrFail($id);

实例 2 -- firstOrCreate():闭包

要替代如下代码的实现:app

$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. 一对多返回默认模型对象

假设如今有种状况是要显示文章的做者,而后模板代码是:

{{ $post->author->name }}

可是若是做者的信息被删除或者由于某些缘由没有被设置。代码会返回一个错误,诸如 "property of non-object"。

固然你能够这样处理:

{{ $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();

// havingRaw
Product::groupBy('category_id')->havingRaw('COUNT(*) > 1')->get();

// orderByRaw
User::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 查询

若是你有个 andor 混合的 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]);
        • *

我很肯定还有更多隐藏的秘诀,但我但愿至少上面的其中一些对你来讲是新的。

更多现代化 PHP 知识,请前往 Laravel / PHP 知识社区
相关文章
相关标签/搜索