Documentation

// 新しいインスタンスを取得
$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)
{
	// conditionally add a where clause
	if ($something)
	{
		$query->where('field', '=', $something);
	}
}

// モデルの中で
protected function post_save($result)
{
	// 結果を使って何かをする
	return $result;
}

// モデルの中で
protected function pre_update(&$query)
{
	// 更新クエリを変更。
	$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;
}