Eloquent 的 $casts、$fillable 等属性不继承，因 PHP 不支持数组类属性的自动合并；必须用 trait 封装共享逻辑或在基类中通过 getCasts() 动态合并配置。
为什么直接在父模型里定义 $casts 或 $fillable 不生效
因为 Eloquent 的 $casts、$fillable、$appends 等属性是类级别的静态配置，PHP 不会自动继承子类未显式声明的数组类属性——子类定义同名属性时会完全覆盖父类，而不是合并。常见现象是：父类写了 $casts = ['status' => 'boolean']，子类没写 $casts，结果该字段不自动转换类型。
- 必须在每个子模型中显式声明或手动合并父类配置
- 用
static::parent::PROPERTY在运行时读取不可靠（PHP 类属性不支持 late static binding 继承） - 更安全的做法是把共享逻辑抽到 trait 或基类方法里，而非依赖属性继承
用 trait 实现可复用的属性行为封装
trait 是最轻量、最可控的方式，避免继承层级污染，也便于按需组合。比如多个模型都要处理 price 字段为分单位存储、展示为元单位：
trait PriceAttribute
{
protected $casts = ['price' => 'int'];
<pre class="brush:php;toolbar:false;">public function getPriceAttribute($value)
{
return $value / 100;
}
public function setPriceAttribute($value)
{
$this->attributes['price'] = (int) round((float) $value * 100);
}}
- 在子模型中
use PriceAttribute;即可获得完整行为 - 如果子模型也要加其他
$casts，直接在类里补上：protected $casts = ['discount_rate' => 'float'];—— PHP 数组会覆盖，所以推荐只在 trait 里放共享项，个性化项写在模型本体 - 注意：trait 中的
$casts不会自动合并到模型的$casts，必须靠构造时手动合并（见下一条）
如何让父类的 $casts 和子类的 $casts 合并生效
靠重写模型的 getCastType() 或在构造中干预不现实。实际可行的是在基类模型中提供一个静态方法，由子类主动调用合并：
立即学习“PHP免费学习笔记（深入）”；
abstract class BaseModel extends Model
{
protected static $baseCasts = ['created_at' => 'datetime', 'updated_at' => 'datetime'];
<pre class="brush:php;toolbar:false;">public static function getCasts(): array
{
return array_merge(static::$baseCasts, static::$casts ?? []);
}}
然后在子模型中这样用：
class Product extends BaseModel
{
protected $casts = ['price' => 'integer', 'is_active' => 'boolean'];
<pre class="brush:php;toolbar:false;">protected $casts = self::getCasts(); // ❌ 错误：不能在属性声明里调用方法}
正确做法是放弃在属性里硬编码，改用运行时动态注入：
- 重写子模型的
__construct()，调用parent::__construct(...)后再设置：$this->casts = array_merge(static::$baseCasts, $this->casts ?? []); - 或更稳妥地，在基类中重写
getCasts()并被 Eloquent 内部调用（Laravel 9+ 支持）：public function getCasts() { return static::getCasts(); } - ⚠️ 注意：Eloquent 在序列化/反序列化时会反复读取
getCasts()，确保它返回纯数组、无副作用
Appends 和 Accessor 的继承陷阱
$appends 是字符串数组，同样不继承；而 accessor 方法（如 getFullNameAttribute()）可以被子类直接使用，但若子类也定义同名方法，就会覆盖父类。常见错误是父类加了 $appends = ['full_name']，子类忘了同步追加，导致 JSON 输出里没有该字段。
- 在基类中统一管理
$appends：定义protected $baseAppends = ['created_human'];，子类用protected $appends = ['status_label'];，然后在基类toArray()前手动合并 - 更推荐：不要依赖
$appends数组，改用append()动态添加，例如在 API 资源类中统一调用：$model->append(['full_name', 'avatar_url']) - Accessor 方法本身可继承，但记得检查是否被子类意外重写（IDE 跳转能快速发现）
真正麻烦的从来不是“怎么写”，而是“什么时候该用 trait、什么时候该用基类、什么时候干脆别共享”。字段逻辑一旦跨模型变得复杂（比如带权限判断的隐藏字段、多租户隔离的值处理），硬塞进继承链反而会让调试路径变长。留个心眼：先写清楚每个模型的实际需求，再决定要不要抽象，比一上来就设计继承树靠谱得多。
