告别重复：当 Eloquent Scopes 遇到数据选择的痛点
作为 laravel 开发者，我们都深知 Eloquent Query Scopes 的强大之处。它们让我们可以将复杂的查询条件封装成简洁的方法，提高代码复用性和可读性。比如，我们可能有一个 Post 模型，并定义了一个 scopePublished 方法来获取所有已发布的文章：
<pre class="brush:php;toolbar:false;">class Post extends Model { public function scopePublished($query) { return $query->whereNotNull('published_at'); } } // 获取所有已发布的文章 $publishedPosts = Post::published()->get();
这很棒！但问题来了：如果我现在想获取所有文章，同时又想知道每一篇文章是否处于“已发布”状态，该怎么办呢？
我们可能会不自觉地写出这样的代码：
<pre class="brush:php;toolbar:false;">$allPosts = Post::all(); $allPosts->each(function (Post $post) { // 方案一：在 PHP 层面重复逻辑判断 $isPublished = !is_null($post->published_at); // ... 对 $isPublished 进行操作 });
当作用域逻辑变得更复杂，比如涉及到关联关系（“文章是否有超过10条评论”）、动态参数（“文章是否属于某个类型”）或者多个作用域的组合时，这种 PHP 层面的重复判断和计算就会变得非常低效和难以维护。
<pre class="brush:php;toolbar:false;">class Post extends Model { // ... public function comments() { return $this->hasMany(Comment::class); } public function scopePublishedInCurrentYear($query) { /* ... */ } public function scopePopular($query) { return $query->has('comments', '>=', 10); } } $allPosts = Post::all(); $allPosts->each(function (Post $post) { // 方案二：更复杂的 PHP 层面重复逻辑，可能导致 N+1 查询问题 $isRecentAndPopular = $post->comments()->count() >= 10 && optional($post->published_at)->isCurrentYear(); // ... });
这种做法不仅代码冗余，而且在处理大量数据时，$post->comments()->count() 这样的操作会引发 N+1 查询问题，严重拖慢应用性能。我们渴望一种更优雅、更高效的方式来解决这个问题。
优雅的解决方案：protonemedia/laravel-eloquent-scope-as-select
幸运的是，protonemedia/laravel-eloquent-scope-as-select 这个 composer 包应运而生，它提供了一个完美的解决方案。这个包的核心思想是将你的 Eloquent Query Scopes 转化为 sql SELECT 语句中的子查询，从而在数据库层面直接计算出每个模型是否满足特定作用域条件，并将其作为新的属性添加到模型实例中。
它的优势显而易见：
- 告别重复代码 (DRY原则)： 你不再需要在 PHP 层面重复编写或模拟作用域的逻辑，直接复用已有的 Eloquent Scope。
- 性能大幅提升： 所有判断都在数据库查询阶段完成，避免了 N+1 查询和 PHP 层面大量的循环计算。
- 代码清晰度与可读性： 模型实例会直接拥有如
is_published这样的布尔属性，代码意图一目了然。 - 易于维护： 作用域逻辑的变更只需修改一次，所有使用它的地方都会自动更新。
快速上手与实践
首先，通过 Composer 安装这个包：
<code class="bash">composer require protonemedia/laravel-eloquent-scope-as-select</code>
然后，你需要在 appServiceProvider 的 boot 方法中注册它的宏：
<pre class="brush:php;toolbar:false;">// app/Providers/AppServiceProvider.php use ProtoneMediaLaravelEloquentScopeAsSelectScopeAsSelect; public function boot() { ScopeAsSelect::addmacro(); // 默认宏名称为 addScopeAsSelect // 或者你可以自定义宏名称 // ScopeAsSelect::addMacro('withScopeAsSubQuery'); }
现在，我们就可以开始使用它了！
1. 将简单的作用域作为选择项：
假设我们有 scopePublished 作用域。
<pre class="brush:php;toolbar:false;">use AppModelsPost; $posts = Post::addScopeAsSelect('is_published', function ($query) { $query->published(); })->get(); // 简洁写法，直接传入作用域名称字符串 $posts = Post::addScopeAsSelect('is_published', 'published')->get(); $posts->each(function (Post $post) { if ($post->is_published) { echo "文章 '{$post->title}' 已发布。n"; } else { echo "文章 '{$post->title}' 未发布。n"; } });
现在，每个 Post 模型实例都会多一个 is_published 的布尔属性，直接反映其发布状态，无需额外逻辑。
2. 处理更复杂的作用域组合与关联关系：
结合我们之前的“本年度发布且有超过10条评论”的复杂需求：
<pre class="brush:php;toolbar:false;">use AppModelsPost; $posts = Post::query() ->addScopeAsSelect('is_published_this_year_and_popular', function ($query) { $query->publishedInCurrentYear()->popular(); // 复用已有的作用域 }) ->get(); $posts->each(function (Post $post) { if ($post->is_published_this_year_and_popular) { echo "文章 '{$post->title}' 是本年度热门文章。n"; } });
看，代码变得多么简洁和富有表达力！所有的复杂判断都下沉到了数据库层面，我们只关心最终的结果。
3. 支持动态作用域和多种快捷方式：
该包还支持通过数组来调用动态作用域，甚至可以翻转结果：
<pre class="brush:php;toolbar:false;">// 动态作用域：ofType('announcement') $posts = Post::addScopeAsSelect('is_announcement', ['ofType' => 'announcement'])->get(); // 翻转结果：is_not_announcement $posts = Post::addScopeAsSelect('is_not_announcement', ['ofType' => 'announcement'], false)->get(); // 如果 postA 是公告，则 $postA->is_announcement 为 true // 如果 postB 不是公告，则 $postB->is_not_announcement 为 true
这些快捷方式进一步简化了代码，让你可以根据实际需求灵活使用。
总结与展望
protonemedia/laravel-eloquent-scope-as-select 包为 Laravel 开发者提供了一个优雅而高效的方式来解决 Eloquent Query Scopes 逻辑重复和性能低下的问题。通过将作用域转化为子查询，它不仅遵循了 DRY 原则，大幅提升了数据查询效率，还让你的代码更加清晰、易于理解和维护。
如果你在项目中经常遇到需要获取所有数据并根据复杂条件对每条数据进行标记的场景，那么这个包绝对值得你尝试。它能帮助你写出更“Laravel-esque”的代码，让数据库为你做更多的工作，从而释放你的 PHP 应用的潜力。
拥抱这个强大的工具，让你的 Laravel 应用在性能和代码质量上更上一层楼吧！