Laravel 使用 scope 作用域

关注

原创最新推荐文章于 2025-11-01 18:11:07 发布 4.6k 阅读 AI 写同款· GEO 优化 ›

AI权益加码！Claude Code、Cursor等20+工具免费用！购周边限时加赠Coding Plan Lite，畅享主流AI工具！学习进阶更高效！阅读详情

模型层定义方法，加前缀 scope

public function scopeWithOrder($query, $order)
{
    //不同的排序，使用不同的数据读取逻辑
    switch ($order) {
        case 'recent':
            $query->recent();
            break;
        default:
            $query->recentReplied();
            break;
    }
    //预加载防止 N+1 问题
    return $query->with('user', 'category');
}

public function scopeRecentReplied($query)
{
    //当话题有新回复时，我们将编写逻辑来更新话题模型的 reply_count 属性，
    //此时会自动触发框架对数据模型 updated_at 时间戳的更新
    return $query->orderBy('updated_at', 'desc');
}

public function scopeRecent($query)
{
    //按照创建时间排序
    return $query->orderBy('created_at', 'desc');
}

控制器层通过模型实例调用方法，不用加 scope

   public function index(Request $request, Topic $topic)
    {
        $topics = $topic->withOrder($request->order)->paginate(20);
        return view('topics.index', compact('topics'));
    }

关于方法中的参数 $query ，查看Api文档了解是 scope 定义的方法有俩个参数，一个是 Builder、一个是 Model。
在 Eloquent 模型方法前加上一个 scope 前缀，作用域总是返回 查询构建器。在调用 scope 作用域的方法时，通过返回的构建器来拼接成完整的查询条件。
https://laravel.com/api/5.7/Illuminate/Database/Eloquent/Scope.html