Laravel中的全局作用域(Global Scopes)怎么用-Laravel-PHP中文网

Laravel中的全局作用域(Global Scopes)怎么用

冰火之心

发布： 2025-11-11 07:09:26

原创

362人浏览过

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

laravel中的全局作用域(global scopes)怎么用

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

什么是全局作用域

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

如何定义全局作用域

创建一个实现 Illuminate\Database\Eloquent\Scope 接口的类：

class ActiveUserScope implements \Illuminate\Database\Eloquent\Scope
{
    public function apply(\Illuminate\Database\Eloquent\Builder $builder, \Illuminate\Database\Eloquent\Model $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绘画创作平台

查看详情

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

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

移除全局作用域

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

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

// 移除所有全局作用域
User::withoutGlobalScopes()->get();

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