TP5 Model function summary

//设置自动完成的字段，支持键值对数组和索引数组

 //新增和更新时都会使用

 //如：['name'=>'zhangsan','sex'=>'男']

 // ['name','sex']

 protected $auto = [];    //新增 自动完成列表

 //只在新增数据的时候使用

 protected $insert = [];    //更新 自动完成列表

 //只在更新数据的时候使用

 protected $update = [];    //用来标记当前操作被修改的字段

 //如 ['name','sex']

 protected $change = [];    //依赖方法,model类会自动调用解析auto数组

 //我们只需配置auto数组即可

 protected function autoCompleteData($auto = []){}

//是否需要自动写入时间戳

 //可以是字符串类型和boolean类型

 //字符串类型代表要写入的时间格式

 //如： 'Y-m-d H:i:s'

 //boolean类型就是true和false，代表是否开启

 //默认时间格式为int类型

 protected $autoWriteTimestamp;    //默认自动写入的字段有

 //创建时间和更新时间，他们对应的字段名分别是

 //create_time,和update_time

 //也可以在model里自己设置。

 protected $createTime = 'create_time';    protected $updateTime = 'update_time';

'auto_timestamp' => true

 //或者设置时间格式

 // 'auto_timestamp' => 'datatime'

protected $autoWriteTimestamp = true;    //或者设置时间格式

 // protected $autoWriteTimestamp = 'datatime';

//如：

 protected $createTime = 'my_create_time_filed';   

 protected $updateTime = 'my_careate_time_field';

//如

 protected $updateTime = false;123

//输出格式

 protected $dateFormat;123

'datetime_format' => 'Y/m/d H:i',12

protected $dateFormat = 'Y/m/d H:i';12

//字段验证规则

 protected $validate = [];    //是否采用批量验证

 protected $batchValidate = false;    /**

  * 设置字段验证

  * @access public

  * @param array|string|bool $rule  验证规则 true表示自动读取验证器类

  * @param array             $msg   提示信息

  * @param bool              $batch 批量验证

  * @return $this

  */

 public function validate($rule = ture,$msg=[],$bath=false){}    /**

  * 自动验证数据

  * @access protected

  * @param array $data  验证数据

  * @param mixed $rule  验证规则

  * @param bool  $batch 批量验证

  * @return bool

  */

 public function validateData($data,$rule=null,$batch=null){}

protected $validate = [       

        'rule' => [           

                'name' => 'require',           

                //多个规则可以是用字符串用|分隔

           //也可以使用数组['require','number','min'=>10,'max'=>80]

           //使用字符串配置要被使用explode('|',$rule)转化成数组，所以使用数组配置效率更高

           'age' => 'require|number|min:10|max:80',           

           'height' => 'between:100,200'

        ],       

       'msg' => [           

             'name' => 'name不能为空',           

             'age.require' => 'age不能没空',           

             'age.number' => 'age必须是一个数字',           

             'age.min' => 'age最小为10',           

             'age.max' => 'age最大为80',           

             'height' => 'height只能在100到200之间'

        ]

    ];

//在类的头部，因为Validate文件。

 use think\Validate;   

 $validate = new Validate([    

    'name' => 'require',   

    'age' => 'require|number|min:10|max:80'

 ],[       

       'name' => 'name不能为空',       

       'age.require' => 'age不能没空',       

       'age.number' => 'age必须是一个数字',       

       'age.min' => 'age最小为10',       

       'age.max' => 'age最大为80',

 ]);   

 //使用check检查数据

 if($validate->check($data)){    

    echo '数据格式符合要求';

 }else{     

       //比如：name不能为空

     echo $validate->getError();

 }

// 关联对象

 protected $relation;    // 关联自动写入(关联的属性名)

 protectd $relationWrite = [];

//用来保护那些不许要被更新的字段。

 //比如，创建时间

 //设置后再更新数据时，会字段过滤掉create_time字段

 //避免更新到数据库。

 protected $readonly = ['create_time'];

//设置要隐藏的字段，

//该设置只在toArray(),和subToArray()方法中起作用

protected $hidden = [];    //相关方法

public function hidden($hidden=[],$override=false){

}

//user表的属性字段（模拟操作）

user_field = ['name','sex','age','height'];

protected $hidden = ['age','height'];

 dump($User->toArray()); //只有name和sex字段。

 //也可以调用hidden方法隐藏字段

 //会有 name,age,height 三个字段

 dump($User->hidde(['sex'])->toArray());

 //只有name字段了

 //第二个参数标识是否合并 $this->hidden

 dump($user->hidden(['sex'],true)->toArray());

//支持给一个位置注册多个事件   

 User::event('before_insert',function($user){       

     if($user->status != 1){           

         return false;       

     }   

 });   

  //这个也会生效，回到函数为beforeInsert   

User::event('before_insert','beforeInsert');

//使用init方法统一注册模型事件

 class User extends Model{

     protected static function init(){

         User::event('before_insert',function($user){

             if($user->status != 1){                   

                 return false;

             }

         }           

         //注册第二个事件

         User::event('before_insert','beforeInsert');

     }

 }

$event = [       

       //模型名称

     'user' => [           

           //事件名称

         'before_insert' => ['callback_funciton','beforeInsert'],           

         'after_insert' => ['callback_function','afterInsert'],           

         'before_delete' => ['beforeDelete']

     ]

 ]

namespace app\index\model;   

use think\Model;   

use think\model\SoftDelete;   

class User extends Model{

     // 使用SoftDelete

     // trait 的使用方式

     // 使用trait跟类的继承相似

     use SoftDelete;       

     //软删除标记的字段名

     protected $deleteTime = 'delete_time';

 }

//软删除

 User::destory(1);   

 //真删除

 User::destory(1,true);   

 //软删除

 $user = User::get(1);   

 $user->delete();   

 //真删除

 $user->delete(true);

User::withTrashed()->find();

User::withTrashed()->select();

User::onlyTranshed()->find();

User::onlyTranshed()->select();

class User extends Model{

     protected $type = [           

         'status' => 'integer',           

         'score' => 'float',           

         'login_timme' => 'datetime',           

         'info' => 'array'

     ];

 }

$user = new User;   

 $user->status = '1';   

 $user->score = '90.50';   

 $user->birthday = '2015/5/1';   

 $user->info = ['a'=>1,'b'=>2];   

 $user->save();

 var_dump($user->status); // int 1

 var_dump($user->score); // float 90.5;

 var_dump($user->birthday); // string '2015-05-01 00:00:00'

 var_dump($user->info);// array (size=2) 'a' => int 1  'b' => int 2

class User extends Model{

     protected $dataFormat = 'Y/m/d';       

     protected $type = [           

         'status' => 'integer',           

         'score' => 'float',           

         'birthday' => 'timestemp'//时间戳格式

     ];

 }

class User extends Model{       

    protected $type = [           

        'status' => 'integer',           

        'socre' => 'float',           

        'birthday' => 'timestemp:Y/m/d'//写入时间戳，读取按照Y/m/d的格式来格式化输出。       

    ];

   }