FuelPHP 系列（三） ------ Model 模型

框架封装好的 model 类有几个，按需继承就好。

有：/fuel/core/classes/model/crud.php

　　/fuel/packages/orm/classes/model.php

　　/fuel/packages/orm/classes/model/soft.php　　包含软删除的相关方法

　　/fuel/packages/orm/classes/model/nestedset.php

　　/fuel/packages/orm/classes/model/temporal.php

　　/fuel/core/classes/model.php

/fuel/packages/orm/classes/ 目录下类功能比较多，所以多数情况选择继承这个目录下的 model。

在 /fuel/app/classes/model/ 目录下，可以直接新建，也可以创建一级目录再新建。注意所有的文件名都要小写（Linux）。

一、创建 model 文件

　　1、在 model 目录下新建 article.php，文件中 Article 类继承 Orm\Model

　　class Model_Article extends Orm\Model{}

　　2、在 model/new/ 目录下新建 tag.php，文件中 New 类继承 Orm\Model_Soft

　　　　oil 命令： php oil g model new/tag name:varchar --no-migration   或  php oil g model new_tag name:varchar --no-migration

　　class Model_New_Tag extends Orm\Model_Soft{}

　　3、在 model 目录下新建 category.php，文件中 Category 类继承 \Model_Crud

　　namespace Model;

　　class Category extends \Model_Crud{}

　　4、在 model/new/ 目录下新建 test.php，文件中 Test 类继承 Orm\Model_Temporal

　　namespace Model\New;

　　class Test extends Orm\Model_Temporal{}

　　如果定义了 namespace 则在控制器中调用 Model 时，需要在 model 类名前面加命名空间或在文件最上面 use 命名空间下的类名。

　　use Model\New\Test;
　　class Controller_Article extends \Controller
　　{
    　　public function action_index()
    　　{
        　　$test = Test::forge();
        }
　　}

二、设置静态属性

　　1、设置表名  protected static $_table_name = 'myarticles';

　　　　如果数据库表名是 model 类名去掉 ‘Model_’ 后的复数形式，则不要要设置。

　　2、设置主键  protected static $_primary_key = array('aid', 'bid');

　　　　如果表中主键为 id 且只有 id ，则不需要设置

　　3、设置表列  protected static $_properties = array('id', 'name', 'create_at', 'update_at');

　　　　也可以设置列属性，数据类型 type、标签 label、验证规则 validation、input 类型 form、默认值 default 等。

　　protected static $_properties = array(
        'id',
        'name' => array(
            'data_type' => 'varchar',
            'label' => 'Article Name',
            'validation' => array('required', 'min_length' => array(3), 'max_length' => array(20)),
            'form' => array('type' => 'text'),
            'default' => 'New article',
        ),
        'gender' => array(
            'data_type' => 'varchar',
            'label' => 'Gender',
            'form' => array('type' => 'select', 'options' => array('m' => 'Male', 'f' => 'Female')),
            'validation' => array('required'),
        ),
        'created_at' => array(
            'data_type' => 'int',
            'label' => 'Created At',
            'form' => array(
                'type' => false, // this prevents this field from being rendered on a form
            ),
        ),
        'updated_at' => array('data_type' => 'int', 'label' => 'Updated At')
    );

　　4、设置数据约束条件

　　protected static $_conditions = array(
  　　'order_by' => array('id' => 'desc'),
  　　'where' => array('del_flg', '!=', 1),
　　);

　　5、设置关联模型  protected static $_has_one, $_belongs_to, $_has_many, $_many_many

　　　　一对一、一对多、反向一对多、多对多

　　6、设置数据库  protected static $_write_connection = 'articles_master_db'; protected static $_connection = 'articles_slave_db';

　　　　在 /fuel/app/config/db.php 文件中配置数据库信息。

　　　　如果数据库设置了主从服务器，实现读写分离，则 $_write_connection 为写数据库，$_connection 为读数据库。

　　　　如果只有一个数据库，则用 $_connection 设置。

　　　　如果有关联模型，则应保证相互关联的模型有相同的读写数据库。

　　7、设置隐藏数据  protected static $_to_array_exclude = array( 'password', 'login_hash', 'salt‘， );

　　　　返回查询的数据时，忽略敏感信息，比如用户密码、加密规则等。

　　8、设置模型事件

　　protected static $_observers = array(
        'Orm\Observer_CreatedAt' => array(
            'events' => array('before_insert'),
            'property' => 'INS_DATE',
            'mysql_timestamp' => false,
        ),
        'Orm\Observer_UpdatedAt' => array(
            'events' => array('before_update'),
            'property' => 'UPD_DATE',
            'mysql_timestamp' => false,
        ),
    );

　　　　关于 observer ，后面会有详细介绍。