Laravel 9 创建Run父模型时调用createMany()动态生成Cultivar子表数据

问题背景 #

面向室内/室外家庭种植者的园艺应用中，Run（种植批次）模型与Cultivar（栽培植株）模型为一对多关联：单个种植批次可关联多株栽培植株，每株栽培植株归属于一个种植批次。创建新种植批次时，用户会填写该批次包含的植株总数，现有硬编码固定条数的createMany()逻辑可正常运行，需要调整为根据用户输入值动态生成对应数量的关联植株数据。

核心实现 #

核心逻辑是根据用户传入的植株数量，循环生成符合格式的关联数据数组，再传入createMany()即可。注意通过Eloquent关联调用createMany()时，框架会自动给子模型填充外键字段，不需要手动传入run_id。
完整可运行代码如下：

public function createRun()
{
    // 先校验输入参数，避免非法值导致异常
    $validated = $this->validate([
        'name' => 'required|string|max:255',
        'cultivars' => 'required|integer|min:1'
    ]);

    // 创建种植批次主记录
    $run = Run::create([
        'tenant_id' => 1, // 替换为项目中实际的租户ID获取逻辑
        'name' => $validated['name'],
        'cultivars' => $validated['cultivars']
    ]);

    // 动态生成对应数量的植株数据
    $cultivars = [];
    for ($i = 1; $i <= $validated['cultivars']; $i++) {
        $cultivars[] = [
            'name' => "{$run->name} {$i}",
            // 在这里补充Cultivar模型其他必填字段的默认值即可
            'created_at' => now(),
            'updated_at' => now()
        ];
    }

    // 批量创建关联植株记录
    $run->cultivars()->createMany($cultivars);

    return;
}

简洁写法优化 #

如果不想写for循环，可以用Laravel集合提供的times()方法快速生成指定条数的数据，代码更精简：

$cultivars = collect()->times($validated['cultivars'], function($i) use ($run) {
    return [
        'name' => "{$run->name} {$i}",
        'created_at' => now(),
        'updated_at' => now()
    ];
})->all();

$run->cultivars()->createMany($cultivars);

注意事项 #

• 必须对用户输入的植株数量做校验，限制最小值为1，防止传入0、负数或者非数字值触发数据库报错
• 不要手动给子模型数组传入run_id外键，Eloquent关联逻辑会自动绑定当前父模型的主键ID，手动传值反而可能出现ID不匹配的问题
• 如果Cultivar表有其他非空字段，需要在生成数据数组时统一补充对应默认值，否则会触发SQL非空约束错误

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