FuelPHP 系列(三) ------ Model 模型

时间:2023-03-08 15:39:08

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