Eloquent Attribute Delegation是开发者对通过访问器/修改器或__get/__set将属性操作委托给关联模型的通俗叫法；它非Laravel官方术语，分语法糖式（如$user->age）和动态委托式（需手动实现），各有适用场景与限制。
什么是Eloquent Attribute Delegation（属性委托）
这不是 Laravel 官方术语，而是开发者对“用访问器/修改器把属性操作转给关联模型或嵌套对象”的通俗叫法。比如 $user->profile->age 写成 $user->age，背后自动从 profile 关联里取值——这不算真正的委托，只是语法糖；真要实现类似 Ruby 的 delegate 行为，得靠 __get/__set 或访问器手动转发。
用 __get 和 __set 实现动态属性委托
这是最灵活的方式，适合委托目标不固定、或需运行时判断的场景。但要注意：它会绕过 Eloquent 的属性变更检测，$model->isDirty() 可能不准，且无法被 casts 或 appends 自动识别。
- 在模型中定义
__get：检查属性名是否匹配预设委托规则（如以profile_开头），再从$this->profile中取值 - 必须显式调用
$this->profile加载关联，否则可能触发 N+1；建议加->loadMissing('profile') -
__set同理，但注意：Eloquent 默认不允许直接写入关联模型字段，需手动赋值后调用$this->profile->save() - 别忘了在
__get里加return parent::__get($key)回退到默认逻辑，否则原生属性（如id）会失效
public function __get($key)
{
if (str_starts_with($key, 'profile_')) {
$this->loadMissing('profile');
return $this->profile?->{Str::after($key, 'profile_')};
}
return parent::__get($key);
}
用访问器（Accessors）委托更安全、更可控
如果你只委托几个确定字段（比如 age、bio），访问器是首选：类型安全、支持 casts、能进 $hidden/$appends、序列化也正常。
- 命名必须是
get{StudlyCase}Attribute，例如委托profile.age到age，就写getAgeAttribute - 内部仍要处理关联未加载的情况，推荐用
$this->relationLoaded('profile') ?: $this->load('profile') - 不要在访问器里做耗时操作（如 API 调用），它会在每次读取时触发
- 如果委托字段本身有 setter（比如
setAgeAttribute），记得同步实现，否则赋值会静默失败
protected function getAgeAttribute()
{
$this->loadMissing('profile');
return $this->profile?->age;
}
protected function setAgeAttribute($value)
{
$this->loadMissing('profile');
if ($this->profile) {
$this->profile->age = $value;
$this->profile->save();
}
}
别忽略序列化和批量赋值的影响
委托属性默认不会出现在 $model->toArray() 里，除非你把它加进 $appends；同样，fill() 或创建时传数组也不会触发 setter——这是最容易被忽略的点。
立即学习“PHP免费学习笔记（深入）”；
- 想让
age出现在 JSON 响应中？必须加protected $appends = ['age']; - 想支持
User::create(['age' => 25])？不能只靠访问器，得重写fill()或监听creating事件来拆解并分发 - 使用
with预加载时，委托属性不会自动触发关联加载，仍需在访问器里补loadMissing - 测试时容易漏掉「关联为空」分支，务必测
$user->profile = null场景下委托属性是否返回null而非报错
真正难的不是写转发逻辑，而是厘清责任边界：这个字段到底属于主模型，还是纯属代理？一旦业务要求主模型也能独立存 age（比如 profile 可为空），委托模式就会迅速变得脆弱。这时候该拆字段，而不是硬撑委托。
