在 Laravel Eloquent 中构建多层级关联查询与优化

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

class Sponsor extends Model
{
    /**
     * 获取与赞助商关联的所有选择项。
     */
    public function optins(): HasMany
    {
        return $this->hasMany(Optin::class);
    }
}

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class Optin extends Model
{
    /**
     * 获取此选择项所属的赞助商。
     */
    public function sponsor(): BelongsTo
    {
        return $this->belongsTo(Sponsor::class);
    }

    /**
     * 获取此选择项所属的参与者。
     */
    public function participant(): BelongsTo
    {
        return $this->belongsTo(Participant::class);
    }
}

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Support\Carbon;

class Participant extends Model
{
    /**
     * 获取与参与者关联的所有选择项。
     */
    public function optins(): HasMany
    {
        return $this->hasMany(Optin::class);
    }

    /**
     * 查询作用域：获取今天创建的参与者。
     */
    public function scopeCreatedToday($query)
    {
        return $query->whereDate('created_at', Carbon::today());
    }
}

use App\Models\Sponsor;

$sponsor = Sponsor::find(1); // 假设我们查询 ID 为 1 的赞助商

if ($sponsor) {
    $optins = $sponsor->optins()->get(); // 获取赞助商的所有选择项

    foreach ($optins as $optin) {
        // 进一步获取每个选择项对应的参与者
        // 并且需要手动过滤创建日期
        // 这种方式会导致 N+1 查询问题，效率低下
        echo("参与者 ID: " . $optin->participant_id . "\n");
        // 实际应用中，这里还需要加载 Participant 对象并检查其 created_at
    }
}

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Relations\BelongsToMany; // 引入 BelongsToMany

class Sponsor extends Model
{
    /**
     * 获取与赞助商关联的所有选择项。
     */
    public function optins(): HasMany
    {
        return $this->hasMany(Optin::class);
    }

    /**
     * 获取通过 Optin 模型与赞助商关联的所有参与者。
     */
    public function participants(): BelongsToMany
    {
        // 第一个参数是目标模型 (Participant::class)
        // 第二个参数是中间模型 (Optin::class)，Eloquent 会通过 Optin 模型查找关联
        return $this->belongsToMany(Participant::class, Optin::class);
    }
}

use App\Models\Sponsor;

// 查找 ID 为 1 的赞助商
$sponsor = Sponsor::find(1);

if ($sponsor) {
    // 通过赞助商的 participants 关系，直接查询今天创建的参与者
    $participants = $sponsor->participants()->createdToday()->get();

    foreach ($participants as $participant) {
        // 现在可以直接处理每个参与者对象，而无需担心 N+1 问题
        echo("处理参与者: ID=" . $participant->id . ", 姓名=" . $participant->name . "\n");
        // 示例：发送邮件
        // Mail::to($participant->email)->send(new SomeEmail($participant));
    }
} else {
    echo "未找到指定赞助商。\n";
}