SpeedPHP数据库操作教程二，Model功能全解析

首先我们来看一下将会用到的数据表gb（如加上表前缀，则表全名为 spgb_gb），这是一个留言本程序使用的数据表。
 
=700) window.open('http://speedphp.com/wp/wp-content/uploads/spmodel-crud-table.jpg');" onload="if(this.offsetWidth>'700')this.width='700';if(this.offsetHeight>'700')this.height='700';" >
 


下面我们来看看spModel提供了哪些数据表操作函数，它们各有什么作用？
find —— 从数据表中查找一条记录
用法：find($conditions = null, $sort = null, $fields = null)
参数：
$conditions，数组形式，查找条件，数组的键是数据表中的字段名，键对应的值是该字段的条件。
比如要在留言本中查找到名为“小李”留言者的第一条留言，那么$conditions条件则应该是：
$conditions = array( // PHP数组
'name' => '小李', // 键name是数据表中的字段，小李是我们要查找的数据
);
*$sort，字符串，指定结果排序方向
*$fields，字符串，特殊指定返回的字段
 
在find，findAll，findSQL等多个查找函数以及update，delete等函数中出现的参数$conditions，除了可以是数组格式外，还可以是字符串的形式，而字符串形式的$conditions就如同SQL语句中的WHERE后面的条件字符串一样的使用。
如：
$conditions = array('name'=>'小李');
就等同于
$conditions = " 'name' = '小李' ";
例子：

复制代码 // 首先需要准备查找条件 $conditions = array( 'name' => '小李' ); $gb = spClass('gb'); // 初始化留言本模型类 $result = $gb->find($conditions); // 查找 dump($result); // 查看结果， echo $result['contents']; // 直接输出结果中的留言内容，对应字段contents

如果数据表中有留言者是小李的数据：（有两条记录）
12 小李 我的留言 2009-10-26 10:04:53 218.82.32.12
13 小李 我的第二条留言 2009-10-26 10:04:53 218.82.32.12
那么将返回
$result = array(
'gid' => 12,
'name' => '小李',
'contents' => '我的留言',
'post_time' => '2009-10-26 10:04:53',
'post_ip' => '218.82.32.12',
'replay' => ''
);
请注意，find仅是返回了第一条符合条件的记录。
返回：
按条件查询不到任何数据，find将返回FALSE
如查找到预期的结果则返回结果数组，数组的键是字段名，数组的值是数据。


findAll —— 从数据表中查找记录
findAll与find的区别在于findAll是返回全部符合条件的记录，而find仅是返回findAll结果的第一条记录。
用法：findAll($conditions = null, $sort = null, $fields = null, $limit = null)
参数：
$conditions，数组形式，查找条件，同find的$conditions
*$sort，字符串，指定结果排序方向
*$fields，字符串，特殊指定返回的字段
*$limit，字符串，返回结果数量限制
例子：

复制代码 // 还是需要查找小李的留言，不过这次是查找他的全部的留言。 // 首先需要准备查找条件 $conditions = array( 'name' => '小李' ); // 条件是同样的 $gb = spClass('gb'); // 初始化留言本模型类 $result = $gb->findAll($conditions); // 使用了findAll dump($result); // 查看结果，

数据表中有留言者是小李的数据：
12 小李 我的留言 2009-10-26 10:04:53 218.82.32.12
13 小李 我的第二条留言 2009-10-26 10:04:53 218.82.32.12
findAll将返回

复制代码 $result = array( 0 => array( 'gid' => 12, 'name' => '小李', 'contents' => '我的留言', 'post_time' => '2009-10-26 10:04:53', 'post_ip' => '218.82.32.12', 'replay' => '' ), 1 => array( 'gid' => 13, 'name' => '小李', 'contents' => '我的第二条留言', 'post_time' => '2009-10-26 10:04:53', 'post_ip' => '218.82.32.12', 'replay' => '' ), );

返回：
按条件查询不到任何数据，findAll将返回FALSE
如查找到预期的结果则返回结果数组。对比find返回的结果，findAll是返回了二维数组，并且数组的每一项将是代表一条记录的数组。
create —— 在数据表中新增一行数据
用法：create($row)
参数：
$row，数组形式，数组的键是数据表中的字段名，键对应的值是需要新增的数据。
例子：

