Model_Crud 方法 - 类別

// 取得一个新实例
$user = Model_User::forge();

// 一个有值的新实例
$user = Model_User::forge(array(
	'name' => 'John',
	'surname' => 'Doe',
	'email' => 'john@doe.org',
));

// 取得一笔 `id` = 2 的资料
$user = Model_User::find_by_pk(2);

if ($user === null)
{
	// 没找到
}
else
{
	// 找到
	echo $user->email;
}

// 取得一笔 `email` = "info@example.com" 的资料
$user = Model_User::find_one_by('email', 'info@example.com');

if ($user === null)
{
	// 没找到
}
else
{
	// 找到
	echo $user->email;
}

// SELECT * FROM `users` WHERE `email` LIKE "%@example.com" LIMIT 5 OFFSET 10
$users = Model_User::find_by('email', '%@example.com', 'like', 5, 10);

// Select * FROM `users` WHERE `name` = "John" AND `surname` LIKE "%Surname%" LIMIT 10
$users = \Model_User::find_by(array(
	'name' => 'John',
	array('surname', 'like', '%Surname%'),
), null, null, 10);

if ($users === null)
{
	// 没找到
}
else
{
	foreach($users as $user)
	{
		// 对 $user 做处理
	}
}

// SELECT * FROM `users` LIMIT 10 OFFSET 20
$users = Model_User::find_all(10, 20);

$users = Model_User::find(array(
	'select' => array('id', 'name', 'email'),
	'where' => array(
		array('name', 'like', '%Name%'),
		'suspended' => 'no',
		array('id', 'in', array(1, 2, 3, 4)),
	),
	'order_by' => array(
		'name' => 'asc',
		'surname' => 'desc',
	),
	'limit' => 10,
	'offset' => 20,
));

$users = Model_User::find(array(
	'where' => array(
		'active' => 'yes',
		'banned' => 'no',
	),
	'order_by' => array('id' => 'desc'),
), 'id');

$users = Model_User::find(function ($query)
{
	return $query->join('roles')
	             ->on('roles.id', '=', 'users.role_id')
	             ->where('roles.name', 'admin');
});

// 在你的模型
protected static function pre_find(&$query)
{
	// 修改查询
	$query->where('active', 'yes');
}

// 在你的模型
protected static function post_find($result)
{
	if ($result !== null)
	{
		// 修改结果阵列
	}

	// 回传结果
	return $result;
}

$user = Model_User::forge()->set(array(
	'name' => 'My Name',
	'surname' => 'My Surname',
));

$user = Model_User::forge()->set(array(
	'name' => 'My Name',
	'surname' => 'My Surname',
));

// 新增使用者
$result = $user->save();

$user = Model_User::find_by_pk(2);

$user->name = 'New Name';

// 更新使用者
$user->save();

// 更新但不执行验证
$user->save(false);

$user = Model_User::find_by_pk(2);
if ($user)
{
	// 删除使用者
	$user->delete();
}

$user = Model_User::forge(array(
	'id' => 3,
	'name' => 'John',
	'surname' => 'Otherdoe',
));

$user->is_new(false);

// 更新
$user->save();

// 计数资料表中的所有纪录
$nbr_of_records = Model_User::count();

// 只计数管理使用者的筛选结果数
$nbr_of_records = Model_User::count('id', true, array('group', '=', 100));

$user = Model_User::find_by_pk(2);
$user->frozen(true);

// 传递冻结物件，没有人可以改变它……

$user->frozen(false);
// 现在你可以再度使用它。

$user = Model_User::find_by_pk(2);
$validation_object = $user->validation();

$model = new Model_User;
$model->set(array(
	'name' => 'John',
	'surname' => 'Doe',
));

if ($model->validates())
{
	// 模型是有效的，跳过验证。
	$model->save(false)
}
else
{
	// 模型是无效的
}

$user = Model_User::find_by_pk(2);
$user_array = $user->to_array();

// 在你的模型
protected function pre_save(&$query)
{
	// 变更查询
	$query->set(array('field' => 'value'));
}

// 在你的模型
protected function post_save($result)
{
	// 对结果做处理
	return $result;
}

// 在你的模型
protected function pre_update(&$query)
{
	// 变更 Update 查询。
	$query->set(array('field' => 'value'));
}

// 在你的模型
protected function post_update($result)
{
	// 对结果做处理
	return $result;
}

// 在你的模型
protected function pre_delete(&$query)
{
	// 对删除查询做处理
}

// 在你的模型
protected function post_delete($result)
{
	// 对结果做处理
	return $result;
}

// 在你的模型
protected function pre_validate($data)
{
	// 对资料做处理
	return $data;
}

// 在你的模型
protected function post_validate($data)
{
	// 对资料做处理
	return $data;
}

// 在你的模型
protected function prep_values($data)
{
	// 对资料做处理
	return $data;
}