Laravel中的全局作用域(Global Scopes)怎么用_运维开发

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

发布时间：2025-11-11

点击量：

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

在 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 的条件。

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

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

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

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

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

use Illuminate\Database\Eloquent\SoftDeletes;

class Post extends M

odel
{
use SoftDeletes;
}

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

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

标签：# function # 为其 # 可以直接 # 会在 # 帮你 # 但在 # 当你 # 多个 # 是一种 # 的是 # 移除 # database # constructor # laravel # 闭包 # protected # public # class # 接口 # NULL # Static # 作用域 # 数据访问 # ai # app

上一篇：laravel怎么在后台任务中安全地使用当前登录用户_lar

下一篇：Laravel怎么使用查询构造器(Query Builder