模型輸出 · thinkphp5

# 模型輸出 ## 模板輸出模型數據的模板輸出可以直接把模型對象實例賦值給模板變量，在模板中可以直接輸出，例如： ``` <?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} ``` > 模板中的模型數據輸出一樣會調用獲取器。 ## 數組轉換可以使用`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(); ``` ### 追加關聯屬性支持追加一對一關聯模型的屬性到當前模型，例如： ``` $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); ``` 輸出的結果和上面是一樣的。