Eloquent ORM —— 序列化

Eloquent ORM —— 序列化

Eloquent ORM —— 序列化

项目相关


1、简介

当构建JSON API时,经常需要转化模型和关联关系为数组或JSON。Eloquent包含便捷方法实现这些转换,以及控制哪些属性被包含到序列化中。

2、基本使用

2.1 转化模型为数组

要转化模型及其加载的关联关系为数组,可以使用toArray方法。这个方法是递归的,所以所有属性及其关联对象属性(包括关联的关联)都会被转化为数组:

	
  1. $user = App\User::with('roles')->first();
  2. return $user->toArray();

还可以转化集合为数组:

	
  1. $users = App\User::all();
  2. return $users->toArray();

2.2 转化模型为JSON

要转化模型为JSON,可以使用toJson方法,和toArray一样,toJson方法也是递归的,所有属性及其关联属性都会被转化为JSON:

	
  1. $user = App\User::find(1);
  2. return $user->toJson();

你还可以转化模型或集合为字符串,这将会自动调用toJson方法:

	
  1. $user = App\User::find(1);
  2. return (string) $user;

由于模型和集合在转化为字符串的时候会被转化为JSON,你可以从应用的路由或控制器中直接返回Eloquent对象:

	
  1. Route::get('users', function () {
  2. return App\User::all();
  3. });

3、在JSON中隐藏属性显示

有时候你希望在模型数组或JSON显示中限制某些属性,比如密码,要实现这个,在定义模型的时候添加一个$hidden属性:

	
  1. <?php
  2. namespace App;
  3. use Illuminate\Database\Eloquent\Model;
  4. class User extends Model{
  5. /**
  6. * 在数组中隐藏的属性
  7. *
  8. * @var array
  9. */
  10. protected $hidden = ['password'];
  11. }

注意:如果要隐藏关联关系,使用关联关系的方法名,而不是动态属性名。

此外,可以使用visible属性定义属性显示的白名单:

	
  1. <?php
  2. namespace App;
  3. use Illuminate\Database\Eloquent\Model;
  4. class User extends Model{
  5. /**
  6. * 在数组中显示的属性
  7. *
  8. * @var array
  9. */
  10. protected $visible = ['first_name', 'last_name'];
  11. }

4、追加值到JSON

有时候,需要添加数据库中没有相应的字段到数组中,要实现这个,首先要定义一个访问器:

	
  1. <?php
  2. namespace App;
  3. use Illuminate\Database\Eloquent\Model;
  4. class User extends Model{
  5. /**
  6. * 为用户获取管理员标识
  7. *
  8. * @return bool
  9. */
  10. public function getIsAdminAttribute()
  11. {
  12. return $this->attributes['admin'] == 'yes';
  13. }
  14. }

定义好访问器后,添加字段名到模型的appends属性:

	
  1. <?php
  2. namespace App;
  3. use Illuminate\Database\Eloquent\Model;
  4. class User extends Model{
  5. /**
  6. * 追加到模型数组表单的访问器
  7. *
  8. * @var array
  9. */
  10. protected $appends = ['is_admin'];
  11. }

字段被添加到appends列表之后,将会被包含到模型数组和JSON表单中,appends数组中的字段还会遵循模型中的visible和hidden设置配置。

本博客所有文章如无特别注明均为原创。作者:长颈鹿复制或转载请以超链接形式注明转自 SZY
原文地址《Eloquent ORM —— 序列化

相关推荐

发表评论

路人甲 表情
Ctrl+Enter快速提交

网友评论(0)