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);