通知短信+运营短信,5秒速达,支持群发助手一键发送🚀高效触达和通知客户 广告
## 模板输出 模型数据的模板输出可以直接把模型对象实例赋值给模板变量,在模板中可以直接输出,例如: ~~~ <?php namespace app\index\controller; use app\index\model\User; use think\Controller; class Index extends Controller { public function index() { $user = User::find(1); $this->assign('user', $user); return $this->fetch(); } } ~~~ 在模板文件中可以使用 ~~~ {$user.name} {$user.email} ~~~ >[info] 模板中的模型数据输出一样会调用获取器。 ## 数组转换 可以使用`toArray`方法将当前的模型实例输出为数组,例如: ~~~ $user = User::find(1); dump($user->toArray()); ~~~ 支持设置不输出的字段属性: ~~~ $user = User::find(1); dump($user->hidden(['create_time','update_time'])->toArray()); ~~~ 数组输出的字段值会经过获取器的处理,也可以支持追加其它获取器定义(不在数据表字段列表中)的字段,例如: ~~~ $user = User::find(1); dump($user->append(['status_text'])->toArray()); ~~~ 支持设置允许输出的属性,例如: ~~~ $user = User::find(1); dump($user->visible(['id','name','email'])->toArray()); ~~~ 对于数据集结果一样可以直接使用(包括`append`、`visible`和`hidden`方法) ~~~ $list = User::all(); $list = $list->toArray(); ~~~ `V5.1.22+`版本开始,可以在查询之前定义`hidden`/`visible`/`append`方法,例如: ~~~ dump(User::where('id',10)->hidden(['create_time','update_time'])->append(['status_text'])->find()->toArray()); ~~~ 注意,必须要首先调用一次Db类的方法后才能调用`hidden`/`visible`/`append`方法。 ### 追加关联属性 支持追加一对一关联模型的属性到当前模型,例如: ~~~ $user = User::find(1); dump($user->append(['profile' => ['email', 'nickname']])->toArray()); ~~~ `profile`是关联定义方法名,`email`和`nickname`是`Profile`模型的属性。 模型的`visible`、`hidden`和`append`方法支持关联属性操作,例如: ~~~ $user = User::get(1,'profile'); // 隐藏profile关联属性的email属性 dump($user->hidden(['profile'=>['email']])->toArray()); // 或者使用 dump($user->hidden(['profile.email'])->toArray()); ~~~ `hidden`、`visible`和`append`方法同样支持数据集对象。 ## JSON序列化 可以调用模型的`toJson`方法进行`JSON`序列化,`toJson`方法的使用和`toArray`一样。 ~~~ $user = User::get(1); echo $user->toJson(); ~~~ 可以设置需要隐藏的字段,例如: ~~~ $user = User::get(1); echo $user->hidden(['create_time','update_time'])->toJson(); ~~~ 或者追加其它的字段(该字段必须有定义获取器): ~~~ $user = User::get(1); echo $user->append(['status_text'])->toJson(); ~~~ 设置允许输出的属性: ~~~ $user = User::get(1); echo $user->visible(['id','name','email'])->toJson(); ~~~ 模型对象可以直接被JSON序列化,例如: ~~~ echo json_encode(User::get(1)); ~~~ 输出结果类似于: ~~~ {"id":"1","name":"","title":"","status":"1","update_time":"1430409600","score":"90.5"} ~~~ 如果直接`echo` 一个模型对象会自动调用模型的`toJson`方法输出,例如: ~~~ echo User::get(1); ~~~ 输出的结果和上面是一样的。