如何在Laravel Filament V3中统一实现关联数据自定义保存？

模型关联定义 #

我有两个模型Student和StudentFeePayment，二者为一对一关联，代码如下：

// Student 模型
public function studentFeePayment()
{
    return $this->hasOne(StudentFeePayment::class);
}

// StudentFeePayment 模型
public function student() 
{
    return $this->belongsTo(Student::class);
}

初始尝试的问题 #

在Filament的StudentResource中，我用关联字段集来处理缴费信息：

Fieldset::make('Payment')
    ->relationship('studentFeePayment')
    ->schema([ ...... ])

一开始我想在ListStudents的getHeaderActions()里的创建动作中处理关联数据，但发现$data里只有Student模型的字段，没有关联的缴费数据，这是正常行为吗？

class ListStudents extends ListRecords
{
    protected static string $resource = StudentResource::class;
    protected function getHeaderActions(): array
    {
        return [
            Actions\CreateAction::make()->label('Register New Student')
                ->using(function (array $data, string $model): Model {
                    // 这里 $data 不包含关联的缴费数据
                })
        ];
    }
}

使用saveRelationshipsUsing的矛盾 #

后来尝试用saveRelationshipsUsing()自定义保存逻辑，但是发现：

• 只有给relationship()传第二个参数false时，创建动作才会触发这个回调：

Fieldset::make('Payment')
    ->relationship('studentFeePayment', false)
    ->schema([ .... ])
    ->saveRelationshipsUsing(function (Model $student, $state){
         StudentService::createStudentFeePayment($student, $state);
     }) 

但此时编辑动作会自动删除已有的StudentFeePayment记录；如果去掉第二个参数false，编辑动作正常，但创建动作又触发不了回调。

现在需要一个能同时兼容创建和编辑动作的统一方案，而且我用的是动作模态框来实现创建和编辑。

统一解决方案 #

方案1：动态设置关联参数+统一回调处理 #

利用Filament表单的isCreating()和isEditing()方法，动态控制relationship()的第二个参数，同时在回调里区分创建/更新逻辑：

Fieldset::make('Payment')
    // 创建时设为false，编辑时用默认的true
    ->relationship('studentFeePayment', fn () => !$this->isCreating())
    ->schema([
        // 你的缴费字段定义，比如金额、缴费日期等
        TextInput::make('amount')->required(),
        DatePicker::make('payment_date')->required(),
    ])
    ->saveRelationshipsUsing(function (Model $student, $state) {
        if ($existingPayment = $student->studentFeePayment) {
            // 已有缴费记录，执行更新逻辑
            StudentService::updateStudentFeePayment($existingPayment, $state);
        } else {
            // 无缴费记录，执行创建逻辑
            StudentService::createStudentFeePayment($student, $state);
        }
    })

方案2：重写Resource的表单钩子 #

直接在StudentResource的create()和update()方法中，用afterCreate和afterUpdate钩子分别处理关联数据，无需依赖relationship()字段集：

public static function create(Form $form): Form
{
    return $form
        ->schema([
            // 学生基础字段
            TextInput::make('name')->required(),
            // 缴费字段直接放在表单里，不用relationship
            Fieldset::make('Payment')
                ->schema([
                    TextInput::make('payment.amount')->required(),
                    DatePicker::make('payment.payment_date')->required(),
                ]),
        ])
        ->afterCreate(function (array $data, Model $student) {
            // 创建学生后再创建缴费记录
            StudentService::createStudentFeePayment($student, $data['payment']);
        });
}

public static function update(Form $form): Form
{
    return $form
        ->schema([
            // 学生基础字段
            TextInput::make('name')->required(),
            // 编辑时回显已有缴费数据
            Fieldset::make('Payment')
                ->schema([
                    TextInput::make('payment.amount')->required(),
                    DatePicker::make('payment.payment_date')->required(),
                ])
                ->statePath('payment'), // 指定状态路径，对应关联模型
        ])
        ->afterUpdate(function (array $data, Model $student) {
            $payment = $student->studentFeePayment ?? new StudentFeePayment();
            StudentService::updateStudentFeePayment($payment, $data['payment']);
            $payment->student()->associate($student)->save();
        });
}

方案3：在动作模态框中直接处理 #

因为你用的是动作模态框，直接在CreateAction和EditAction的using()方法里手动处理主模型和关联模型的保存：

class ListStudents extends ListRecords
{
    protected static string $resource = StudentResource::class;

    protected function getHeaderActions(): array
    {
        return [
            Actions\CreateAction::make('Register New Student')
                ->form([
                    // 学生基础字段
                    TextInput::make('name')->required(),
                    // 缴费字段
                    Fieldset::make('Payment')
                        ->schema([
                            TextInput::make('payment.amount')->required(),
                            DatePicker::make('payment.payment_date')->required(),
                        ]),
                ])
                ->using(function (array $data) {
                    // 先创建学生
                    $student = Student::create(Arr::except($data, 'payment'));
                    // 再创建缴费记录
                    StudentService::createStudentFeePayment($student, $data['payment']);
                    return $student;
                }),

            Actions\EditAction::make()
                ->form([
                    // 学生基础字段
                    TextInput::make('name')->required(),
                    // 编辑时回显缴费数据
                    Fieldset::make('Payment')
                        ->schema([
                            TextInput::make('payment.amount')->required(),
                            DatePicker::make('payment.payment_date')->required(),
                        ])
                        ->statePath('payment'),
                ])
                ->using(function (Model $student, array $data) {
                    // 更新学生信息
                    $student->update(Arr::except($data, 'payment'));
                    // 处理缴费记录：存在则更新，不存在则创建
                    if ($student->studentFeePayment) {
                        StudentService::updateStudentFeePayment($student->studentFeePayment, $data['payment']);
                    } else {
                        StudentService::createStudentFeePayment($student, $data['payment']);
                    }
                    return $student;
                }),
        ];
    }
}

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