Eloquent ORM ―― 调整器.pdf

Eloquent ORM ―― 调整器 Eloquent ORM —— 访问器修改器 1、简介 访问器属性。例如，你可能想要使⽤Laravel加密器对存储在数据库中的数据进⾏加 密，并且在Eloquent 型中访问时⾃动进⾏解密。 除了⾃定义访问器和修改器，Eloquent还可以⾃动转换⽇期字段为Carbon实例甚⾄将 ⽂本转换为JSON 。 2、访问器 修改器 2.1 定义访问器 要定义⼀个访问器，需要在 型中创建⼀个getFooAttribute⽅法，其中Foo是你 想要访问的字段名 （使⽤驼峰式命名规则）。在本例中，我们将会为first_name属 性定义⼀个访问器，该访问器在获取first_name的值时被Eloquent ⾃动调⽤： ?php namespace App; use Illuminate\Database\Eloquent\Model; class ser extends Model{ /** * 获取⽤户的名字 * * @param string $value * @return string */ public function getFirstNameAttribute($value) { return ucfirst($value); } } 正如你所看到的，该字段的原⽣值被传递给访问器，然后返回处理过的值。要访问该 值只需要简单访问first_name即可： $user = App\ ser::find(1); $firstName = $user-first_name; 2.2 定义修改器 要定义⼀个修改器，需要在 型中定义setFooAttribute⽅法，其中Foo是你想要 访问的字段 （使⽤驼峰式命名规则）。接下来让我们为first_name属性定义⼀个修 改器，当我们为 型上的first_name赋值时该修改器会被⾃动调⽤： ?php namespace App; use Illuminate\Database\Eloquent\Model; class ser extends Model{ /** * 设置⽤户的名字 * * @param string $value * @return string */ public function setFirstNameAttribute($value) { $this-attributes[first_name] = strtolower($value); } } 该修改器获取要被设置的属性值，允许你操纵该值并设置Eloquent 型内部属性值为 操作后的值。例如，如果你尝试设置Sally的first_name属性： $user = App\ ser::find(1); $user-first_name = Sally ; 在本例中，setFirstNameAttribute⽅法会被调⽤，传⼊参数为Sally，修改器 会对其调⽤strtolower函数并将处理后的值设置为内部属性的值。 3、⽇期修改器 默认情况下，Eloquent将会转化created_at和updated_at列的值为Carbon实例， 该类继承⾃PHP原⽣的Datetime类，并提供了各种有⽤的⽅法。 你可以⾃定义哪些字段被⾃动调整修改，甚⾄可以通过重写 型中的$dates属性完 全禁⽌调整： ?php namespace App; use Illuminate\Database\Eloquent\Model; class ser extends Model{ /** * 应该被调整为⽇期的属性 * * @var array */ protected $dates = [created_at, updated_at, disabled_at] } 如果字段是⽇期格式时，你可以将其值设置为UNIX 时间戳，⽇期字符串 （Y-m- d），⽇期-时间字符串，Datetime/Carbon实例，⽇期的值将会⾃动以正确格式存 储到数据库中： $user = App\ ser::find(1); $user-disabled_at = Carbo