全局作用域是Laravel中为模型所有查询自动添加约束的机制，如ActiveUserScope会自动过滤status为active的用户，通过implementing Scope接口并重写apply方法实现，在模型booted中注册后生效，可用withoutGlobalScope临时移除，适用于软删除、多租户等场景，但需避免复杂逻辑以防性能问题。
在 Laravel 的 Eloquent 模型中，全局作用域（Global Scopes）是一种为模型的所有查询自动添加约束条件的机制。它非常适合用于实现软删除、多租户系统、状态过滤等通用需求，而无需每次手动添加相同条件。
什么是全局作用域
全局作用泩会在模型的每一次数据库查询中自动应用，包括 where、get、first、paginate 等方法，除非你显式地移除它。
Laravel 自带的 SoftDeletes 就是通过全局作用域实现的：自动排除被“软删除”的记录。
如何定义并使用全局作用域
创建一个全局作用域需要实现 Illuminate\Database\Eloquent\Scope 接口，并定义 apply 方法。
示例：为用户模型添加“仅启用用户”作用域
第一步：创建 Scope 类
php artisan make:scope ActiveUserScope
生成的类如下：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
namespace App\Scopes;
<p>use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Scope;</p><p>class ActiveUserScope implements Scope
{
public function apply(Builder $builder, Model $model)
{
$builder->where('status', 'active');
}
}
第二步：在模型中注册全局作用域
namespace App\Models;
<p>use App\Scopes\ActiveUserScope;
use Illuminate\Database\Eloquent\Model;</p><p>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(); <p>// 移除所有全局作用域 User::withoutGlobalScopes()->get();</p><p>// 移除特定几个作用域 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 条件。
基本上就这些。合理使用全局作用域能大幅减少重复代码，提升数据安全性与一致性。但也要注意别滥用，避免让查询行为变得“隐式”而难以追踪。
