Eloquent Attribute Composition 并非 Laravel 原生功能，而是社区对使用访问器（如 getFullNameAttribute）组合字段逻辑的非官方说法；实际需手动处理空值、避免 N+1、不可用于 where/orderBy 等数据库操作，推荐用 Trait 或基类复用逻辑。
什么是 Eloquent Attribute Composition，它不是 Laravel 原生功能
PHP 中的 Laravel 并没有叫 Attribute Composition 的内置机制或官方术语。你在文档、GitHub 或 Stack Overflow 上搜不到这个名词——它大概率是某篇博客或教程对「用访问器（accessor）组合多个字段逻辑」的自定义说法。真实可用的是 Laravel 的 getAttribute 和 get{Attribute}Attribute 访问器，配合手动拼接、计算或调用其他模型方法来“合成”属性。
怎么在 Model 里安全地组合出一个计算属性（比如 full_name）
常见错误是直接在 getFullNameAttribute 里硬写 $this->first_name . ' ' . $this->last_name，但没考虑空值、null、trim 或数据库字段实际是否存在。更隐蔽的问题是：这个属性被当成普通字段参与 toArray() 或 API 返回时，可能意外触发 N+1（如果内部又查了关联）。
- 始终用
?? ''或Str::of()->trim()处理可能为 null 的字段，避免空格拼接出"John " - 不要在访问器里调用
$this->relation->name，除非你明确已预加载（with('relation')），否则会悄悄触发额外查询 - 如果组合逻辑较重（比如要查缓存、调用外部 API），改用普通方法（如
getDisplayName()），并显式调用，不注册为访问器 - 示例：
public function getFullNameAttribute() { return trim(sprintf('%s %s', $this->first_name ?? '', $this->last_name ?? '')); }
为什么不能把组合属性当数据库字段用（where / orderBy / select）
因为 full_name 是 PHP 层动态计算的，MySQL 根本不知道它存在。你写 where('full_name', 'like', '%john%') 会报错 Column not found: 1054 Unknown column 'full_name'；写 orderBy('full_name') 同样失败。
- 要在数据库层实现类似效果，必须用
DB::raw()或查询构造器的selectRaw，例如：->selectRaw("CONCAT(first_name, ' ', last_name) as full_name") - 如果需要搜索，得拆成
whereRaw("CONCAT(first_name, ' ', last_name) LIKE ?", ["%john%"])，注意 SQL 注入风险，务必参数化 - Eloquent 的
appends属性只影响序列化输出（toArray()），对查询无任何作用
想复用组合逻辑？别复制粘贴，用 Trait 或基类封装
多个 Model 都要 full_name、display_status、avatar_url 这类逻辑时，手写一堆重复访问器很快失控。Laravel 不提供“组合属性注册系统”，但你可以控制抽象粒度。
立即学习“PHP免费学习笔记（深入）”；
- 简单场景：抽成
NameableTrait，里面放getFullNameAttribute和相关配置（如分隔符可配） - 复杂场景：建一个
ComputedAttributes抽象基类，让 Model 继承，再通过protected $computed = ['full_name']声明，统一管理初始化和缓存 - 切记：Trait 中的访问器仍受 Model 实例生命周期约束，无法跨模型共享状态（比如缓存结果），别试图在 Trait 里用 static 变量存组合结果
appends 就能像数据库字段一样被查询，其实它连 SQL 的边都碰不到。 
