集合对象
检测一个集合是否包含一个键(contains)
1
2
|
$roles = User::find(
1
)->roles;
if
($roles->contains(
2
)) {}
|
集合 转 数组 或 JSON(toArray|toJson)
转换
1
2
3
4
|
$roles = User::find(
1
)->roles->toArray();
$roles = User::find(
1
)->roles->toJson();
// 如果一个集合被转换为一个字符串,它将以JSON格式返回
$roles = (string) User::find(
1
)->roles;
|
在转换中隐藏部分字段
1
2
3
4
5
6
|
class
User
extends
Eloquent {
// 黑名单
protected
$hidden = array(
'password'
);
// 白名单
protected
$visible = array(
'first_name'
,
'last_name'
);
}
|
在转换中包含虚构的字段
1
2
3
4
5
6
7
|
// 将虚构字段写入白名单
protected
$appends = array(
'is_admin'
);
// 定义虚构字段的访问器(见下文)
public
function getIsAdminAttribute()
{
return
$
this
->attributes[
'admin'
] ==
'yes'
;
}
|
遍历和过滤集合(each|filter)
1
2
|
$roles = $user->roles->each(function($role){});
$roles = $user->roles->filter(function($role){});
|
根据一个值排序集合
1
2
3
4
|
$roles = $roles->sortBy(function($role)
{
return
$role->created_at;
});
|
使用自定义集合类,重写 newCollection 函数
1
2
3
4
5
6
|
class
User
extends
Eloquent {
public
function newCollection(array $models = array())
{
return
new
CustomCollection($models);
}
}
|
访问器和调整器
定义一个访问器(getXxxAttribute)
1
2
3
4
5
6
7
|
class
User
extends
Eloquent {
// 定义 first_name 字段的访问器
public
function getFirstNameAttribute($value)
{
return
ucfirst($value);
}
}
|
定义一个调整器(setXxxAttribute)
1
2
3
4
5
6
|
class
User
extends
Eloquent {
public
function setFirstNameAttribute($value)
{
$
this
->attributes[
'first_name'
] = strtolower($value);
}
}
|
指定哪些字段使用日期调整器(getDates)
1
2
3
4
|
public
function getDates()
{
return
array(
'created_at'
);
}
|
模型事件
可用事件
creating
created
创建
updating
updated
更新
saving
saved
创建 & 更新
deleting
deleted
删除
注意: 事件函数中若返回 false
则表示取消本事件。
模型外注册事件
1
2
3
4
5
|
User::creating(function($user)
{
// 若无效,则取消创建
if
( ! $user->isValid())
return
false
;
});
|
模型内设置事件绑定
1
2
3
4
5
6
7
8
|
class
User
extends
Eloquent {
public
static
function boot()
{
// 必须先继承原生引导方法 boot
parent::boot();
// 接下来开始设置事件绑定
}
}
|
模型观察者(将一系列的模型事件注册,写入有一个类中)
创建模型观察者
1
2
3
4
|
class
UserObserver {
public
function saving($model){}
public
function saved($model){}
}
|
注册模型观察者实例(observe)
1
|
User::observe(
new
UserObserver);
|