编辑“SpeedPHP/简化操作spDB”

{{SpeedPHP top}}
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的函数操作==
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的使用建议==
1.在只需要简单的spModel函数操作的时候，可以使用spDB。

2.在该模型类在目前或将来有可能需要覆盖父类操作或者进行spPager等操作的时候，不建议使用spDB。

3.在数据库表主键或表名比较混乱的时候（比如有两个主键）的情况，不建议使用spDB。

4.在使用spDB出现错误的时候，建议建立模型类看看是否能够解决问题。

==使用spDB的注意点==
1.第一个参数：spDB的第一个参数默认是“表全名”，受配置“db_spdb_full_tblname”影响。当“db_spdb_full_tblname”为FALSE的时候，可以仅输入“表名”，框架将自动加上表前缀。

2.第二个参数：可选的主键。默认不需要输入主键，使用数据库驱动类getTable操作获得的第一个字段作为主键———这在大部分数据表设计中都是正确的。如果开发者的数据库表第一个字段并非主键（其他字段才是主键，或没有主键）的情况下，那么spDB就需要输入第二个参数（字段名）作为主键来进行操作。

==参考来源==
http://speedphp.com/manual.html

{{SpeedPHP}}

[[category:SpeedPHP|J]]