模型输出
最后更新于：2022-04-02 01:52:16
## 模板输出
模型数据的模板输出可以直接把模型对象实例赋值给模板变量，在模板中可以直接输出，例如：
~~~
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);
~~~
输出的结果和上面是一样的。
';