## 模板輸出 模型數據的模板輸出可以直接把模型對象實例賦值給模板變量，在模板中可以直接輸出，例如： ~~~ <?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); ~~~ 輸出的結果和上面是一樣的。