Eloquent 中不存在 AsCastable Trait，它是误传或自定义别名；正确方式是实现 Castable 接口并提供 castUsing() 方法返回真实 Cast 类，如 AsUppercase::class。
Eloquent 的 AsCastable Trait 不是 Laravel 原生提供的功能，它不存在于任何官方版本中 —— 你看到的大概率是某篇误传文章或自定义封装的别名写法。
为什么找不到 AsCastable 这个 Trait？
Laravel 官方文档和源码中从未定义过名为 AsCastable 的 Trait。Eloquent 的类型转换机制核心是：
-
casts属性（数组配置） -
getCastType()、castAttribute()等底层方法 -
AsArrayObject、AsCollection等内置 Cast 类（位于Illuminate\Database\Eloquent\Casts\）
所谓 “AsCastable”，很可能是开发者把自定义 Cast 类误当成 Trait 使用，或把 AsCollection::class 这类写法简写成 “as castable” 导致的混淆。
如何正确实现类似 “可转换特性” 的复用逻辑？
真正可复用、可声明式使用的转换能力，靠的是自定义 Cast 类，而不是 Trait。它必须实现 Castable 接口，并提供 castUsing() 静态方法：
立即学习“PHP免费学习笔记（深入）”；
use Illuminate\Contracts\Database\Eloquent\Castable;
use Illuminate\Database\Eloquent\Casts\Cast;
class AsUppercase implements Castable
{
public static function castUsing(array $arguments): string
{
return AsUppercaseCast::class;
}
}
class AsUppercaseCast implements Cast
{
public function get($model, string $key, $value, array $attributes)
{
return strtoupper($value);
}
public function set($model, string $key, $value, array $attributes): string
{
return (string) $value;
}
}
然后在模型中使用：
protected $casts = [
'name' => AsUppercase::class,
];
注意：AsUppercase::class 是 Castable 类（返回真实 Cast），不是 Trait；AsUppercaseCast 才是实际执行转换的 Cast 实现。
常见错误：把 Castable 类当 Trait 用
下面这些写法都会报错或无效：
- 在模型里
use AsCastable;→ PHP 找不到该 Trait -
'title' => AsCastable::class→ 类不存在，抛出Class 'AsCastable' not found - 直接
extends AsCastable→ 模型不能继承 Trait，语法错误
根本原因：Castable 是一个接口契约（Castable interface），不是可被 use 的 Trait。它的作用是告诉 Eloquent：“这个类能产出一个 Cast 实例”，仅此而已。
什么时候该用 Cast 类，而不是写访问器/修改器？
Cast 类适合处理「字段级、可复用、与数据库 I/O 强绑定」的转换：
- 需要在
create()、update()、fresh()、toArray()等所有生命周期中统一生效 - 多个模型都要做 JSON 解析、时间偏移、枚举映射、加密字段解密等
- 想利用 Laravel 自动的批量赋值（
fill()）、序列化（toJson()）穿透行为
而访问器（getAttributeNameAttribute()）只影响读取，修改器（setAttributeNameAttribute()）只影响写入，且不会参与 $casts 的自动类型推导和 JSON 序列化逻辑。
最易忽略的一点：自定义 Cast 类必须放在能被 Composer 自动加载的路径下（如 app/Casts/），且类名与文件名严格匹配；否则 castUsing() 返回的类名会加载失败，报错信息往往只显示 “failed to instantiate cast”，不提示具体路径问题。
