Filament 3向导自定义Recipe创建逻辑（含Repeater与多对多中间表）

需求明确 #

• 向导步骤：食谱信息 → 食材 → 制作指南
• 自定义保存顺序：
  1. 整理适配中间表格式的食材数组
  2. 创建/更新Recipe实例并关联中间表
  3. 批量存储/更新制作步骤到GuideStep模型

核心疑问解答 #

1. 哪个钩子/方法适合执行自定义逻辑？ #

直接重写create()（更新场景重写update()）方法是最彻底的方案，它能完全接管Filament的自动保存流程，按自定义顺序处理所有数据。相比mutateFormDataBeforeCreate()或afterCreate()，重写create()可以避免Filament自动处理关联数据，完全掌控保存顺序。

2. 是否应避免在Repeater中使用->relationship()？ #

是的。一旦使用->relationship()绑定模型关联，Filament会自动触发关联数据的持久化，无法手动控制保存顺序和格式。必须改用普通Repeater收集原始数据，再手动处理存储逻辑。

3. 如何完全绕过Filament的关联数据自动保存？ #

• 所有关联字段（食材、制作步骤）不要使用->relationship()绑定模型关联
• 表单字段名称与模型关联名称区分开（比如用ingredients_data代替ingredients），避免Filament自动识别并处理关联
• 重写create()/update()方法，手动完成数据整理、模型创建/更新、关联数据存储的全流程

具体实现示例 #

1. 向导表单定义 #

在RecipeResource的CreateWizard中，用普通字段和Repeater收集数据，不绑定关联：

use Filament\Forms\Components\Repeater;
use Filament\Forms\Components\Select;
use Filament\Forms\Components\Step;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Textarea;
use Illuminate\Support\Arr;

class CreateRecipe extends CreateRecord
{
    protected static string $resource = RecipeResource::class;

    protected function getSteps(): array
    {
        return [
            Step::make('食谱信息')
                ->schema([
                    TextInput::make('name')->required()->label('食谱名称'),
                    // 添加其他Recipe模型的基础字段
                ]),
            Step::make('食材')
                ->schema([
                    Repeater::make('ingredients_data')
                        ->schema([
                            Select::make('ingredient_id')
                                ->options(\App\Models\Ingredient::pluck('name', 'id'))
                                ->required()
                                ->label('食材'),
                            TextInput::make('quantity')
                                ->required()
                                ->label('数量'),
                            Select::make('unit_id')
                                ->options(\App\Models\Unit::pluck('name', 'id'))
                                ->required()
                                ->label('单位'),
                        ])
                        ->required()
                        ->label('食材列表'),
                ]),
            Step::make('制作指南')
                ->schema([
                    Repeater::make('guide_steps')
                        ->schema([
                            TextInput::make('title')->required()->label('步骤标题'),
                            Textarea::make('description')->required()->label('步骤说明'),
                        ])
                        ->required()
                        ->label('制作步骤'),
                ]),
        ];
    }

2. 重写create()方法接管保存逻辑 #

protected function create(array $data): \Illuminate\Database\Eloquent\Model
    {
        // 1. 提取Recipe基础数据，排除关联字段
        $recipeBaseData = Arr::except($data, ['ingredients_data', 'guide_steps']);
        $recipe = \App\Models\Recipe::create($recipeBaseData);

        // 2. 整理食材数据并保存到中间表
        $ingredientsPivotData = collect($data['ingredients_data'])->map(function ($item) {
            return [
                'ingredient_id' => $item['ingredient_id'],
                'quantity' => $item['quantity'],
                'unit_id' => $item['unit_id'],
                'created_at' => now(),
                'updated_at' => now(),
            ];
        })->toArray();

        $recipe->ingredients()->attach($ingredientsPivotData);

        // 3. 批量保存制作步骤到GuideStep
        $guideStepData = collect($data['guide_steps'])->map(function ($item) use ($recipe) {
            return [
                'recipe_id' => $recipe->id,
                'title' => $item['title'],
                'description' => $item['description'],
                'created_at' => now(),
                'updated_at' => now(),
            ];
        })->toArray();

        \App\Models\GuideStep::insert($guideStepData);

        return $recipe;
    }
}

3. 更新场景的适配（可选） #

如果是编辑向导，重写update()方法，逻辑类似：

protected function update(Model $record, array $data): Model
{
    // 更新Recipe基础数据
    $record->update(Arr::except($data, ['ingredients_data', 'guide_steps']));

    // 同步食材中间表（替换原有关联）
    $ingredientsPivotData = collect($data['ingredients_data'])->mapWithKeys(function ($item) {
        return [
            $item['ingredient_id'] => [
                'quantity' => $item['quantity'],
                'unit_id' => $item['unit_id'],
                'updated_at' => now(),
            ]
        ];
    })->toArray();

    $record->ingredients()->sync($ingredientsPivotData);

    // 先删除原有制作步骤，再批量插入新数据（或按需更新）
    \App\Models\GuideStep::where('recipe_id', $record->id)->delete();
    $guideStepData = collect($data['guide_steps'])->map(function ($item) use ($record) {
        return [
            'recipe_id' => $record->id,
            'title' => $item['title'],
            'description' => $item['description'],
            'created_at' => now(),
            'updated_at' => now(),
        ];
    })->toArray();

    \App\Models\GuideStep::insert($guideStepData);

    return $record;
}

注意事项 #

• 确保GuideStep模型的$fillable包含recipe_id、title、description等字段
• 中间表ingredient_recipe的字段要与整理后的数组字段匹配
• 如果需要事务支持，可以在create()/update()方法中用DB::transaction()包裹所有操作，保证数据一致性

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