内容简介:访问器和修改器允许你在获取模型属性或设置其值时格式化 Eloquent 属性。例如,你可能想要使用Laravel 加密器对存储在数据库中的数据进行加密,并且在 Eloquent 模型中访问时自动进行解密。除了自定义访问器和修改器,Eloquent 还可以自动转换日期字段为要定义一个访问器,需要在模型中创建一个
简介
访问器和修改器允许你在获取模型属性或设置其值时格式化 Eloquent 属性。例如,你可能想要使用 Laravel 加密器对存储在数据库中的数据进行加密,并且在 Eloquent 模型中访问时自动进行解密。
除了自定义访问器和修改器,Eloquent 还可以自动转换日期字段为 Carbon 实例甚至将文本转换为JSON。
访问器 & 修改器
定义访问器
要定义一个访问器,需要在模型中创建一个 getFooAttribute
方法,其中 Foo
是你想要访问的字段名(使用驼峰式命名规则)。在本例中,我们将会为 first_name
属性定义一个访问器,该访问器在获取 first_name
的值时被 Eloquent 自动调用:
<?php namespace App; use Illuminate\Database\Eloquent\Model; class User extends Model { /** * 获取用户的名字 * * @param string $value * @return string */ public function getFirstNameAttribute($value) { return ucfirst($value); } }
正如你所看到的,该字段的原生值被传递给访问器,然后返回处理过的值。要访问该值只需要简单访问 first_name
即可:
$user = App\User::find(1); $firstName = $user->first_name;
当然,你也可以使用访问器将已存在的属性转化为全新的、经过处理的值:
/** * 获取用户的全名 * * @return string */ public function getFullNameAttribute() { return "{$this->first_name} {$this->last_name}"; }
定义修改器
要定义一个修改器,需要在模型中定义 setFooAttribute
方法,其中 Foo
是你想要访问的字段(使用驼峰式命名规则)。接下来让我们为 first_name
属性定义一个修改器,当我们为模型上的 first_name
赋值时该修改器会被自动调用:
<?php namespace App; use Illuminate\Database\Eloquent\Model; class User extends Model { /** * 设置用户的名字 * * @param string $value * @return string */ public function setFirstNameAttribute($value) { $this->attributes['first_name'] = strtolower($value); } }
该修改器获取要被设置的属性值,允许你操纵该值并设置 Eloquent 模型内部属性值为操作后的值。例如,如果你尝试设置 Sally
的 first_name
属性:
$user = App\User::find(1); $user->first_name = 'Sally';
在本例中, setFirstNameAttribute
方法会被调用,传入参数为 Sally
,修改器会对其调用 strtolower
函数并将处理后的值设置为内部属性的值。
日期修改器
默认情况下,Eloquent 将会转化 created_at
和 updated_at
列的值为 Carbon
实例,该类继承自 PHP 原生的 Datetime
类,并提供了各种有用的方法。你可以自定义哪些字段被自动调整修改,甚至可以通过重写模型中的 $dates
属性完全禁止调整:
<?php namespace App; use Illuminate\Database\Eloquent\Model; class User extends Model { /** * 应该被调整为日期的属性 * * @var array */ protected $dates = [ 'created_at', 'updated_at', 'disabled_at' ]; }
如果字段是日期格式时,你可以将其值设置为 UNIX 时间戳,日期字符串( Y-m-d
),日期-时间字符串, Datetime
/ Carbon
实例,日期的值将会自动以正确格式存储到数据库中:
$user = App\User::find(1); $user->disabled_at = Carbon::now(); $user->save();
正如上面提到的,当获取被罗列在 $dates
数组中的属性时,它们会被自动转化为 Carbon
实例,并允许你在属性上使用任何 Carbon
类的方法:
$user = App\User::find(1); return $user->disabled_at->getTimestamp();
日期格式化
默认情况下,时间戳的格式是 'Y-m-d H:i:s'
,如果你需要自定义时间戳格式,在模型中设置 $dateFormat
属性,该属性决定日期属性存储在数据库以及序列化为数组或 JSON 时的格式:
<?php namespace App; use Illuminate\Database\Eloquent\Model; class Flight extends Model { /** * 模型日期的存储格式 * * @var string */ protected $dateFormat = 'U'; }
属性转换
模型中的 $casts
属性为属性字段转换到通用数据类型提供了便利方法 。 $casts
属性是数组格式,其键是要被转换的属性名称,其值时你想要转换的类型。目前支持的转换类型包括: integer
, real
, float
, double
, string
, boolean
, object
, array
, collection
, date
, datetime
和 timestamp
。
例如,让我们转换 is_admin
属性,将其由 integer
值( 0
或 1
)转换为 boolean
值:
<?php namespace App; use Illuminate\Database\Eloquent\Model; class User extends Model { /** * 应该被转化为原生类型的属性 * * @var array */ protected $casts = [ 'is_admin' => 'boolean', ]; }
现在, is_admin
属性在被访问时总是被转换为 boolean
,即使底层存储在数据库中的值是 integer
:
$user = App\User::find(1); if ($user->is_admin) { // }
数组 & JSON 转换
array
类型转换在处理被存储为序列化 JSON 格式的字段时特别有用,例如,如果数据库有一个 JSON
或 TEXT
字段类型包含了序列化 JSON,添加 array
类型转换到该属性将会在 Eloquent 模型中访问其值时自动将其反序列化为 PHP 数组:
<?php namespace App; use Illuminate\Database\Eloquent\Model; class User extends Model { /** * 应该被转化为原生类型的属性 * * @var array */ protected $casts = [ 'options' => 'array', ]; }
类型转换被定义后,访问 options
属性将会自动从 JSON 反序列化为 PHP 数组,反之,当你设置 options
属性的值时,给定数组将会自动转化为 JSON 以供存储:
$user = App\User::find(1); $options = $user->options; $options['key'] = 'value'; $user->options = $options; $user->save();
日期转换
当使用 date
或 datetime
转换类型时,可以指定日期的格式,这个格式会在 模型序列化为数组或JSON时使用
:
/** * The attributes that should be cast to native types. * * @var array */ protected $casts = [ 'created_at' => 'datetime:Y-m-d', ];
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- Eloquent: 修改器
- 使用python编写游戏修改器
- AAAI-17论文提出深度学习C语言修改器DeepFix:用人工智能加「;」
- 不修改模板的前提下修改VisualState中的某些值
- 修改Git已提交的的Author和EMail(批量修改脚本)
- ViewGroup 默认顺序绘制子 View,如何修改?什么场景需要修改绘制顺序?
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
我知道他想看什么
沙建军 / 中信出版社 / 2018-1 / 48.00
社交媒体迅速发展、信息快速迭代、时间碎片化;大数据、智能终端、物联网横空出世;移动支付、网红经济和传统营销失效,这些都让这个时代的媒体、内容、渠道、产品之间的边界越来越模糊,也从根本上改变了营销的逻辑,内容营销从热词变成趋势,变成营销的底层思维。未来一切都是媒体,形式也是内容。 本书作者通过对国内外36个内容营销的新近案例的故事化描述和透彻分析,提出“组织媒介化”“营销内容化”“内容情趣化”......一起来看看 《我知道他想看什么》 这本书的介绍吧!