简介
当构建 JSON API 时,经常需要转化模型和关联关系为数组或 JSON。
Eloquent 提供了便捷方法以便实现这些转换,还可以控制哪些属性被包含到序列化中。
转化为数组
想要转化模型及其加载的关联关系为数组,可以使用 toArray 方法。
toArray 方法是递归的,所有属性及其关联对象属性(包括关联的关联)都会被转化为数组。
$user = App\User::with('roles')->first();
return $user->toArray();
还可以转化整个模型集合为数组:
$users = App\User::all();
return $users->toArray();
转化为 JSON
要转化模型为 JSON,可以使用 toJson 方法,toJson 方法也是递归的,所有属性及其关联属性都会被转化为 JSON。
$user = App\User::find(1);
return $user->toJson();
你还可以转化模型或集合为字符串,这将会自动调用 toJson 方法:
$user = App\User::find(1);
return (string) $user;
由于模型和集合在转化为字符串的时候会被转化为 JSON,你可以从应用的路由或控制器中直接返回 Eloquent 对象: