15. Laravel 4 Eloquent 高级应用

集合对象

检测一个集合是否包含一个键（contains）

$roles = User::find(1)->roles;
if ($roles->contains(2)) {}

集合 转 数组 或 JSON（toArray|toJson）

$roles = User::find(1)->roles->toArray();
$roles = User::find(1)->roles->toJson();
// 如果一个集合被转换为一个字符串，它将以JSON格式返回
$roles = (string) User::find(1)->roles;

class User extends Eloquent {
// 黑名单
protected $hidden = array('password');
// 白名单
protected $visible = array('first_name', 'last_name');
}

// 将虚构字段写入白名单
protected $appends = array('is_admin');
// 定义虚构字段的访问器（见下文）
public function getIsAdminAttribute()
{
return $this->attributes['admin'] == 'yes';
}

遍历和过滤集合（each|filter）

$roles = $user->roles->each(function($role){});
$roles = $user->roles->filter(function($role){});

根据一个值排序集合

$roles = $roles->sortBy(function($role)
{
return $role->created_at;
});

使用自定义集合类，重写 newCollection 函数

class User extends Eloquent {
public function newCollection(array $models = array())
{
return new CustomCollection($models);
}
}

访问器和调整器

定义一个访问器（getXxxAttribute）

class User extends Eloquent {
// 定义 first_name 字段的访问器
public function getFirstNameAttribute($value)
{
return ucfirst($value);
}
}

定义一个调整器（setXxxAttribute）

class User extends Eloquent {
public function setFirstNameAttribute($value)
{
$this->attributes['first_name'] = strtolower($value);
}
}

指定哪些字段使用日期调整器（getDates）

public function getDates()
{
return array('created_at');
}

模型事件

可用事件

creating

created

updating

updated

saving

saved

deleting

deleted

false

模型外注册事件

User::creating(function($user)
{
// 若无效，则取消创建
if ( ! $user->isValid()) return false;
});

模型内设置事件绑定

class User extends Eloquent {
public static function boot()
{
// 必须先继承原生引导方法 boot
parent::boot();
// 接下来开始设置事件绑定
}
}

模型观察者（将一系列的模型事件注册，写入有一个类中）

创建模型观察者

class UserObserver {
public function saving($model){}
public function saved($model){}
}

注册模型观察者实例（observe）

User::observe(new UserObserver);