在laravel中配置全局作用域的方法有两种：1. 在模型内定义匿名全局作用域，适用于逻辑简单且仅针对当前模型的情况，通过在模型的boot方法中调用addglobalscope实现；2. 创建独立的全局作用域类，适用于逻辑复杂或需在多个模型间复用的情况，需实现scope接口并定义apply方法。两种方式均能让查询自动应用预设条件，避免重复代码，提升维护性。
在Laravel中配置全局作用域，核心思想是在Eloquent模型层面为所有或部分查询自动应用某些约束条件。这能让你避免重复编写相同的where子句，尤其在处理像软删除、多租户数据隔离这类常见场景时，极大地提升代码的简洁性和可维护性。它就像是给你的模型查询预设了一个“过滤器”，每次查询都会自动带上。
配置全局作用域主要有两种方式：直接在模型内部的boot方法中定义匿名全局作用域，或者创建一个独立的全局作用域类。
1. 在模型内定义匿名全局作用域：
这是最直接的方式，适用于作用域逻辑相对简单，且只针对当前模型的情况。你需要在模型的boot方法中调用addGlobalScope。
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes; // 假设你需要软删除
class Post extends Model
{
use SoftDeletes; // 示例：软删除其实就是Laravel内置的一个全局作用域
protected $fillable = ['title', 'content', 'published_at', 'status'];
/**
* 模型“启动”时执行的方法。
* 可以在这里注册全局作用域。
*
* @return void
*/
protected static function boot()
{
parent::boot();
// 示例1：只查询已发布的文章
static::addGlobalScope('published', function (Builder $builder) {
$builder->where('status', 'published');
});
// 示例2：针对多租户场景，只查询当前用户所属的文章
// 假设你有一个tenant_id字段，并且可以通过某种方式获取当前租户ID
// if (auth()->check() && auth()->user()->tenant_id) {
// static::addGlobalScope('tenant', function (Builder $builder) {
// $builder->where('tenant_id', auth()->user()->tenant_id);
// });
// }
}
}当你这样配置后，每次你查询Post::all()或Post::where('id', 1)->first()时，Laravel都会自动在查询中加上where('status', 'published')。
2. 创建独立的全局作用域类：
当你的全局作用域逻辑比较复杂，或者希望在多个模型之间复用时，创建一个独立的全局作用域类是更好的选择。
首先，创建一个作用域类，它需要实现Illuminate\Database\Eloquent\Scope接口，并定义一个apply方法：
<?php
namespace App\Scopes;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Scope;
class PublishedScope implements Scope
{
/**
* 将作用域应用于给定的Eloquent查询构建器。
*
* @param \Illuminate\Database\Eloquent\Builder $builder
* @param \Illuminate\Database\Eloquent\Model $model
* @return void
*/
public function apply(Builder $builder, Model $model)
{
$builder->where('status', 'published');
}
}然后，在模型中注册这个全局作用域：
<?php
namespace App\Models;
use App\Scopes\PublishedScope; // 引入你创建的作用域类
use Illuminate\Database\Eloquent\Model;
class Post extends Model
{
protected $fillable = ['title', 'content', 'published_at', 'status'];
/**
* 模型“启动”时执行的方法。
* 可以在这里注册全局作用域。
*
* @return void
*/
protected static function boot()
{
parent::boot();
static::addGlobalScope(new PublishedScope);
// 或者如果你想给它一个名字，方便后续移除：
// static::addGlobalScope('published_status', new PublishedScope);
}
}我个人更倾向于使用独立的全局作用域类，尤其是当项目规模逐渐扩大，或者作用域逻辑可能在不同模型间共享时。这样能让模型文件保持干净，逻辑也更集中，维护起来效率高很多。
嗯，说到全局作用域，我个人觉得它简直是解决那些“每次查询都得加个where条件”的福音。想象一下，你的博客系统里，所有文章默认都应该是“已发布”状态，只有后台管理员才能看到草稿。如果没有全局作用域，你可能每次查询文章列表、查询单篇文章、甚至做关联查询的时候，都得手动写上->where('status', 'published')。这不仅写起来麻烦，还特别容易漏掉，一旦漏了，用户可能就看到不该看的内容了。
使用全局作用域，它能把这种重复的逻辑“抽象”出来，自动应用到所有查询上。这符合软件开发的DRY（Don't Repeat Yourself）原则，让你的代码更简洁、更智能。它把那些通用的业务规则，比如数据权限、状态过滤等，集中管理起来，避免了代码分散、逻辑不一致的问题。对于多租户应用来说，全局作用域更是必备利器，能确保每个租户只能看到自己的数据，极大地简化了数据隔离的实现。
创建独立的全局作用域类，主要是为了实现逻辑的复用和模型代码的解耦。这其实是一个很优雅的解决方案，特别是当你的全局作用域逻辑变得有点复杂，或者你希望在多个模型中应用相同的过滤规则时。
刚才也提到了，首先你需要定义一个类，让它实现Illuminate\Database\Eloquent\Scope接口。这个接口只有一个方法，就是apply(Builder $builder, Model $model)。所有你想要应用到查询上的逻辑，都写在这个apply方法里。$builder参数就是当前的Eloquent查询构建器，你可以在上面调用任何where、join等方法。$model参数则代表了当前正在操作的模型实例。
比如说，如果你想实现一个“只显示活跃用户”的全局作用域：
// app/Scopes/ActiveUserScope.php
namespace App\Scopes;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Scope;
class ActiveUserScope implements Scope
{
public function apply(Builder $builder, Model $model)
{
// 假设用户模型有一个 'is_active' 字段
$builder->where('is_active', true);
}
}然后，在你的User模型中，你只需要在boot方法里注册它：
// app/Models/User.php
namespace App\Models;
use App\Scopes\ActiveUserScope; // 引入作用域类
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
// ... 其他模型定义
protected static function boot()
{
parent::boot();
static::addGlobalScope(new ActiveUserScope);
}
}这样一来，每当你查询User::all()或User::find(1)时，Laravel都会自动加上where('is_active', true)。这种方式让你的模型文件保持轻量，作用域逻辑独立成文件，职责分明，维护起来清晰多了。
虽然全局作用域非常方便，但总有那么些时候，你需要“突破”它的限制。比如，后台管理界面可能需要看到所有数据，包括那些被软删除的、或者未发布的文章。Laravel为此提供了非常灵活的方法来临时禁用或移除全局作用域。
你可以使用withoutGlobalScope()方法来移除一个特定的全局作用域，或者使用withoutGlobalScopes()方法来移除所有全局作用域。
1. 禁用特定的全局作用域：
如果你给全局作用域起了名字（在addGlobalScope时传入字符串作为第一个参数），你可以通过这个名字来禁用它。
// 假设Post模型中有一个名为 'published' 的全局作用域
// static::addGlobalScope('published', function (Builder $builder) { ... });
// 查询所有文章，但这次要包含未发布的：
$allPosts = Post::withoutGlobalScope('published')->get();
// 或者，如果你使用的是独立的PublishedScope类
// static::addGlobalScope(new PublishedScope);
// 那么你可以传入作用域类的实例或者类名来禁用：
$allPosts = Post::withoutGlobalScope(PublishedScope::class)->get();
// 或者，如果你在注册时给了它一个名字，比如 'published_status'
// static::addGlobalScope('published_status', new PublishedScope);
// 那么就用这个名字：
// $allPosts = Post::withoutGlobalScope('published_status')->get();我发现，用类名来禁用独立的全局作用域特别方便，因为它直接指向了那个逻辑单元，清晰明了。
2. 禁用所有全局作用域：
如果你想暂时忽略模型上的所有全局作用域，可以使用withoutGlobalScopes()方法，不传入任何参数。
// 查询所有文章，包括所有状态的，并且忽略所有其他可能的全局作用域 $allPostsIncludingDraftsAndSoftDeleted = Post::withoutGlobalScopes()->get();
这个方法在需要“原始”数据时非常有用，比如在数据导入导出、或者需要进行全面数据分析的场景。它就像一个“紧急出口”，让你暂时绕开所有预设的规则，直接访问底层数据。但使用时要小心，确保你确实需要这么做，并且不会暴露不该暴露的数据。
以上就是如何在Laravel中配置全局作用域的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告
收藏
收藏
收藏
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
329
