小乐的博客

class User extends Model
{
    #以下属性和方法都不是必须的，但是一般都要按需求定义一些

    //定义关联的表名，不定义的话默认此模型关联的表为 模型名s (users)
    protected $table = 'user';

    /******字段相关*******/
    #定义主键字段名，默认是id
    protected $primaryKey = 'uid';
    #定义字段白名单，允许操作表中的哪些字段
    protected $fillable = ['uid','name'];
    #定义字段黑名单，不允许操作表中哪些字段
    protected $guarded = [];
    //1、使用model::create([])等方法直接对orm对象操作使，必须定义$guarded或者$fillable
    //2、使用$m = new model();然后$m->save()的方式不需要定义
    //3、简便的方式就是定义$fillable = [];

    #定义隐藏的字段
    protected $hidden = [];

    /******时间管理******/
    #定义是否默认维护时间，默认是true.改为false，则以下时间相关设定无效
    public $timestamps = true;
    #定义数据行创建时间和修改时间的字段名称。默认created_at,updated_at,没有设null
    const CREATED_AT = 'created';
    const UPDATED_AT = null;

    #此属性决定插入和取出数据库的格式，默认datetime格式，'U'是int(10)
    protected $dateFormat = 'U';
    //如果不设置,无论存储格式是datetime还是int，则取出时是Carbon对象
    //Carbon对象返给前端时自动变为datetime字符串，后端谨慎处理

    #如果数据库存的是datetime或者没定义$dateFormat，又想取出的时候是int...
    public function getDates(){
        return ['created_at'];
    }
    //这里只能是created_at，updated_at，不是你自己的字段

    #软删除字段deleted_at
    use Illuminate\Database\Eloquent\SoftDeletes;
    protected $dates = ['deleted_at'];
    #查询数据时会自动排除掉deleted_at非null的数据，若向带上使用User::withTrashed()
    #删除某条数据时使用$user->delete()然后save()即可。deleted_at由null变为时间.

    /******序列化******/
    #toArray和toJson就是序列化方法，都是递归的。

    #把ORM查询的数据自动转换。例如把int转boolean，时间戳转时间，json转成数组等。
    protected $casts = [
        'created'   => 'date:Y-m-d',
        'updated'   => 'datetime:Y-m-d H:i',
        'jsonData'  => 'array',
        'intSwitch' => 'boolean'
    ];
    //关于这个时间的序列化，当作为接口返回的时候有效，如果直接直接页面渲染无效.
    //时间序列化，当$timestamp为true时，无论是update还是new的方式插入新数据，都要是datetime
    //注意取出的jsonData即是数组，而插入jsonData时也得是数组，不要json_encode

    /**自定义数据返回***/
    #再如果，你想拿出来就是'2018/08/08 12:00'这种自定义格式,好比'sa_time'
    public function getSaTimeAttribute($value){
        return date('Y/m/d H:i',$value);
    }
    //注意方法名是根据字段来的。同理，这种方法可以处理任何字段

    //getxxAttribute 在获取xx属性的时候  $obj->xx 会转化  
    //setxxAttribute 在设置(sql: insert update) 的时候 会将$obj->xx = 'value'的时候, 操作数据库之前 自动转化一下

    //存入之前的改变
    public function setFirstNameAttribute($value)
    {
        $this->attributes['first_name'] = strtolower($value);
    }  

    //laravel 增加不存在数据库的字段
    //有时候您可能想要增加不存在数据库字段的属性数据。这时候只要定义一个获取器即可：
    public function getIsAdminAttribute()
    {
          return $this->attributes['admin'];
    }
    //定义好获取器之后，再把对应的属性名称加到模型里的 appends 属性：
    protected $appends = ['is_admin'];

}