Laravel如何实现模型的全局作用域？（Global Scope示例）_网络技术

Laravel如何实现模型的全局作用域？（Global Scope示例）

发布时间 - 2025-12-13 00:00:00 点击率：次

全局作用域用于为模型所有查询自动添加约束条件，如状态过滤；需实现Scope接口并重写apply方法，在模型boot中用addGlobalScope注册，可用withoutGlobalScopes等方法临时取消。

在 Laravel 中，全局作用域（Global Scope）用于为模型的所有查询自动添加约束条件，比如软删除、多租户隔离、状态过滤等。它比在每个查询中手动加 where 更安全、更统一。

定义全局作用域类

创建一个实现 Illuminate\Database\Eloquent\Scope 接口的类，重写 apply() 方法，在这里编写你要注入的查询逻辑：

namespace App\Scopes;

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

class ActiveScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->where('status', 'active');
    }
}

在模型中注册全局作用域

在模型的 boot() 方法中调用 addGlobalScope() 注册作用域：

namespace App\Models;

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

class Post extends Model
{
    protected static function boot()
    {
        parent::boot();

        static::addGlobalScope(new ActiveScope());
    }
}

此后所有对 Post 的查询（如 Post::all()、Post::find(1)）都会自动加上 WHERE status = 'active'。

临时取消全局作用域

某些场景下需要绕过全局作用域，比如后台管理或数据迁移，可用以下方式：

Post::withoutGlobalScopes()->get()：移除全部全局作用域
Post::withoutGlobalScope(ActiveScope::class)->get()：仅移除指定作用域
Post::withTrashed()->get()（如果用了软删除）：这是 Laravel 内置的特例，本质也是全局作用域

匿名全局作用域（适合简单逻辑）

不想单独建类？可以直接传闭包：

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

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

注意：用字符串名注册时，取消要用同名，例如 withoutGlobalScope('active')。

基本上就这些。全局作用域不复杂但容易忽略——关键在统一性和可维护性，别滥用，也别漏掉清除场景。

# laravel # app # 作用域 # 字符串 # 接口 # class # 闭包 # database # 重写 # 移除 # 这是 # 在这里 # 你要 # 用了 # 要用 # 可以直接 # 创建一个 # 也别

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：如何快速搭建安全的FTP站点？

下一篇：Linux系统命令中screen命令详解

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：如何快速搭建安全的FTP站点？

下一篇：Linux系统命令中screen命令详解