全局作用域是Laravel中为模型所有查询自动添加约束的机制，如状态过滤或多租户隔离；通过实现Scope接口或使用闭包定义，可在模型的boot方法中注册，例如ActiveScope限制仅查询激活用户；系统自带软删除即基于此机制，默认添加deleted_at为null条件；可通过withoutGlobalScope移除指定或全部作用域以查询完整数据。

在 Laravel 的 Eloquent ORM 中，全局作用域（Global Scopes）是一种为模型的所有查询自动添加约束条件的机制。它让你无需每次手动写 where 条件，就能实现诸如“软删除”、“多租户数据隔离”或“状态过滤”等功能。

什么是全局作用域

全局作用域会作用于该模型的每一个查询操作，包括关系查询、静态调用以及链式调用。比如你有一个 User 模型，默认只希望获取状态为“激活”的用户，就可以通过全局作用域统一处理。

Laravel 自带的软删除功能就是基于全局作用域实现的 —— 它自动在所有查询中加入 where null deleted_at 条件。

如何定义和使用全局作用域

创建全局作用域有多种方式，最常见的是使用作用域类或匿名全局作用域。

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

php artisan make:scope ActiveScope

然后编辑生成的类：

where('status', 'active');
    }
}

接着在模型中注册这个全局作用域：

2. 使用闭包定义匿名全局作用域
如果逻辑简单，也可以直接在模型中使用闭包：
protected static function boot()
{
    parent::boot();

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


移除全局作用域
有时候你需要绕过某个全局作用域，比如查看所有用户（包括非活跃的）。可以使用 withoutGlobalScope() 方法：
// 移除单个作用域
User::withoutGlobalScope(ActiveScope::class)->get();

// 移除多个作用域
User::withoutGlobalScopes([ActiveScope::class, AnotherScope::class])->get();

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


如果你是用字符串命名的匿名作用域，也可以通过名称移除：
User::withoutGlobalScope('active')->get();


实际应用场景


软删除控制：Laravel 默认使用 SoftDeletes trait 添加全局作用域，隐藏已删除记录。
  

多租户系统：为每个用户或组织的数据自动加上 tenant_id 条件。
  

环境隔离：开发/测试环境下允许看到测试数据，生产环境默认过滤。
  

状态过滤：如文章模型默认只查发布状态的文章。

例如，在多租户应用中：
class TenantScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        if (auth()->check()) {
            $builder->where('tenant_id', auth()->user()->tenant_id);
        }
    }
}


这样每个查询都会自动带上当前用户的租户 ID，避免数据越权访问。

基本上就这些。全局作用域是构建安全、可维护 Laravel 应用的重要工具，合理使用能大幅减少重复代码，提升数据一致性。
          


# laravel 
# php 
# app 
# 工具 
# ai 
# 作用域 
# NULL 
# 字符串 
# 接口 
# 闭包 
# database 
# 移除 
# 链式 
# 的是 
# 是一种 
# 让你 
# 你是 
# 就能 
# 多个 
# 你有 
# 可以通过 
 




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




相关推荐：
如何解决hover在ie6中的兼容性问题 
详解Android——蓝牙技术 带你实现终端间数据传输 
Laravel集合Collection怎么用_Laravel集合常用函数详解 
Google浏览器为什么这么卡 Google浏览器提速优化设置步骤【方法】 
Laravel distinct去重查询_Laravel Eloquent去重方法 
Laravel中间件如何使用_Laravel自定义中间件实现权限控制 
Laravel中Service Container是做什么的_Laravel服务容器与依赖注入核心概念解析 
Laravel怎么使用Collection集合方法_Laravel数组操作高级函数pluck与map【手册】 
如何快速完成中国万网建站详细流程？ 
🚀拖拽式CMS建站能否实现高效与个性化并存？ 
实例解析angularjs的filter过滤器 
laravel怎么用DB facade执行原生SQL查询_laravel DB facade原生SQL执行方法 
猎豹浏览器开发者工具怎么打开 猎豹浏览器F12调试工具使用【前端必备】 
Laravel用户密码怎么加密_Laravel Hash门面使用教程 
Win11任务栏卡死怎么办 Windows11任务栏无反应解决方法【教程】 
Laravel如何优化应用性能？（缓存和优化命令） 
jQuery 常见小例汇总 
Python高阶函数应用_函数作为参数说明【指导】 
 ,网页ppt怎么弄成自己的ppt？ 
Laravel怎么创建自己的包(Package)_Laravel扩展包开发入门到发布 
Laravel DB事务怎么使用_Laravel数据库事务回滚操作 
 制作旅游网站html,怎样注册旅游网站？ 
Laravel N+1查询问题如何解决_Eloquent预加载(Eager Loading)优化数据库查询 
WEB开发之注册页面验证码倒计时代码的实现 
Laravel如何生成API文档？（Swagger/OpenAPI教程） 
Win11搜索不到蓝牙耳机怎么办 Win11蓝牙驱动更新修复【详解】 
Android实现代码画虚线边框背景效果 
Python并发异常传播_错误处理解析【教程】 
JavaScript中的标签模板是什么_它如何扩展字符串功能 
作用域操作符会触发自动加载吗_php类自动加载机制与::调用【教程】 
 专业商城网站制作公司有哪些,pi商城官网是哪个？ 
如何在自有机房高效搭建专业网站？ 
Laravel如何实现API版本控制_Laravel API版本化路由设计策略 
 制作网站软件推荐手机版,如何制作属于自己的手机网站app应用？ 
Gemini手机端怎么发图片_Gemini手机端发图方法【步骤】 
 简历在线制作网站免费版,如何创建个人简历？ 
如何获取PHP WAP自助建站系统源码？ 
零基础网站服务器架设实战：轻量应用与域名解析配置指南 
如何在腾讯云免费申请建站？ 
软银砸40亿美元收购DigitalBridge 强化AI资料中心布局 
如何快速搭建高效简练网站？ 
如何快速搭建FTP站点实现文件共享？ 
如何快速生成可下载的建站源码工具？ 
Laravel怎么使用Session存储数据_Laravel会话管理与自定义驱动配置【详解】 
Laravel如何使用集合（Collections）进行数据处理_Laravel Collection常用方法与技巧 
bing浏览器学术搜索入口_bing学术文献检索地址 
Laravel如何配置和使用缓存？（Redis代码示例） 
如何自定义建站之星模板颜色并下载新样式？ 
Laravel怎么使用Markdown渲染文档_Laravel将Markdown内容转HTML页面展示【实战】 
Laravel如何使用Eloquent进行子查询