全局作用域是Laravel中为模型所有查询自动添加约束的机制，如ActiveUserScope会自动过滤status为active的用户，通过implementing Scope接口并重写apply方法实现，在模型booted中注册后生效，可用withoutGlobalScope临时移除，适用于软删除、多租户等场景，但需避免复杂逻辑以防性能问题。
在 Laravel 的 Eloquent 模型中，全局作用域（Global Scopes）是一种为模型的所有查询自动添加约束条件的机制。它非常适合用于实现软删除、多租户系统、状态过滤等通用需求，而无需每次手动添加相同条件。
什么是全局作用域
全局作用泩会在模型的每一次数据库查询中自动应用，包括 where、get、first、paginate 等方法，除非你显式地移除它。
Laravel 自带的 SoftDeletes 就是通过全局作用域实现的：自动排除被“软删除”的记录。
如何定义并使用全局作用域
创建一个全局作用域需要实现 IlluminateDatabaseEloquentScope 接口，并定义 apply 方法。
示例：为用户模型添加“仅启用用户”作用域
第一步：创建 Scope 类
php artisan make:scope ActiveUserScope
生成的类如下：
namespace AppScopes;use IlluminateDatabaseEloquentBuilder;use IlluminateDatabaseEloquentModel;use IlluminateDatabaseEloquentScope;
class ActiveUserScope implements Scope{public function apply(Builder $builder, Model $model){$builder->where('status', 'active');}}
第二步：在模型中注册全局作用域
智谱AI开放平台
智谱AI大模型开放平台-新一代国产自主通用AI开放平台
85 查看详情
namespace AppModels;use AppScopesActiveUserScope;use IlluminateDatabaseEloquentModel;
class User extends Model{protected static function booted(){static::addGlobalScope(new ActiveUserScope);}}
现在，所有对 User 模型的查询都会自动加上 status = ‘active’ 条件。
例如：
User::all(); // SELECT * FROM users WHERE status = 'active';
临时移除全局作用域
有时你需要获取包含非活跃用户的数据，可以使用 withoutGlobalScope 方法：
// 获取所有用户（包括非活跃）User::withoutGlobalScope(ActiveUserScope::class)->get();// 移除所有全局作用域User::withoutGlobalScopes()->get();
// 移除特定几个作用域User::withoutGlobalScopes([ActiveUserScope::class,AnotherScope::class])->get();
匿名全局作用域（一次性使用）
如果某个作用域只在特定模型中使用一次，可以直接在模型中用闭包定义：
protected static function booted(){ static::addGlobalScope('active', function (Builder $builder) { $builder->where('status', 'active'); });}
移除时使用作用域名称：
User::withoutGlobalScope('active')->get();
注意事项与最佳实践
全局作用域会影响 withTrashed() 和 onlyTrashed() 之外的软删除行为，注意避免冲突。避免在全局作用域中加入复杂逻辑或性能消耗大的子查询。命名清晰，便于维护和调试。多租户系统中常用于自动添加 tenant_id 条件。
基本上就这些。合理使用全局作用域能大幅减少重复代码，提升数据安全性与一致性。但也要注意别滥用，避免让查询行为变得“隐式”而难以追踪。
以上就是Laravel如何使用全局作用域（Global Scopes）_Eloquent模型全局查询条件设置的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/739067.html
微信扫一扫 
支付宝扫一扫 
