在 laravel 中创建自定义 Eloquent Cast 类需实现 CastsAttributes 接口 ，定义 get 和 set 方法以处理 数据库 字段的读取与存储，如将 字符串 转为首字母大写。
在 Laravel 中，自定义 Eloquent Cast 类型可以让你更灵活地处理数据库字段的存储与读取。比如将 jsON 字符串自动转为 对象，或对日期、加密数据等进行特殊处理。Laravel 8+ 支持创建可复用的自定义 Cast 类，下面介绍具体实现方法。
创建自定义 Cast 类
要创建一个自定义的 Eloquent Cast 类，你需要定义一个实现 CastsAttributes 接口的类。这个接口要求实现两个方法：get 和 set，分别用于从数据库获取值和写入数据库前的处理。
例如，我们创建一个将字符串转为首字母大写的 Cast：
<?php <p>namespace AppCasts;</p><p>use IlluminateContractsDatabaseEloquentCastsAttributes;</p><p>class CapitalizeString implements CastsAttributes {/**</p><ul><li> 将数据库值转换为模型属性 */ public function get($model, string $key, $value, array $attributes) {return ucfirst($value); }</li></ul><pre class='brush:php;toolbar:false;'>/** * 将模型属性转换为数据库值 */ public function set($model, string $key, $value, array $attributes) {return strtolower($value); }}
在模型中使用自定义 Cast
定义好 Cast 类后，在 Eloquent 模型中通过 $casts 属性注册即可。
<?php <p>namespace AppModels;</p> <div class="aritcle_card"> <a class="aritcle_card_img" href="/ai/%E9%80%9A%E4%B9%89%E4%B8%87%E7%9B%B8"> <img src="https://img.php.cn/upload/ai_manual/001/503/042/68b6c8959c7f3109.png" alt=" 通义万相 "> </a> <div class="aritcle_card_info"> <a href="/ai/%E9%80%9A%E4%B9%89%E4%B8%87%E7%9B%B8"> 通义万相 </a> <p> 通义万相，一个不断进化的 AI 艺术创作大模型 </p> <div class=""> <img src="/static/images/card_xiazai.png" alt=" 通义万相 "> <span>596</span> </div> </div> <a href="/ai/%E9%80%9A%E4%B9%89%E4%B8%87%E7%9B%B8" class="aritcle_card_btn"> <span> 查看详情 </span> <img src="/static/images/cardxiayige-3.png" alt=" 通义万相 "> </a> </div> <p>use AppCastsCapitalizeString; use IlluminateDatabaseEloquentModel;</p><p>class User extends Model {protected $casts = [ 'name' => CapitalizeString::class,]; }</p>这样，每次访问 $user->name 时，值都会自动首字母大写；保存时则转为小写存入数据库（根据你的逻辑可调整）。
支持数组或复杂类型的 Cast 示例
如果你需要处理 json 或数组类型，比如将数据库中的 JSON 字符串转为特定对象：
<?php <p>namespace AppCasts;</p><p>use IlluminateContractsDatabaseEloquentCastsAttributes;</p><p>class JsonToArrayObject implements CastsAttributes {public function get($model, string $key, $value, array $attributes) {return json_decode($value, true) ?? [];}</p><pre class='brush:php;toolbar:false;'>public function set($model, string $key, $value, array $attributes) {return json_encode($value, JSON_UNESCAPED_UNICODE); }}
然后在模型中使用：
‘settings’ => JsonToArrayObject::class
注意事项
- 自定义 Cast 类必须实现 CastsAttributes 接口。
- get 方法返回的是模型中使用的值，set 方法返回的是存入数据库的值。
- Laravel 还支持 inbound casts（只进不出）和 castables，适合更高级场景。
- 确保 Cast 类位于可自动加载的 命名空间 下（如 app/Casts）。
基本上就这些。自定义 Eloquent Cast 让数据处理更干净，避免在模型或控制器里写重复的格式化逻辑。
