Laravel Eloquent关联如何配置两个foreign key和两个owner key

Laravel 原生的belongsTo关联方法仅支持单外键匹配，你直接传入5个参数的写法无法生效，因为该方法最多只接收3个关联字段参数：关联模型类、当前表外键名、关联表主键名。

要实现双字段匹配的关联，可根据使用场景选择以下两种实现方式：

方案1：适合非预加载场景 #

在单字段关联基础上追加第二个字段的匹配条件即可：

public function user()
{
    return $this->belongsTo(User::class, 'foreign_key1', 'owner_key1')
        ->where('owner_key2', $this->foreign_key2);
}

注意：该方案仅适合单次获取单条模型关联的场景，使用with做预加载时会因为$this->foreign_key2仅读取当前模型属性，导致预加载全量数据时条件错误。

方案2：兼容预加载场景 #

自定义关联逻辑同时适配单模型加载和预加载场景：

public function user()
{
    $relation = $this->belongsTo(User::class, 'foreign_key1', 'owner_key1');
    
    $relation->getQuery()->when($this->exists, 
        // 单模型加载场景，直接匹配当前模型的第二个外键值
        fn ($query) => $query->where('owner_key2', $this->foreign_key2),
        // 预加载场景，用字段对比匹配两张表的第二个关联字段
        fn ($query) => $query->whereColumn('users.owner_key2', $this->getTable() . '.foreign_key2')
    );

    return $relation;
}

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