Laravel 覆盖 Eloquent all 函数

在 Laravel 中，Eloquent 是最常用的 ORM，它提供了很多便利的方式来操作数据库。其中一个常用的方法是 all 函数，它可以用来获取数据库中某个表中的所有记录，例如：

$users = App\User::all();

然而，有时候 all 函数不能满足我们的需求，我们可能需要对其进行覆盖或者扩展以实现更加复杂和灵活的数据库查询操作。在本文中，我们将介绍如何覆盖 Eloquent all 函数。

实现方法

Laravel 中的 Eloquent all 函数实际上是继承自 Illuminate\Database\Eloquent\Builder 类的 get 函数：

public function all($columns = ['*'])
{
    return $this->get($columns);
}

public function get($columns = ['*'])
{
    $results = $this->query->get($columns);

    // ...

    return $results;
}

因此，我们可以通过覆盖 get 函数来实现 all 函数的自定义行为。例如，我们可以在查询结果中加入对用户的权限判断，只返回该用户可见的记录：

namespace App;

use Illuminate\Database\Eloquent\Builder;

class CustomBuilder extends Builder
{
    public function get($columns = ['*'])
    {
        $user = auth()->user();

        if ($user && !$user->isAdmin()) {
            $this->where('user_id', '=', $user->id);
        }

        return parent::get($columns);
    }
}

这里我们定义了一个 CustomBuilder 类来继承自 Builder，并覆盖了 get 函数。在新的 get 函数中，我们首先获取当前登录用户，如果该用户不是管理员，则只返回该用户创建的记录。

接下来，我们需要告诉 Eloquent 该如何使用自定义的 CustomBuilder 类。这可以通过在 Eloquent 模型中使用 newQuery 方法来实现：

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    protected $table = 'users';

    public function newQuery()
    {
        return app(CustomBuilder::class, ['query' => parent::newQuery()]);
    }
}

在上面的代码中，我们在 User 模型中覆盖了 newQuery 函数，返回一个新的 CustomBuilder 实例，并将其传递给 parent::newQuery() 函数。这可以确保我们使用的是自定义的 CustomBuilder 类。

现在，我们就可以使用自定义的 all 函数了：

$users = App\User::all();

如果登录用户是管理员，则返回所有用户的记录；否则只返回该用户创建的记录。

总结

覆盖 Eloquent all 函数可以让我们实现更加灵活和复杂的数据库查询操作。我们可以自定义查询条件、过滤结果等等。在本文中，我们介绍了如何继承自 Builder 类来创建自定义查询器，并在模型中使用自定义查询器来覆盖 Eloquent all 函数。