Validation 方法 - 类別

// 建立一个新的 Validation 实例
$val = Validation::forge();

// 关联新的 Validation 实例与一个Fieldset，使用 Fieldset 名称
$val = Validation::forge('my_fieldset');

// 关联新的 Validation 实例与一个Fieldset，透过传递 Fieldset 实例
$fieldset = Fieldset::instance('my_fieldset');
$val = Validation::forge($fieldset);

// 取得预设 Fieldset 的 Validation 实例
$val = Validation::instance();

// 取得一个特定 Fieldset 的 Validation 实例
$val = Validation::instance('my_fieldset');

// 取得目前活跃的 Validation 实例
$val = Validation::active();

// 取得目前被验证的栏位
$field = Validation::active_field();

// 取得关联的 Fieldset
$val = Validation::forge('my_fieldset');
$fieldset = $val->fieldset();

// 在不同类型的栏位设定规则
$val->add_field('username', 'Username', 'required|trim|valid_string[alpha,lowercase,numeric]');
$val->add_field('email', 'Email', 'required|trim|valid_email');
$val->add_field('age', 'Age', 'valid_string[numeric]');

// 做为一个阵列
$val->add_field('username', 'Username', array('required', 'trim', 'valid_string[alpha,lowercase,numeric]'));

// 覆写 required 规则讯息
$val->set_message('required', 'You have to fill in your :label so you can proceed');
// ……完成时，设回预设讯息
$val->set_message('required', null);
// 给你建立自订规则的讯息
$val->set_message('custom_rule', 'The :label you entered is previously registered. Please choose another one');

// 覆写需要的规则讯息
$val->set_message('custom_rule', 'The :label you entered is previously registered. Please choose another one');
// ……之后，或在你程式码中的其他地方，取得此讯息
$val->get_message('required', null);

$val->add_callable('myvalidation');

为了完整使用此方法的範例，检查扩充 Validation 类别，以及所需要的类别。

$val->remove_callable('myvalidation');

$val = Validation::forge('article');
$val->add_field('title', 'Title', 'required');

if ( ! $val->run())
{
	foreach ($val->error() as $field => $error)
	{
		echo $error->get_message();
		// Title 栏位是必要且必须包含一个值。
	}
}

$val = Validation::forge('article');
$val->add_field('title', 'Title', 'required');

if ($val->run())
{
	// if something was posted, echo it
	echo $val->input('title');
}

$val = Validation::forge('article');
$val->add_field('title', 'Title', 'required');

if ($val->run())
{
	// if something was posted, echo it
	echo $val->validated('title');
}

$val = Validation::forge('article');
$val->add_field('title', 'Title', 'required');

if ( ! $val->run(array()))
{
	foreach ($val->error() as $field => $error)
	{
		echo $error->get_message();
		// Title 栏位是 required 的并且必须包含一个值。
	}
}

$val = Validation::forge('article');
$val->add_field('title', 'Title', 'required');

if ( ! $val->run(array()))
{
	foreach ($val->error_message() as $field => $message)
	{
		echo $message;
		// Title 栏位是 required 的并且必须包含一个值。
	}
}

$val = Validation::forge('article');
$val->add_field('title', 'Title', 'required');

if ( ! $val->run(array()))
{
	echo $val->show_errors();
}