#1 jake

spDB是SpeedPHP 3以上版本中引入的一个核心函数，可简化spModel子类的数据库操作。
在SpeedPHP 2时代，开发者反馈在日常的数据库CRUD操作中，如果该模型类不需要覆盖一些操作或者没有进行复杂的数据操作（如分页，关联等），只是简单地进行CRUD操作或者SQL查询，那么在model目录中建立一个model类的文件是重复的而类似鸡肋的操作。所以在SpeedPHP 3中提供了spDB，可以在不存在model类文件的情况下，直接对某个表进行简单CRUD操作或SQL操作，简化了日常工作。
spDB的使用

spDB的使用类似spClass对模型类实例化的操作一样。如：

$g = spClass('m_guestbook'); // 实例化m_guestbook模型类

$result = $g->findAll();

$g->create($this->spArgs());

简化一下：

$result = spClass('m_guestbook')->findAll();

spClass('m_guestbook')->create($this->spArgs());

使用spDB

$result = spDB('tbl_guestbook')->findAll(); // 注意这里用的是tbl_guestbook，表的全名

spDB('tbl_guestbook')->create($this->spArgs());

spDB支持spModel的函数操作有：

  • find
  • findAll
  • create
  • update
  • delete
  • createAll
  • findBy
  • updateField
  • affectedRows
  • findCount
  • replace
  • incrField
  • decrField
  • deleteByPk
  • findSql
  • runSql
  • dumpSql
  • escape

也就是spDB可以支持spModel类的大部分基础成员函数。

spDB的限制（不支持的操作）

  • spPager
  • spLinker
  • spCache
  • spVerifier
  • 成员变量的赋值
spDB的使用建议

  • 在只需要简单的spModel函数操作的时候，可以使用spDB。
  • 在该模型类在目前或将来有可能需要覆盖父类操作或者进行spPager等操作的时候，不建议使用spDB。
  • 在数据库表主键或表名比较混乱的时候（比如有两个主键）的情况，不建议使用spDB。
  • 在使用spDB出现错误的时候，建议建立模型类看看是否能够解决问题。
使用spDB的注意点：spDB('表全名或表名', ['表主键'])

  • 第一个参数：spDB的第一个参数默认是“表全名”，受配置“db_spdb_full_tblname”影响。当“db_spdb_full_tblname”为FALSE的时候，可以仅输入“表名”，框架将自动加上表前缀。
  • 第二个参数：可选的主键。默认不需要输入主键，使用数据库驱动类getTable操作获得的第一个字段作为主键———这在大部分数据表设计中都是正确的。如果开发者的数据库表第一个字段并非主键（其他字段才是主键，或没有主键）的情况下，那么spDB就需要输入第二个参数（字段名）作为主键来进行操作。


2012-08-04 16:52:56