获取器

获取器的作用是对模型实例的(原始)数据做出自动处理。
获取器对应模型的特殊方法 方法格式为:

getFieldNameAttr

FieldName为数据表字段的驼峰转换
定义了获取器之后会在下列情况自动触发:

  • 模型的数据对象取值操作($model->field_name);

  • 模型的序列化输出操作($model->toArray()toJson());

  • 显式调用getAttr方法($this->getAttr('field_name'));

获取器的场景

  • 时间日期字段的格式化输出;

  • 集合或枚举类型的输出;

  • 数字状态字段的输出;

  • 组合字段的输出;

需要对状态值转换

<?php
class User extends Model {
public function getStatusAttr($value){
        $status = [-1=>'删除',0=>'禁用',1=>'正常',2=>'待审核'];
        return $status[$value];
    }
}

数据表的字段自动转换为驼峰法
一般status字段的值采用数值类型
可通过获取器定义 自动转换为字符串描述

$user = User::get(1);
echo $user->status; // 例如输出“正常”

获取器可定义数据表中不存在的字段

<?phpclass User extends Model {
public function getStatusTextAttr($value,$data){
        $status = [-1=>'删除',0=>'禁用',1=>'正常',2=>'待审核'];
        return $status[$data['status']];
    }
}

获取器方法的第二个参数传入的是当前的所有数据数组。

就可以直接使用status_text字段的值了 例如:

$user = User::get(1);
echo $user->status_text; // 例如输出“正常”

获取原始数据

如果定义了获取器的情况下 希望获取数据表中的原始数据

$user = User::get(1);// 通过获取器获取字段
echo $user->status;// 获取原始字段数据
echo $user->getData('status');// 获取全部原始数据
dump($user->getData());