简单的示例

这是一个 单模型的 ORM 使用范例, 没有实用关系, 但是用了字段的验证.

数据表结构

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

模型

  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('regex', array(':value', '/^[-\pL\pN_.]++$/uD')),
  13.             ),
  14.             'first_name' => array(
  15.                 array('not_empty'),
  16.                 array('min_length', array(':value', 4)),
  17.                 array('max_length', array(':value', 32)),
  18.                 array('regex', array(':value', '/^[-\pL\pN_.]++$/uD')),
  19.             ),
  20.             'last_name' => array(
  21.                 array('not_empty'),
  22.                 array('min_length', array(':value', 4)),
  23.                 array('max_length', array(':value', 32)),
  24.                 array('regex', array(':value', '/^[-\pL\pN_.]++$/uD')),
  25.             ),
  26.             'email' => array(
  27.                 array('not_empty'),
  28.                 array('min_length', array(':value', 4)),
  29.                 array('max_length', array(':value', 127)),
  30.                 array('email'),
  31.             ),
  32.         );
  33.     }
  34. }

[!!] 当你使用 ORM::save() 时, 将触发 ORM::rules()，ORM::rules() 将一个数组结果 传递到一个 [Validation] 对象来对字段进行验证 .

[!!] 请注意 在模型中定义主键 id 并不是必须的。 并且 数据库中的表名 是 复数 和 模型的名称 是 奇异。

控制器

  1. <?php defined('SYSPATH') or die('No direct access allowed.');
  3. class Controller_Member extends Controller_Template {
  5.     public function action_index()
  6.     {
  7.         /**
  8.          * 范例一
  9.          */
  11.         // 创建一个 `member` 的模型接口
  12.         $members = ORM::factory('member');
  14.         // 获得所有 `first name` 是 "Peter" 的结果
  15.         // find_all() 意思就是找到所有符合条件的结果。
  16.         $members->where('first_name', '=', 'Peter')->find_all();
  18.         // 获得 $members 对象中的 记录数量
  19.         $members->count_all();
  21.         /**
  22.          * 范例二
  23.          */
  25.         // 创建一个 `member` 的模型接口
  26.         $member = ORM::factory('member');
  28.         // 获得一个 `user name` 是 "bongo" 的 成员记录 find() 的意思是
  29.         // 我们只获得第一个匹配的记录.
  30.         $member->where('username', '=', 'bongo')->find();
  32.         /**
  33.          * 范例三
  34.          */
  36.         // 创建一个 `member` 的模型接口
  37.         $member = ORM::factory('member');
  39.         // 执行 一个 `INSERT` 查询
  40.         $member->username = 'bongo';
  41.         $member->first_name = 'Peter';
  42.         $member->last_name = 'Smith';
  43.         $member->save();
  45.         /**
  46.          * 范例四
  47.          */
  49.         // 创建一个 `member`表中的 "id" 列的值 等于 1 的模型接口
  50.         $member = ORM::factory('member', 1);
  52.         // 执行 更新 操作
  53.         $member->username = 'bongo';
  54.         $member->first_name = 'Peter';
  55.         $member->last_name = 'Smith';
  56.         $member->save();
  57.     }
  58. }

[!!] 如果要访问 模型的列值 ，可以想访问 PHP 对象一样使用 $member->first_name 。