如何在Filament的editOptionForm中同时编辑Contact及关联User记录？

问题背景 #

在Filament框架的表单中，有一个关联Contact记录的Select字段，每条Contact都关联一个User。通过createOptionForm和createOptionUsing可以成功创建Contact及关联的User，但使用editOptionForm编辑现有联系人时，仅能更新Contact记录，无法同步更新关联的User记录。

解决方案 #

要实现编辑联系人时同步更新关联的User，需完成以下两步：

1. 完善ContactResource的表单结构 #

确保ContactResource::form()方法中包含关联User的可编辑字段，示例如下：

// 在ContactResource的form方法中
public static function form(Form $form): Form
{
    return $form
        ->schema([
            // 原有Contact字段
            TextInput::make('phone')->label('Phone'),
            Select::make('language')->label('Language')->options([/* 语言选项 */]),
            // ...其他Contact字段
            
            // 添加关联User的编辑字段
            TextInput::make('user.first_name')->label('First Name')->required(),
            TextInput::make('user.last_name')->label('Last Name')->required(),
            TextInput::make('user.email')->label('Email')->email()->required(),
            Select::make('user.language')->label('User Language')->options([/* 语言选项 */]),
            // ...其他User字段
        ]);
}

2. 添加editOptionUsing处理同步更新逻辑 #

在Select组件中新增editOptionUsing方法，接收提交的数据和当前Contact记录，同时更新Contact和其关联的User：

修改后的完整Select组件代码：

Forms\Components\Select::make('contact_id')
    ->label(__('Contact'))
    ->relationship('contacts', 'id', function ($query): void {
        $query->whereHas('user', function ($query): void {
            $query->where('userable_type', Contact::class);
        });
    })
    ->required()
    ->columnSpanFull()
    ->createOptionForm(function (Form $form) {
        return ContactResource::form($form);
    })
    ->createOptionUsing(function (array $data): int {
        $contact = Contact::create([
            'phone' => $data['phone'] ?? null,
            'language' => $data['language'],
            'contact_source_id' => $data['contact_source_id'] ?? null,
            'receive_quote_emails' => $data['receive_quote_emails'] ?? false,
            'receive_project_emails' => $data['receive_project_emails'] ?? false,
            'receive_task_emails' => $data['receive_task_emails'] ?? false,
            'meeting_date' => $data['meeting_date'] ?? null,
            'bant_budget' => $data['bant_budget'] ?? null,
            'bant_authority' => $data['bant_authority'] ?? null,
            'bant_need' => $data['bant_need'] ?? null,
            'bant_timing' => $data['bant_timing'] ?? null,
            'bant_average' => $data['bant_average'] ?? null,
            'profile_photo_path' => $data['profile_photo_path'] ?? null,
        ]);

        $user = User::create([
            'first_name' => $data['user']['first_name'],
            'last_name' => $data['user']['last_name'],
            'email' => $data['user']['email'],
            'language' => $data['language'],
            'password' => bcrypt('password'),
            'userable_type' => Contact::class,
            'userable_id' => $contact->id,
        ]);

        $contact->update(['user_id' => $user->id]);

        return $contact->id;
    })
    ->editOptionForm(function (Form $form, $record) {
        return ContactResource::form($form);
    })
    // 新增编辑同步逻辑
    ->editOptionUsing(function (array $data, Contact $record): void {
        // 提取并更新Contact自身字段
        $contactData = Arr::except($data, 'user');
        $record->update($contactData);

        // 更新关联的User字段
        if (isset($data['user'])) {
            $record->user->update($data['user']);
        }
    })
    ->getOptionLabelFromRecordUsing(fn (Contact $record) => "{$record->user->first_name} {$record->user->last_name}"),

关键说明 #

• editOptionUsing方法接收提交的表单数据$data和当前编辑的Contact记录$record两个参数
• 使用Arr::except分离出Contact自身的字段数据，避免将user字段误更新到Contact表
• 提取data中的user字段集合，直接更新关联的User模型
• 需确保Contact模型中已正确定义与User的关联关系（如public function user(): BelongsTo）

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