Laravel中多模型关联Region时同区域数据查询的最优实现方法

嘿，这个场景我之前在项目里处理过，重写::all()真的不是最优选择——因为Laravel里大部分查询都不会走all()方法，很容易出现漏网之鱼，导致权限控制失效。下面给你几个更靠谱的实现方案，按推荐程度排序：

1. 全局查询作用域（Global Scope） #

这是最推荐的方案，它能自动把区域筛选逻辑应用到所有该模型的查询上，不用每次手动加条件，彻底避免遗漏。

以Group模型为例，实现步骤如下：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class Group extends Model
{
    // 定义与Region的多对多关联
    public function regions()
    {
        return $this->belongsToMany(Region::class);
    }

    protected static function booted()
    {
        // 添加全局作用域，命名为same_region
        static::addGlobalScope('same_region', function (Builder $builder) {
            $currentUser = auth()->user();
            // 仅当用户登录时才应用筛选
            if ($currentUser) {
                $builder->whereHas('regions', function ($query) use ($currentUser) {
                    // 筛选出与当前用户共享至少一个区域的Group
                    $query->whereIn('regions.id', $currentUser->regions->pluck('id'));
                });
            }
        });
    }
}

优点： #

• 自动生效：不管你调用Group::all()、Group::where('name', 'like', '%测试%')->get()还是Group::first()，都会自动带上区域筛选条件
• 可灵活跳过：如果需要绕过这个限制（比如管理员查看全量数据），可以用withoutGlobalScope：

  // 管理员获取所有Group
  $allGroups = Group::withoutGlobalScope('same_region')->get();
  

把同样的逻辑复制到User和Course模型里，就能实现全局的区域权限控制。

2. 自定义本地查询作用域（Local Scope） #

如果不想全局强制应用区域筛选，或者有多种权限场景，可以定义本地作用域，手动调用：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class Group extends Model
{
    public function regions()
    {
        return $this->belongsToMany(Region::class);
    }

    // 定义本地作用域
    public function scopeSameRegion(Builder $builder)
    {
        $currentUser = auth()->user();
        if ($currentUser) {
            $builder->whereHas('regions', function ($query) use ($currentUser) {
                $query->whereIn('regions.id', $currentUser->regions->pluck('id'));
            });
        }
        return $builder;
    }
}

使用时需要手动调用这个作用域：

// 获取当前用户同区域的Group
$sameRegionGroups = Group::sameRegion()->get();

优点： #

• 灵活性高：可以根据场景选择是否应用筛选
• 可组合性强：能和其他查询条件链式调用，比如Group::sameRegion()->where('status', 1)->get()

3. 为什么不推荐重写::all()？ #

all()方法本质上只是Model::query()->get()的快捷方式，Laravel里绝大多数查询（比如where()链式调用后get()、first()、find()）都不会经过all()方法。比如：

// 重写all()后，这个查询会绕过你的限制，返回所有状态为1的Group
$activeGroups = Group::where('status', 1)->get();

这种方式覆盖的场景极其有限，很容易出现权限漏洞，完全不适合作为全局权限控制的方案。

内容的提问来源于stack exchange，提问作者unit_sp