集合对象
检测一个集合是否包含一个键(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);