框架封装好的 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 ，后面会有详细介绍。