本文详解如何在 Laravel 中通过本地作用域（Local Scopes）封装条件逻辑，实现对 Client 关联的 Credit 模型按 status = 1（ACTIVE）高效筛选，并在 Livewire 视图中清晰展示“活跃信贷数”，避免 N+1 查询与重复条件硬编码。
本文详解如何在 laravel 中通过本地作用域（local scopes）封装条件逻辑，实现对 `client` 关联的 `credit` 模型按 `status = 1`（active）高效筛选，并在 livewire 视图中清晰展示“活跃信贷数”，避免 n+1 查询与重复条件硬编码。
在实际业务中，仅统计客户拥有的信贷总数（如 $item->credits->count()）往往不够——我们需要区分状态，例如只关注 status = 1（即 Credit::ACTIVE）的活跃信贷。若直接在视图中遍历并手动过滤（如 ->filter(...)->count()），不仅性能低下（触发全部关系加载），更违背了 Eloquent 的职责分离原则。
✅ 正确做法是：将状态筛选逻辑下沉至模型层，通过本地作用域封装可复用、语义清晰的查询约束。
一、定义本地作用域（Local Scope）
在 Credit 模型中添加两个语义化作用域方法（注意命名规范：必须以 scope 开头，驼峰命名）：
// app/Models/Credit.php
use Illuminate\Database\Eloquent\Builder;
class Credit extends Model
{
const ACTIVE = 1;
const LIQUIDATED = 2;
protected $fillable = ['amount', 'amount_end', 'status', 'dues'];
// ... 其他关系定义（client, provider, payments）
/**
* 本地作用域：仅查询状态为 ACTIVE 的信贷
*/
public function scopeActive(Builder $query): Builder
{
return $query->where('status', self::ACTIVE);
}
/**
* 本地作用域：仅查询状态为 LIQUIDATED 的信贷
*/
public function scopeLiquidated(Builder $query): Builder
{
return $query->where('status', self::LIQUIDATED);
}
}
⚠️ 注意：作用域方法必须返回 $query（即 Builder 实例），否则链式调用会中断；且首个参数固定为 Builder $query，Eloquent 会自动注入。
二、在关联查询中使用作用域（关键！）
你不能对已加载的集合（如 $item->credits）直接调用作用域——那是 Eloquent Builder 的能力，而非 Collection 方法。因此，必须在查询阶段就应用作用域。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
修改 Livewire 组件的 mount() 或 render() 方法，在获取 $clients 时预加载「已过滤的活跃信贷」：
// app/Livewire/ShowClient.php
public function render()
{
$clients = Client::withCount(['credits as active_credits_count' => fn ($q) => $q->active()])
->with(['credits' => fn ($q) => $q->active()]) // 可选：预加载活跃信贷数据
->get();
return view('livewire.show-client', compact('clients'));
}
这里使用了 withCount() 的高级语法：'credits as active_credits_count' => fn ($q) => $q->active()，它会生成 SQL 子查询，直接在数据库层面统计每个客户的 active 信贷数量，并将结果挂载为 $client->active_credits_count 属性——零内存开销，极致高效。
三、更新 Livewire 视图逻辑
现在视图中可直接使用计算好的 active_credits_count，无需遍历或过滤：
@foreach ($clients as $item)
<div class="client-card">
<h3>{{ $item->name }}</h3>
@switch($item->active_credits_count)
@case(0)
<span class="px-2 py-1 bg-green-400 text-green-900 rounded-md text-sm font-semibold">
No Active Credits
</span>
@break
@case(1)
<span class="px-2 py-1 bg-yellow-300 text-yellow-600 rounded-md text-sm font-semibold">
1 Active Credit
</span>
@break
@default
<span class="px-2 py-1 bg-orange-300 text-orange-700 rounded-md text-sm font-semibold">
{{ $item->active_credits_count }} Active Credits
</span>
@break
@endswitch
</div>
@endforeach
四、进阶提示：组合与复用
- ✅ 作用域支持链式组合：Credit::active()->where('amount', '>', 1000)->get()
- ✅ 可搭配 whereHas() 精准筛选主模型：
Client::whereHas('credits', fn ($q) => $q->active())->get(); - ❌ 避免在作用域内调用 $query->toSql() 调试（未编译报错），改用 dd($query->toRawSql()) 或 Laravel Telescope。
通过本地作用域，你不仅让代码更安全、可读、可测试，更将业务语义（如 “active”）直接注入到模型 API 中——这才是 Laravel Eloquent 设计哲学的精髓：用面向对象的方式，表达数据意图。
