#1 jake

首先我们来看一下将会用到的数据表gb(如加上表前缀,则表全名为 spgb_gb),这是一个留言本程序使用的数据表。

spmodel-crud-table[1].jpg
有的时候我们会觉得数据库方面较难入门,因为看着书本上那些十几个字段的一些数据表例子,感觉自己怎么也不能设计出那么复杂的表结构。但其实这并非必要,在很多时候,我们可以先按自己的理解去建立出可以供自己使用的数据表,哪怕表中就两三个字段。字段将会随着程序的编写而继续增加,到了程序的完成之时,字段也就将近完整了。那么,到了下一次再编写同类的程序,那么这些字段就可以作为我们的参考。

下面我们来介绍SpeedPHP框架在数据库查找方法:

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

如查找到预期的结果则返回结果数组,数组的键是字段名,数组的值是数据。

这里需要注明一下,由于sp框架虽然简单易用,但是高级的功能也是非常多的,所以在介绍相关的类和函数的时候,会遇到一些较复杂的参数或者是函数,如上例中的$sort,$fields参数。为了我们可以尽快掌握sp框架进行实践开发,不受到这些在特殊情况下才用到的高级功能的影响,我们将并非必要理解的参数或函数标上了*号,而且也是仅做较少的说明,如果需要进一步了解这些参数或函数的作用,请参考sp框架手册或到网站上参与讨论。

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是返回了二维数组,并且数组的每一项将是代表一条记录的数组。



2012-08-04 15:38:04