如何将Eloquent Model的属性和方法代理到hasOne关联模型上

方案1：自定义通用关联委托Trait（推荐） #

该方案完全解耦，不会破坏Eloquent原生逻辑，同时支持属性、方法的透传：
首先编写通用Trait：

<?php

namespace App\Models\Traits;

trait DelegatesToRelatedModel
{
    // 需要在使用Trait的模型中定义该属性，值为要委托的关联方法名
    // protected $delegateTo = 'baseMonster';
    
    public function getAttribute($key)
    {
        // 优先走当前模型的原生属性逻辑（含访问器、自身属性、其他关联）
        if (parent::getAttribute($key) !== null || array_key_exists($key, $this->attributes) || array_key_exists($key, $this->relations)) {
            return parent::getAttribute($key);
        }
        
        // 当前模型找不到，走委托关联模型的属性
        $relation = $this->{$this->delegateTo};
        if ($relation) {
            return $relation->getAttribute($key);
        }
        
        return null;
    }
    
    public function __call($method, $parameters)
    {
        // 优先走当前模型的原生方法逻辑
        if (method_exists($this, $method)) {
            return call_user_func_array([$this, $method], $parameters);
        }
        
        // 当前模型找不到，走委托关联模型的方法
        $relation = $this->{$this->delegateTo};
        if ($relation && method_exists($relation, $method)) {
            return call_user_func_array([$relation, $method], $parameters);
        }
        
        // 兜底走Eloquent原生的__call逻辑（比如关联调用、宏方法等）
        return parent::__call($method, $parameters);
    }
}

在扩展模型（A/SpecificMonster）中引入即可：

<?php

namespace App\Models;

use App\Models\Traits\DelegatesToRelatedModel;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasOne;

class SpecificMonster extends Model
{
    use DelegatesToRelatedModel;
    
    // 指定要委托的关联名
    protected $delegateTo = 'baseMonster';
    
    // 你的其他业务逻辑
    public function baseMonster(): HasOne
    {
        return $this->hasOne(BaseMonster::class);
    }
}

使用效果：

$specific = SpecificMonster::with('baseMonster')->first();
// 直接访问BaseMonster的属性
echo $specific->color;
// 直接调用BaseMonster的方法
echo $specific->walk();

方案2：轻量属性透传（仅适用于属性少、不需要透传方法的场景） #

如果不需要透传方法，只有少量属性需要透传，可以直接用Eloquent的$appends+访问器实现，无魔术方法开销：

class SpecificMonster extends Model
{
    // 把要透传的BaseMonster属性加到追加属性列表
    protected $appends = ['color', 'size'];
    
    public function baseMonster(): HasOne
    {
        return $this->hasOne(BaseMonster::class);
    }
    
    public function getColorAttribute()
    {
        return $this->baseMonster?->color;
    }
    
    public function getSizeAttribute()
    {
        return $this->baseMonster?->size;
    }
}

注意事项 #

• 两种方案都建议在查询时用with预加载委托的关联模型，避免产生N+1查询问题
• 如果当前模型和委托模型存在同名属性/方法，会优先使用当前模型的成员
• 第一种方案已经兼容Eloquent原生的所有逻辑，不会破坏原有访问器、关联、宏等功能的正常使用

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