0

0

laravel怎么创建一个自定义的 Eloquent Cast 类型_laravel自定义Eloquent Cast类型方法

尼克

尼克

发布时间:2025-11-01 11:54:02

|

198人浏览过

|

来源于php中文网

原创

在 Laravel 中创建自定义 Eloquent Cast 类需实现 CastsAttributes 接口,定义 get 和 set 方法以处理数据库字段的读取与存储,如将字符串转为首字母大写。

laravel怎么创建一个自定义的 eloquent cast 类型_laravel自定义eloquent cast类型方法

在 Laravel 中,自定义 Eloquent Cast 类型可以让你更灵活地处理数据库字段的存储与读取。比如将 JSON 字符串自动转为对象,或对日期、加密数据等进行特殊处理。Laravel 8+ 支持创建可复用的自定义 Cast 类,下面介绍具体实现方法。

创建自定义 Cast 类

要创建一个自定义的 Eloquent Cast 类,你需要定义一个实现 CastsAttributes 接口的类。这个接口要求实现两个方法:getset,分别用于从数据库获取值和写入数据库前的处理。

例如,我们创建一个将字符串转为首字母大写的 Cast:

namespace App\Casts;

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;

class CapitalizeString implements CastsAttributes { /**

  • 将数据库值转换为模型属性 */ public function get($model, string $key, $value, array $attributes) { return ucfirst($value); }
/**
 * 将模型属性转换为数据库值
 */
public function set($model, string $key, $value, array $attributes)
{
    return strtolower($value);
}

}

在模型中使用自定义 Cast

定义好 Cast 类后,在 Eloquent 模型中通过 $casts 属性注册即可。

namespace App\Models;

甲骨文AI协同平台
甲骨文AI协同平台

专门用于甲骨文研究的革命性平台

下载

use App\Casts\CapitalizeString; use Illuminate\Database\Eloquent\Model;

class User extends Model { protected $casts = [ 'name' => CapitalizeString::class, ]; }

这样,每次访问 $user->name 时,值都会自动首字母大写;保存时则转为小写存入数据库(根据你的逻辑可调整)。

支持数组或复杂类型的 Cast 示例

如果你需要处理 JSON 或数组类型,比如将数据库中的 JSON 字符串转为特定对象:

namespace App\Casts;

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;

class JsonToArrayObject implements CastsAttributes { public function get($model, string $key, $value, array $attributes) { return json_decode($value, true) ?? []; }

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 让数据处理更干净,避免在模型或控制器里写重复的格式化逻辑。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

317

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

275

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

369

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

371

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

81

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

64

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

67

2025.08.05

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

412

2023.08.07

Java JVM 原理与性能调优实战
Java JVM 原理与性能调优实战

本专题系统讲解 Java 虚拟机(JVM)的核心工作原理与性能调优方法,包括 JVM 内存结构、对象创建与回收流程、垃圾回收器(Serial、CMS、G1、ZGC)对比分析、常见内存泄漏与性能瓶颈排查,以及 JVM 参数调优与监控工具(jstat、jmap、jvisualvm)的实战使用。通过真实案例,帮助学习者掌握 Java 应用在生产环境中的性能分析与优化能力。

3

2026.01.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号