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

全局作用域用于为模型所有查询自动添加约束条件，如状态过滤；需实现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'。

临时取消全局作用域

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

标签： laravel app 作用域