复制代码 /** 首先是准备新增的数据 *　　表中的gid因为是自增量，所以没必要去赋值 *　　replay因为是可为空，并且刚留言也不会有回复，所以也可以不赋值 *　　数组中的键是字段名称，值是数据 */ $newrow = array( // PHP的数组 'name' => 'jake', 'contents' => '这是我的第一个留言', 'post_time' => date('Y-m-d H:i:s'), 'post_ip' => $_SERVER['REMOTE_ADDRESS'], ); $gb = spClass('gb'); // 初始化留言本模型类 $gb->create($newrow);　　// 进行新增操作

返回：
新增成功则返回新增的自增量ID，失败则返回FALSE。
update —— 修改数据，该函数将根据参数中设置的条件而更新表中数据。
用法：update($conditions, $row)
参数：
$conditions，数组形式，查找条件，此参数的格式用法与find/findAll的查找条件参数是相同的。
$row，数组形式，修改的数据，此参数的格式用法与create的$row是相同的。在符合条件的记录中，将对$row设置的字段的数据进行修改。
例子：

复制代码 // 将小李的第一条留言，也就是gid = 12的留言的内容修改成“我的第一条留言”。 // 构造查找条件 $conditions = array('gid'=>12); // 思考为什么不能用 'name' => '小李' 来作为条件呢？ // 设置需要更新的字段，注意没必要更新的字段请不要设置。这里我们仅仅修改contents（内容）对应的数据。 $row = array('contents'=>'我的第一条记录'); $gb = spClass('gb'); $gb->update($conditions, $row);

原来的数据表：
12 小李 我的留言 2009-10-26 10:04:53 218.82.32.12
13 小李 我的第二条留言 2009-10-26 10:04:53 218.82.32.12
经过执行$gb->update($conditions, $row);后：
12 小李 我的第一条留言 2009-10-26 10:04:53 218.82.32.12
13 小李 我的第二条留言 2009-10-26 10:04:53 218.82.32.12
返回：
返回TRUE则是语句执行成功，无论有无符合条件的记录，只要操作正常执行则返回TRUE。
返回FALSE是语句执行失败
delete —— 按条件删除记录
用法：delete($conditions)
参数：
$conditions，数组形式，查找条件，此参数的格式用法与find/findAll的查找条件参数是相同的。
delete的操作将删除符合$conditions条件的记录。
例子：

复制代码 // 这里我们将删除小李的第二条留言，也就是gid=13的记录 // 构造查找条件 $conditions = array('gid'=>13); // 构造条件 $gb = spClass('gb'); $gb->delete($conditions);

原来的数据表：
12 小李 我的留言 2009-10-26 10:04:53 218.82.32.12
13 小李 我的第二条留言 2009-10-26 10:04:53 218.82.32.12
经过执行$gb->delete($conditions);后：
12 小李 我的第一条留言 2009-10-26 10:04:53 218.82.32.12
gid为13的记录已被删除
返回：
返回TRUE则是语句执行成功，无论有无符合条件的记录，只要操作正常执行则返回TRUE。
返回FALSE是语句执行失败
除了以上的spModel常规操作函数外，spModel还提供了一些简便操作的函数。


* findBy —— 按字段值查找一条记录
用法：findBy($field, $value)
参数：
$field，字符串，对应数据表中的字段名
$value，字符串，对应的值
该函数简化了find的操作：

复制代码 // 使用findBy $gb->findBy('name', '小李'); // 等同于find $conditions = array('name'=>'小李'); $gb->find($conditions);

返回值参考find函数。
* updateField —— 按字段值修改一条记录
用法：updateField($conditions, $field, $value)
参数：
$conditions，数组形式，查找条件，此参数的格式用法与find/findAll的查找条件参数是相同的。
$field，字符串，对应数据表中的需要修改的字段名
$value，字符串，新值
该函数简化了update的操作：

复制代码 // 使用updateField $conditions = array('gid'=>12); $gb->updateField($conditions, 'contents', '我的第一条记录'); // 等同于update $conditions = array('gid'=>12); $row = array('contents'=>'我的第一条记录'); $gb->update($conditions, $row);

返回值参考update函数。
* deleteByPk —— 按给定的数据表的主键删除记录
用法：deleteByPk($pk)
参数：
$pk，字符串或数字，数据表主键的值。
该函数简化了delete的操作，根据给定的主键删除对应的记录。
例子：

复制代码 // 在gb表中gid就是主键，我们将删除gid为13的记录 // 使用deleteByPk $gb->deleteByPk(13); // 等同于使用delete $conditions = array('gid'=>13); // 构造条件 $gb->delete($conditions);

返回值参照delete函数。
* findCount —— 计算符合条件的记录数量
用法：findCount($conditions = null)
参数：
$conditions，数组形式，查找条件，此参数的格式用法与find/findAll的查找条件参数是相同的。
该函数主要用于计算符合$conditions的记录数量。
例子：

复制代码 // 我们来看看数据表中有多少条留言者是“小李”的留言 $conditions = array( 'name' => '小李' ); // 条件是同样的 $gb = spClass('gb'); // 初始化留言本模型类 $sum = $gb->findCount($conditions); // 使用了findCount echo $sum;

数据表中有留言者是小李的数据：
12 小李 我的留言 2009-10-26 10:04:53 218.82.32.12
13 小李 我的第二条留言 2009-10-26 10:04:53 218.82.32.12
findCount将得到结果：2，也就是有两条留言者是“小李”的留言。
返回：
返回符合$conditions记录的数量，如无任何符合条件的记录将返回 0。
以上就是spModel对于数据库操作的一些封装的操作函数，实践证明，这些函数几乎囊括了在日常的PHP程序开发中百分之八十以上的数据库操作。也就是说，在日常的数据库程序开发中，基本是不需要编写一行SQL语句就可以完成工作。
当然，在一些特殊的情况下，我们还是需要对数据表进行更为复杂的操作，那么我们就需要直接使用到SQL语句了，下一章节将介绍到spModel的SQL语句查询/操作的能力。
 
本文地址：http://speedphp.com/post/spmodel-all-functions.html