如何在Laravel Eloquent中实现动态全局模型过滤器？

嘿，我完全懂你想要实现的效果——让User模型的所有Eloquent查询自动过滤出满足filter()方法返回true的用户。不过很遗憾，Laravel本身并没有内置直接支持这种“模型方法自动全局过滤”的功能，但我们有几种非常靠谱的方案来达成你的需求，而且能做到动态控制！

方案一：动态全局作用域（推荐，数据库层面过滤） #

这是最高效的方式，因为过滤逻辑直接在数据库查询阶段执行，避免了加载不必要的模型实例。

1. 创建全局作用域类 #

首先定义一个可接收动态参数的全局作用域：

namespace App\Scopes;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Scope;

class UserFilterScope implements Scope
{
    protected $filterCondition;

    // 接收动态变量
    public function __construct($filterCondition)
    {
        $this->filterCondition = $filterCondition;
    }

    public function apply(Builder $builder, Model $model)
    {
        // 只有当条件为true时，应用过滤逻辑
        if ($this->filterCondition) {
            // 这里把你filter()方法的逻辑转换成数据库查询条件
            // 比如如果你的filter()是判断用户是否激活，就写：
            $builder->where('is_active', true);
            
            // 如果是更复杂的逻辑，比如关联模型的判断，可以用whereHas：
            // $builder->whereHas('subscription', fn($q) => $q->where('status', 'active'));
        }
    }
}

2. 在User模型中注册并动态控制 #

在User模型的boot方法里注册这个作用域，同时提供动态修改条件的方式：

namespace App\Models;

use App\Scopes\UserFilterScope;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // 定义静态变量存储过滤条件
    protected static $filterEnabled = true;

    protected static function boot()
    {
        parent::boot();

        // 注册全局作用域，传入动态条件
        static::addGlobalScope(new UserFilterScope(static::$filterEnabled));
    }

    // 提供静态方法动态切换过滤状态
    public static function setFilterEnabled(bool $enabled)
    {
        static::$filterEnabled = $enabled;
        
        // 如果需要立即生效，可先移除旧作用域再重新添加
        static::withoutGlobalScope(UserFilterScope::class);
        static::addGlobalScope(new UserFilterScope(static::$filterEnabled));
    }

    // 保留你原来的filter方法（如果需要在模型实例上使用）
    public function filter()
    {
        return static::$filterEnabled && $this->is_active; // 示例逻辑
    }
}

使用方式 #

• 默认所有查询都会自动应用过滤：User::get();
• 临时关闭过滤：User::withoutGlobalScope(UserFilterScope::class)->get();
• 动态切换过滤状态：User::setFilterEnabled(false);

方案二：查询后过滤（适合小数据集） #

如果你的filter()方法逻辑依赖模型实例的计算属性或关联数据（无法转成数据库查询），可以用这种方式，但注意会先加载所有模型再过滤，大数据集慎用。

方式1：封装查询宏 #

在AppServiceProvider的boot方法里注册全局查询宏：

use Illuminate\Database\Eloquent\Builder;

public function boot()
{
    Builder::macro('filterUsers', function () {
        return $this->get()->filter(fn($user) => $user->filter());
    });
}

使用时直接调用：User::filterUsers();

方式2：模型全局查询钩子 #

在User模型里重写newQuery方法，自动追加过滤：

public function newQuery($excludeDeleted = true)
{
    return parent::newQuery($excludeDeleted)->get()->filter(fn($user) => $user->filter());
}

这种方式会让所有查询自动执行过滤，但同样要注意性能问题。

关键提醒 #

• 优先选择方案一的全局作用域，因为数据库层面的过滤效率远高于内存过滤
• 如果你的filter()逻辑无法转成数据库查询，才考虑方案二，且只在小数据集场景使用
• Laravel确实没有内置你设想的“直接定义filter方法自动全局过滤”的功能，你没有遗漏文档内容哦！

内容的提问来源于stack exchange，提问作者Basaa