全局作用域是laravel中为模型自动添加查询约束的机制，如通过ActiveUserScope限制只查询激活用户，需在模型的booted方法中注册，支持闭包简化定义，并可用withoutGlobalScope移除，软删除即为其典型应用。

在 Laravel 中，全局作用域（Global Scopes）是一种为模型自动添加约束条件的方式，它会在每次查询该模型时生效，无需手动调用。这非常适合实现软删除、多租户隔离、状态过滤等通用需求。

什么是全局作用域

全局作用域会永久性地影响模型的查询结果。比如你希望所有对 User 模型的查询都只返回“已激活”的用户，就可以通过全局作用度来实现，避免在每个查询中重复写 where(‘active’, 1)。

如何定义全局作用域

创建一个实现 IlluminatedatabaseEloquentScope 接口的类：

class ActiveUserScope implements IlluminateDatabaseEloquentScope
{
    public function apply(IlluminateDatabaseEloquentBuilder $builder, IlluminateDatabaseEloquentModel $model)
    {
        $builder->where(‘active’, 1);
    }
}

然后在你的 Eloquent 模型中注册这个全局作用域：

class User extends Model
{
    protected Static function booted()
    {
        static::addGlobalScope(new ActiveUserScope);
    }
}

现在，任何对 User::all() 或 User::where(‘name’, ‘John’)… 的调用都会自动加上 active = 1 的条件。

使用闭包方式（简化场景）

如果你的作用域逻辑比较简单，可以直接用闭包定义：

奇域

奇域是一个专注于中式美学的国风ai绘画创作平台

30

查看详情

protected static function booted()
{
    static::addGlobalScope(‘active’, function (Builder $builder) {
        $builder->where(‘active’, 1);
    });
}

这种方式适合快速实现简单过滤，但不利于复用和测试。

移除全局作用域

有时候你需要绕过全局作用域，比如在管理后台查看所有用户（包括未激活的）。可以使用 withoutGlobalScope() 方法：

// 移除特定作用域
User::withoutGlobalScope(ActiveUserScope::class)->get();

// 移除多个但保留某些
User::withoutGlobalScopes([ActiveUserScope::class])->get();

内置全局作用域示例：软删除

Laravel 自带的软删除功能就是基于全局作用域实现的。当你使用 SoftDeletes trait 时：

use IlluminateDatabaseEloquentSoftDeletes;

class Post extends Model
{
    use SoftDeletes;
}

它会自动添加一个全局作用域，排除所有 deleted_at NOT NULL 的记录。只有调用 withTrashed() 或 onlyTrashed() 才能绕过这个限制。

基本上就这些。全局作用域帮你减少重复代码，统一数据访问规则，但在使用时要注意别过度隐藏逻辑导致调试困难。建议复杂项目中命名清晰、文档说明，必要时提供绕过机制。不复杂但容易忽略的是：记得在 booted() 而不是 constructor 中注册作用域。