Laravel Filament：如何从员工资源表单保存数据至关联Detail模型

1. 确认模型关联配置 #

首先确保Employee和Detail模型的一对一关联正确设置：

Employee模型 #

namespace App\Models;

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

class Employee extends Model
{
    protected $fillable = ['name']; // 替换为员工表实际可填充字段

    public function detail(): HasOne
    {
        return $this->hasOne(Detail::class);
    }
}

Detail模型 #

namespace App\Models;

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

class Detail extends Model
{
    protected $fillable = ['employee_id', 'email', 'mobile']; // 确保关联字段和业务字段可填充

    public function employee(): BelongsTo
    {
        return $this->belongsTo(Employee::class);
    }
}

2. 调整Resource表单结构 #

推荐用嵌套Form组件的写法，逻辑更清晰：

// 在EmployeeResource的form方法中
public static function form(Form $form): Form
{
    return $form
        ->schema([
            // 员工自身字段示例
            TextInput::make('name')->required(),
            
            Card::make('员工详情')
                ->schema([
                    Form::make('detail')
                        ->schema([
                            TextInput::make('email')
                                ->email()
                                ->required(),
                            TextInput::make('mobile')
                                ->tel()
                                ->required(),
                        ])->columns(2),
                ]),
        ]);
}

如果坚持用原有点语法写法，表单可保留，但后续需处理字段前缀：

Card::make('员工详情')
    ->schema([
        TextInput::make('detail.email')
            ->email()
            ->required(),
        TextInput::make('detail.mobile')
            ->tel()
            ->required(),
    ])->columns(2)

3. 重写Resource的保存逻辑 #

Filament默认不会自动处理关联模型的创建/更新，需重写以下两个方法：

对应嵌套Form的保存逻辑 #

// 在EmployeeResource类中引入Arr工具类
use Illuminate\Support\Arr;

public static function handleRecordCreation(array $data): Model
{
    // 创建员工主记录
    $employee = Employee::create(Arr::except($data, ['detail']));
    
    // 创建关联的详情记录
    $employee->detail()->create($data['detail']);
    
    return $employee;
}

public static function handleRecordUpdate(Model $record, array $data): Model
{
    // 更新员工主记录
    $record->update(Arr::except($data, ['detail']));
    
    // 更新或创建详情记录（兼容员工无详情的场景）
    $record->detail()->updateOrCreate([], $data['detail']);
    
    return $record;
}

对应点语法的保存逻辑 #

针对点语法的字段格式，需先转换为详情模型的字段结构：

use Illuminate\Support\Arr;

public static function handleRecordCreation(array $data): Model
{
    // 提取并转换详情字段
    $detailData = Arr::only($data, ['detail.email', 'detail.mobile']);
    $detailData = Arr::mapWithKeys($detailData, fn($value, $key) => [str_replace('detail.', '', $key) => $value]);
    
    // 创建员工和详情
    $employee = Employee::create(Arr::except($data, ['detail']));
    $employee->detail()->create($detailData);
    
    return $employee;
}

public static function handleRecordUpdate(Model $record, array $data): Model
{
    $detailData = Arr::only($data, ['detail.email', 'detail.mobile']);
    $detailData = Arr::mapWithKeys($detailData, fn($value, $key) => [str_replace('detail.', '', $key) => $value]);
    
    $record->update(Arr::except($data, ['detail']));
    $record->detail()->updateOrCreate([], $detailData);
    
    return $record;
}

注意事项 #

• 确保Detail模型的$fillable包含所有需要保存的字段，避免批量赋值异常
• 更新场景用updateOrCreate可兼容员工尚未创建详情记录的情况
• 记得引入Illuminate\Support\Arr工具类处理数组操作

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