Laravel中如何仅通过外键ID自动更新关联字段？

我有User和UserCategory两个关联数据表，通过分类ID建立关联。User表同时包含user_category_id（关联UserCategory的外键ID）和user_category_name（关联UserCategory的name字段）两个字段。现在创建或更新User模型时，需要手动查询UserCategory获取名称赋值，希望仅传入user_category_id就能自动填充user_category_name，求更高效的实现方式。

现有表结构与模型代码 #

User表结构 #

public function up()
{
    Schema::create('User', function (Blueprint $table) {
        $table->id();
        $table->string('name')->unique()->comment('用户名称');
        $table->foreignId('user_category_id')->constrained('UserCategory');
        $table->string('user_category_name');
        $table->foreign('user_category_name')->references('name')->on('UserCategory');
    });
}

User模型关联 #

public function user_category()
{
    return $this->belongsTo(UserCategory::class, 'user_category_id');
}

期望实现 #

\App\Models\User::create([
    'name' => '管理员用户',
    'user_category_id' => 1, // 无需指定category_name
]);

当前手动实现方式 #

\App\Models\User::create([
    'name' => '管理员用户',
    'user_category_id' => 1,
    'user_category_name' => \App\Models\UserCategory::find(1)->name, // 不想这么做
]);

方案一：Laravel模型观察者（推荐） #

通过观察者监听User模型的创建、更新事件，自动填充分类名称。

1. 生成观察者类：

php artisan make:observer UserObserver --model=User

2. 在观察者类中编写填充逻辑：

namespace App\Observers;

use App\Models\User;
use App\Models\UserCategory;

class UserObserver
{
    // 创建用户时自动填充
    public function creating(User $user)
    {
        if ($user->user_category_id) {
            $category = UserCategory::find($user->user_category_id);
            $user->user_category_name = $category->name ?? '';
        }
    }

    // 更新用户且分类ID变更时，重新填充名称
    public function updating(User $user)
    {
        if ($user->isDirty('user_category_id')) {
            $category = UserCategory::find($user->user_category_id);
            $user->user_category_name = $category->name ?? '';
        }
    }
}

3. 在AppServiceProvider中注册观察者：

namespace App\Providers;

use App\Models\User;
use App\Observers\UserObserver;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        User::observe(UserObserver::class);
    }
}

完成后，创建或更新用户时只需传入user_category_id，系统会自动同步分类名称。

方案二：模型内联事件 #

如果不想单独创建观察者类，可直接在User模型的boot方法中定义事件逻辑：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use App\Models\UserCategory;

class User extends Model
{
    protected static function boot()
    {
        parent::boot();

        // 创建时填充
        static::creating(function ($user) {
            if ($user->user_category_id) {
                $category = UserCategory::find($user->user_category_id);
                $user->user_category_name = $category->name ?? '';
            }
        });

        // 更新时检查分类ID是否变更，变更则重新填充
        static::updating(function ($user) {
            if ($user->isDirty('user_category_id')) {
                $category = UserCategory::find($user->user_category_id);
                $user->user_category_name = $category->name ?? '';
            }
        });
    }

    public function user_category()
    {
        return $this->belongsTo(UserCategory::class, 'user_category_id');
    }
}

方案三：数据库触发器 #

从数据库层面实现字段同步，无需修改代码，但逻辑存储在数据库中，维护成本较高。以MySQL为例：

-- 插入用户时自动同步分类名称
DELIMITER //
CREATE TRIGGER user_insert_category_name
BEFORE INSERT ON User
FOR EACH ROW
BEGIN
    SELECT name INTO NEW.user_category_name FROM UserCategory WHERE id = NEW.user_category_id;
END //
DELIMITER ;

-- 更新用户且分类ID变更时，同步分类名称
DELIMITER //
CREATE TRIGGER user_update_category_name
BEFORE UPDATE ON User
FOR EACH ROW
BEGIN
    IF NEW.user_category_id != OLD.user_category_id THEN
        SELECT name INTO NEW.user_category_name FROM UserCategory WHERE id = NEW.user_category_id;
    END IF;
END //
DELIMITER ;

额外优化建议：避免冗余存储 #

从数据库设计角度，存储user_category_name属于冗余字段，当UserCategory的名称修改时，历史用户数据会出现不一致（除非用触发器强制同步）。更优的方式是通过关联关系动态获取名称：

在User模型中定义访问器：

public function getUserCategoryNameAttribute()
{
    return $this->user_category->name ?? '';
}

使用时直接通过$user->user_category_name即可获取分类名称，无需在数据库中存储该字段，彻底避免数据不一致问题。

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