0

0

laravel Eloquent中accessors和mutators怎么用_laravel Eloquent accessors与mutators使用方法

尼克

尼克

发布时间:2025-10-15 09:45:01

|

365人浏览过

|

来源于php中文网

原创

Laravel通过访问器和修改器实现字段自动转换,访问器按get{Attribute}Attribute命名规范格式化读取值,如转大写、日期处理;修改器按set{Attribute}Attribute规范预处理写入值,如邮箱转小写;可自定义日期格式或创建虚拟属性如全名拼接;需注意方法为public、命名驼峰转换、避免性能损耗与副作用。

laravel eloquent中accessors和mutators怎么用_laravel eloquent accessors与mutators使用方法

如果您在使用 Laravel Eloquent 模型时需要对字段进行格式化输出或写入前处理,则可以利用访问器(Accessors)和修改器(Mutators)实现数据的自动转换。以下是具体的使用方法。

本文运行环境:MacBook Pro,macOS Sonoma

一、定义 Accessors(访问器)

Accessors 用于在从数据库获取属性值后对其进行格式化处理,例如将字符串转为驼峰格式、日期格式化等。Laravel 会自动检测并调用对应字段的访问器。

1、在 Eloquent 模型中创建一个方法,方法名遵循 get{Attribute}Attribute 的命名规范,其中 {Attribute} 是对应字段的驼峰式写法。

2、例如,数据库中有 first_name 字段,希望获取时自动转为大写:

public function getFirstNameAttribute($value)

{

    return ucfirst($value);

}

3、当访问模型的 $model->first_name 时,返回值将自动经过此处理。

二、定义 Mutators(修改器)

Mutators 用于在保存数据到数据库之前对属性值进行预处理,比如加密、格式标准化等。它确保写入的数据符合预期格式。

1、在模型中定义方法,命名规则为 set{Attribute}Attribute,{Attribute} 同样是字段名的驼峰形式。

2、例如,希望在存储邮箱前自动转为小写:

public function setEmailAttribute($value)

{

    $this->attributes['email'] = strtolower($value);

}

3、每次设置 $model->email = 'User@Example.com' 时,实际存入数据库的将是全小写形式。

三、处理日期字段的自动格式化

Laravel 默认通过 $dates 属性自动处理日期类型字段,但也可通过访问器自定义显示格式。

1、确保模型中已将字段加入 protected $dates 数组,如:'created_at'

Memories.ai
Memories.ai

专注于视频解析的AI视觉记忆模型

下载

2、定义访问器以返回特定格式的时间字符串:

public function getCreatedAtAttribute($value)

{

    return \Carbon\Carbon::parse($value)->format('Y-m-d H:i');

}

3、此后访问 $model->created_at 将返回格式化后的字符串。

四、使用访问器组合派生属性

您可以创建不对应数据库字段的虚拟属性,通过访问器动态生成组合值。

1、定义一个访问器返回多个字段拼接的结果,例如全名:

public function getFullNameAttribute()

{

    return $this->first_name . ' ' . $this->last_name;

}

2、在模型实例上调用 $model->full_name 即可获取拼接结果。

3、该属性不会被自动保存到数据库,仅用于读取时展示。

五、注意事项与最佳实践

在使用 Accessors 和 Mutators 时需注意命名规范和属性可见性,避免意外行为。

1、确保方法为 public,否则无法被 Eloquent 调用。

2、若字段名称含多个下划线,如 is_active_flag,则访问器应命名为 getIsActiveFlagAttribute

3、避免在访问器中执行耗时操作或远程请求,以免影响性能。

4、修改器中不应修改其他非当前字段的属性值,防止产生副作用。

相关专题

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

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

319

2024.04.09

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

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

277

2024.04.09

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

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

370

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

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

679

2023.07.31

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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号