php中添加访问器,访问器&修改器 | Eloquent模型 | Laravel 5.1 中文文档

访问器&修改器

由 学院君 创建于5年前, 最后更新于 11个月前

版本号 #2

20493 views

9 likes

0 collects

1、简介

访问器和修改器允许你在获取模型属性或设置其值时格式化Eloquent属性。例如，你可能想要使用Laravel加密器对存储在数据库中的数据进行加密，并且在Eloquent模型中访问时自动进行解密。

除了自定义访问器和修改器，Eloquent还可以自动转换日期字段为Carbon实例甚至将文本转换为JSON。

2、访问器 & 修改器

2.1 定义访问器

要定义一个访问器，需要在模型中创建一个getFooAttribute方法，其中Foo是你想要访问的字段名(使用驼峰式命名规则)。在本例中，我们将会为first_name属性定义一个访问器，该访问器在获取first_name的值时被Eloquent自动调用：

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;

2.2 定义修改器

要定义一个修改器，需要在模型中定义setFooAttribute方法，其中Foo是你想要访问的字段(使用驼峰式命名规则)。接下来让我们为first_name属性定义一个修改器，当我们为模型上的first_name赋值时该修改器会被自动调用：

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函数并将处理后的值设置为内部属性的值。

3、日期修改器

默认情况下，Eloquent将会转化created_at和updated_at列的值为Carbon实例，该类继承自PHP原生的Datetime类，并提供了各种有用的方法。

你可以自定义哪些字段被自动调整修改，甚至可以通过重写模型中的$dates属性完全禁止调整：

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)，日期-时间字符串，Carbon/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();

如果你需要自定义时间戳格式，在模型中设置$dateFormat属性，该属性决定日期属性将以何种格式存储在数据库中、以及序列化为数组或JSON时的格式：

namespace App;

use Illuminate\Database\Eloquent\Model;

class Flight extends Model{

/**

* 模型日期的存储格式

*

* @var string

*/

protected $dateFormat = 'U';

}

4、属性转换

模型中的$casts属性提供了便利方法转换属性到通用数据类型。$casts属性是数组格式，其键是要被转换的属性名称，其值时你想要转换的类型。目前支持的转换类型包括：integer, real, float, double, string, boolean, object和array。

例如，让我们转换is_admin属性，将其由integer类型转换为boolean类型：

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) {

//

}

4.1 数组转换

array类型转换在处理被存储为序列化JSON的字段是特别有用，例如，如果数据库有一个TEXT字段类型包含了序列化JSON，添加array类型转换到该属性将会在Eloquent模型中访问其值时自动将其反序列化为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();