Laravel Nova 4：如何一步同时创建用户及关联讲师档案

需求：在Nova后台单次操作中，同时创建角色为instructor的User记录和关联的InstructorProfile记录，两条记录必须同时生成，不能分步骤。

当前配置 #

User迁移文件 #

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('firstName');
    $table->string('surname');
    $table->string('email')->unique();
    $table->timestamp('email_verified_at')->nullable();
    $table->string('password');
    $table->enum('role', ['admin', 'instructor', 'normal'])->default('normal');
    $table->index('email');
    $table->index('role');
    $table->rememberToken();
    $table->timestamps();
});

InstructorProfile迁移文件 #

Schema::create('instructor_profiles', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained()->onDelete('cascade');
    $table->string('phoneNumber')->nullable();
    $table->text('bio')->nullable();
    $table->text('qualifications')->nullable();
    $table->string('photo')->nullable();
    $table->timestamps();
});

已尝试方案的问题 #

之前尝试重写Nova资源的fill()方法，但该方法仅负责填充模型属性，此时User模型尚未保存到数据库，没有生成id，无法创建关联的InstructorProfile；同时资源命名为InstructorProfile但绑定User模型，逻辑混淆，导致$model并非User实例。

解决方案 #

1. 确保模型关联正确 #

在App\Models\User中添加关联：

public function instructorProfile()
{
    return $this->hasOne(InstructorProfile::class);
}

在App\Models\InstructorProfile中添加关联：

public function user()
{
    return $this->belongsTo(User::class);
}

2. 创建专用Nova资源（Instructor） #

创建Nova资源Instructor，绑定User模型，重写store()方法实现同时创建两条记录：

namespace App\Nova;

use App\Models\User;
use Laravel\Nova\Fields\ID;
use Laravel\Nova\Fields\Text;
use Laravel\Nova\Fields\Email;
use Laravel\Nova\Fields\Password;
use Laravel\Nova\Fields\Hidden;
use Laravel\Nova\Fields\Textarea;
use Laravel\Nova\Fields\Image;
use Laravel\Nova\Http\Requests\NovaRequest;

class Instructor extends Resource
{
    public static $model = User::class;
    public static $title = 'firstName';
    public static $search = ['id', 'firstName', 'surname', 'email'];

    // 列表页仅显示讲师用户
    public static function indexQuery(NovaRequest $request, $query)
    {
        return $query->where('role', 'instructor')->with('instructorProfile');
    }

    public function fields(NovaRequest $request)
    {
        return [
            ID::make()->sortable(),

            Text::make('First Name', 'firstName')
                ->sortable()
                ->rules('required', 'max:255'),

            Text::make('Surname')
                ->sortable()
                ->rules('required', 'max:255'),

            Email::make('Email')
                ->sortable()
                ->rules('required', 'email', 'max:254')
                ->creationRules('unique:users,email')
                ->updateRules('unique:users,email,{{resourceId}}'),

            Password::make('Password')
                ->onlyOnForms()
                ->creationRules('required', 'string', 'min:8')
                ->updateRules('nullable', 'string', 'min:8'),

            Hidden::make('Role')->default('instructor'),

            // 关联讲师资料字段
            Text::make('Phone Number', 'instructorProfile.phoneNumber')
                ->nullable(),

            Textarea::make('Bio', 'instructorProfile.bio')
                ->nullable()
                ->hideFromIndex(),

            Textarea::make('Qualifications', 'instructorProfile.qualifications')
                ->nullable()
                ->hideFromIndex(),

            Image::make('Photo', 'instructorProfile.photo')
                ->disk('public')
                ->path('instructor-photos')
                ->prunable()
                ->deletable()
                ->nullable(),
        ];
    }

    // 重写store方法，先创建用户再创建关联资料
    public static function store(NovaRequest $request)
    {
        // 填充并保存用户
        $user = static::fill($request, new static::$model);
        $user->save();

        // 收集讲师资料数据
        $profileData = [
            'phoneNumber' => $request->input('instructorProfile.phoneNumber'),
            'bio' => $request->input('instructorProfile.bio'),
            'qualifications' => $request->input('instructorProfile.qualifications'),
            'created_by' => auth()->id(),
        ];

        // 处理图片字段（Nova已自动上传，直接取值）
        if ($request->has('instructorProfile.photo')) {
            $profileData['photo'] = $request->input('instructorProfile.photo');
        }

        // 创建关联的讲师资料
        $user->instructorProfile()->create($profileData);

        return $user;
    }
}

方案说明 #

• 重写store()方法而非fill()：确保User先保存到数据库，生成id后再创建关联的InstructorProfile，避免外键约束问题。
• 使用关联字段语法instructorProfile.phoneNumber：Nova会自动处理表单参数的映射，无需手动拆分请求数据。
• 专用资源命名Instructor：明确资源用途，避免模型与资源命名混淆。

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