Validation Example

验证实例

本实例将会创建用户帐号并演示如何操作模型和控制器进行验证。我们首先创建一个处理后的form表单，并提示部分错误给用户。我们假定 Model_User 类已经包含一个名为 hash_password 的用于将明文转为密文的方法。如果您欲使明文加密方法超出该该实例中的加密范围，您可考虑使用Authentication库。 原文

SQL schema

  1. CREATE TABLE IF NOT EXISTS `members` (
  2.   `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  3.   `username` varchar(32) NOT NULL,
  4.   `password` varchar(100) NOT NULL,
  5.   PRIMARY KEY (`id`)
  6. ) ENGINE=InnoDB  DEFAULT CHARSET=utf8 AUTO_INCREMENT=1;

Model

  1. <?php defined('SYSPATH') or die('No direct access allowed.');
  3. class Model_Member extends ORM {
  5.     public function rules()
  6.     {
  7.         return array(
  8.             'username' => array(
  9.                 array('not_empty'),
  10.                 array('min_length', array(':value', 4)),
  11.                 array('max_length', array(':value', 32)),
  12.                 array(array($this, 'username_available')),
  13.             ),
  14.             'password' => array(
  15.                 array('not_empty'),
  16.             ),
  17.         );
  18.     }
  20.     public function filters()
  21.     {
  22.         return array(
  23.             'password' => array(
  24.                 array(array($this, 'hash_password')),
  25.             ),
  26.         );
  27.     }
  29.     public function username_available($username)
  30.     {
  31.         // There are simpler ways to do this, but I will use ORM for the sake of the example
  32.         return ORM::factory('member', array('username' => $username))->loaded();
  33.     }
  35.     public function hash_password($password)
  36.     {
  37.         // Do something to hash the password
  38.     }
  39. }

HTML Form

请忽略我这简陋的form表单，我只是不想尝试使用任何模块和不相干的方法。 :) 原文

  1. <form action="<?= URL::site('/members'); ?>" method="post" accept-charset="utf-8">
  2.     <label for="username">Username:</label>
  3.     <input id="username" type="text" name="username" value="<?= Arr::get($values, 'username'); ?>" />
  4.     <label for="username" class="error"><?= Arr::get($errors, 'username'); ?>
  6.     <label for="password">Password:</label>
  7.     <input id="password" type="password" name="password" value="<?= Arr::get($values, 'password'); ?>" />
  8.     <label for="password" class="error"><?= Arr::get($errors, 'password'); ?>
  10.     <label for="password_confirm">Repeat Password:</label>
  11.     <input id="password_confirm" type="password" name="_external[password_confirm]" value="<?= Arr::path($values, '_external.password_confirm'); ?>" />
  12.     <label for="password_confirm" class="error"><?= Arr::path($errors, '_external.password_confirm'); ?>
  14.     <button type="submit">Create</button>
  15. </form>

Controller

[!!] 切忌， password 会在被模型赋值时候进行加密，由于此原因，有必要进字符长度、 password_confirm 匹配的验证。由于模型不进行 password_confirm 列的验证，因此我们需要在controller中增加简单逻辑，并将错误信息存入一个数组。阅读 filters 文档，了解如何工作。 原文

  1. public function action_create()
  2. {
  3.     $view = View::factory('members/create')
  4.         ->set('values', $_POST)
  5.         ->bind('errors', $errors);
  7.     if ($_POST)
  8.     {
  9.         $member = ORM::factory('member')
  10.             // The ORM::values() method is a shortcut to assign many values at once
  11.             ->values($_POST, array('username', 'password'));
  13.         $external_values = array(
  14.             // The unhashed password is needed for comparing to the password_confirm field
  15.             'password' => Arr::get($_POST, 'password'),
  16.         // Add all external values
  17.         ) + Arr::get($_POST, '_external', array());
  18.         $extra = Validation::factory($external_values)
  19.             ->rule('password_confirm', 'matches', array(':validation', ':field', 'password'));
  21.         try
  22.         {
  23.             $member->save($extra);
  24.             // Redirect the user to his page
  25.             $this->request->redirect('members/'.$member->id);
  26.         }
  27.         catch (ORM_Validation_Exception $e)
  28.         {
  29.             $errors = $e->errors('models');
  30.         }
  31.     }
  33.     $this->response->body($view);
  34. }

Messages

application/messages/models/member.php

  1. return array(
  2.     'username' => array(
  3.         'not_empty' => 'You must provide a username.',
  4.         'min_length' => 'The username must be at least :param2 characters long.',
  5.         'max_length' => 'The username must be less than :param2 characters long.',
  6.         'username_available' => 'This username is not available.',
  7.     ),
  8.     'password' => array(
  9.         'not_empty' => 'You must provide a password.',
  10.     ),
  11. );

application/messages/models/member/_external.php

  1. return array(
  2.     'password_confirm' => array(
  3.         'matches' => 'The password fields did not match.',
  4.     ),
  5. );