PHP trait 是一种水平代码复用机制，用于解决单继承限制，不能实例化，仅通过 use 注入类中提供方法（PHP 8.2+ 支持只读属性），优先级介于当前类与父类之间，支持冲突解决（insteadof/as），语义表达 has-a 关系。
PHP trait 是什么：它不是类，也不是接口，是“方法胶水”
PHP trait 是一种水平代码复用机制，专为解决单继承限制而生。它不能被实例化，也不参与继承链，只是把一组 public 或 protected 方法（PHP 8.2+ 还支持只读属性）像“贴片”一样注入到类中。
常见错误现象：Fatal error: Trait 'xxx' not found —— 忘记 use 前的 require/autoload；或误以为 trait 可以 new 实例化，结果报 Cannot instantiate trait。
- 使用场景：多个不相关的类需要共享日志、缓存、权限校验等逻辑（比如
User、Order、Product都要logAction()） - 它和
interface的区别：interface 只定义契约，trait 提供实现；和abstract class的区别：后者有继承强制性，trait 是可选组合 - PHP 5.4+ 才支持，老项目升级前需确认版本
怎么在类里用 trait：use 不是 include，顺序和冲突必须管
use 是唯一引入方式，但它不是动态加载，而是在编译期做“逻辑复制”——trait 的方法会被视为写在类体内，但优先级低于当前类自身方法，高于父类方法。
典型坑：use TraitA, TraitB; 中两个 trait 含同名方法，不显式解决会直接报 Fatal error: Trait method xxx has not been applied。
立即学习“PHP免费学习笔记（深入）”；
- 多个 trait 用逗号分隔：
use Timestampable, SoftDeletes, Searchable; - 冲突时用
insteadof指定来源：use TraitA, TraitB { TraitA::sayHello insteadof TraitB; } - 想保留双方？用
as重命名：use TraitA, TraitB { TraitB::sayHello as sayHelloFromB; } - 如果父类也有同名方法，trait 会覆盖父类，但不会覆盖子类自己写的——优先级永远是：当前类 > trait > 父类
trait 能不能有属性：PHP 8.2+ 支持只读属性，但别滥用
早期 PHP trait 只能有方法，没有属性；PHP 8.2 开始允许声明 readonly 属性，但仅限于只读，且必须初始化。
容易踩的坑：readonly 属性在 trait 中声明后，每个使用它的类都会获得一份独立副本，不是共享状态；若误加 public $data = [];（非 readonly），会直接报语法错误。
- 合法写法：
readonly public string $prefix = 'v1'; - 非法写法：
public $cache = [];（PHP 8.1 及更早直接 parse error；8.2+ 也拒绝非 readonly 普通属性） - 不要指望 trait 属性做“全局配置”——它只是模板变量，每次
use都是新实例化一份 - 需要共享状态？还是走依赖注入或静态属性，trait 不是状态容器
为什么不用继承而用 trait：单继承瓶颈 + 组合语义更干净
当一个类既要处理支付又要发短信还得记录审计日志，继承链会迅速失控：Base → PaymentCapable → SmsCapable → AuditCapable 违反单一职责，还锁死后续扩展。
trait 把能力拆成原子单元，让类按需“装配”，语义上更接近“我具有 X 能力”，而不是“我是一种 X 类型”。
- 继承表达 is-a 关系（
AdminUser extends User），trait 表达 has-a 关系（User uses Loggable） - 性能无损耗：trait 在编译期展开，运行时和手写方法无差别
- 兼容性注意：Laravel 等框架大量用 trait（如
Notifiable、HasFactory），阅读源码时看到use别下意识跳过 - 最易被忽略的一点：trait 里的
$this指向的是最终使用它的类实例，所以可以安全调用该类的其他方法或属性——但前提是它们已存在且可见
