快速入门五、简便的数据表操作

从前面的留言本例子，我们可以看到使用sp框架进行开发，在查找和新建数据库记录的时候是不需要使用SQL语句的，而且非常的简单易用。下面我们就来详细地介绍一下在sp框架中简便的数据表操作。

使用数据库，首先是需要应用程序配置，留言本中使用了以下的配置：

view source

print?

1	"db" => array( // 数据库设置

2	'host' => 'localhost',  // 数据库地址，一般都可以是localhost

3	'login' => 'root', // 数据库用户名

4	'password' => '123456', // 数据库密码

5	'database' => 'test', // 数据库的库名称

6

),

如果您是使用虚拟主机，上面的数据库设置请咨询您的主机服务商。如果您是使用SpeedAMP进行开发的话，默认的配置就是上面所写的。

配置好了我们的应用程序后，就可以对每一个数据表，都在model目录下新建一个数据模型类文件。如留言本中的guestbook文件一样。数据模型类文件可以很简单：

view source

print?

1

<?php

2	class guestbook extends spModel

3

{

4	var $pk = "id"; // 数据表的主键

5	var $table = "guestbook"; // 数据表的名称

6

}

这里要注意的是文件名需要和类名相同，然后设置主键和表名即可。

接下来我们就可以在我们的controller程序里面直接使用find/findAll，create之类的函数来替代mysql函数和SQL语句了。这里我们介绍几个常用的函数：

findAll 

按条件查找记录，返回数组

findAll($conditions)的$conditions是条件，可以为空，也可以是数组或者字符串。比如留言本中：

view source

print?

1	$guestbook = spClass("guestbook");

2	if( $result = $guestbook->findAll() ){

$conditions留空代表着查出表中的全部记录。

$conditions为字符串，那么字符串代表的就是查询条件，如$conditions = " name = 'jake' ";那么将查找“留言者名称是jake”的全部记录。如$conditions = " name = 'jake'  AND title = '我是标题"; 将查找“留言者名称是jake，同时留言标题是‘我是标题’”的全部留言。

$conditions为数组，那么每项分别是一个条件，比如：

$conditions = array("name" => 'jake' , "title" => '我是标题");和$conditions = " name = 'jake'  AND title = '我是标题";是一样的。

改写后的main.php就是：

view source

print?

01

...

02	function index(){ // 这里是首页

03	$posturl = spUrl("main", "write"); // 用spUrl制造写留言的地址

04	echo "<p align=center><h2>我的留言本</h2></p>";

05	// 下面做一个表单来提交留言，请注意这些输入框的name属性，它们都对应了数据表guestbook的字段名！

06	echo "<p>请写下您的留言：</p><form action={$posturl} method=POST><p>您的名字：<input type=text name=name></p><p>留言标题：<input type=text name=title></p><p>留言内容：<textarea name=contents></textarea></p><p><input type=submit value=提交></p></form>";

07	$guestbook = spClass("guestbook"); // 用spClass来初始化留言本数据表对象（模型类对象）

08	$conditions = array("name" => 'jake' , "title" => '我是标题');

09	if( $result = $guestbook->findAll($conditions) ){ // 用findAll将“留言者名称是jake，同时留言标题是‘我是标题’”的留言查出来

10	foreach($result as $value){ // 循环输出留言信息

11	$contentsurl = spUrl("main", "show", array('id'=>$value['id'])); // 用spUrl制造查看留言内容页面地址，请注意array('id'=>$value['id'])将传递ID到查看页面，由spArgs来接收。

12	echo "<p>这里是第{$value['id']}条留言：<a href={$contentsurl} target=_blank>{$value['title']}</a>&nbsp;&nbsp;{$value['name']}</p>";

13

}

14

}

15

}

16

...

发几条留言，其中有的是符合条件而有的不是，那么我们就可以看出结果来了。

find

查找符合条件的第一条记录

和findAll不同，find仅是查找并返回第一条符合条件的记录。在留言本中：

view source

print?

01

...

02

}

03	function show(){ // 这里是查看留言内容

04	$id = $this->spArgs("id"); // 用spArgs接收spUrl传过来的ID

05	$guestbook = spClass("guestbook");  // 还是用spClass

06	$conditions = array('id'=>$id); // 制造查找条件，这里是使用ID来查找属于ID的那条留言记录

07	$result = $guestbook->find($conditions);  // 这次是用find来查找，我们把$condition（条件）放了进去

08	// 下面输出了该条留言内容

09	echo "<p>留言标题：{$result['title']}</p>";

10	echo "<p>留言者：{$result['name']}</p>";

11	echo "<p>留言内容：{$result['contents']}</p>";

12

}

13	function write(){ // 这里是留言

14

...

使用了find($condition)来查找ID符合条件的记录，然后显示出来。我们可以看到，find获得的结果数组，也与findAll不同。find的结果是一个由字段名组成的数组，而findAll是每个数组项都像一个find的结果。

create

新增一条记录

create用起来很容易，只要我们把一个有着“字段名对应数值”的数组放到create里面，那么就可以在数据表中新建一条记录了。在留言本中，我们是直接将表单提交的数据，也就是spArgs获取到的数据放到create里面的：

view source

print?

1

...

2	function write(){ // 这里是留言

3	$guestbook = spClass("guestbook");

4	$guestbook->create($this->spArgs()); // 这里用$this->spArgs()取得了表单的全部内容，然后增加了一条留言记录

5	echo "留言成功，<a href=/index.php>返回</a>";

6

}

7

...

我们可以更详细点写以上的代码：

view source

print?

01

...

02	function write(){ // 这里是留言

03	$guestbook = spClass("guestbook");

04	$newrow = array(

05	'name' => $this->spArgs('name'),

06	'title' => $this->spArgs('title'),

07	'contents' => $this->spArgs('contents'),

08

);

09	$guestbook->create($newrow);

10	echo "留言成功，<a href=/index.php>返回</a>";

11

}

12

...

这个和前面的效果是一样的。我们就可以清晰地看到，create($newrow)的$newrow里面是字段名和值的对应了。为什么没有id这个字段呢？是因为id本身是自增量，所以不需要出现在这里，它是会自动赋值的。

这里我们介绍一下spArgs，在表单中提交的数据，<input>（还有<textarea>，<select>等）里面的name = "what"，那么我们在程序中就可以用$this->spArgs("what");来获得。像留言本中的“<p>留言标题：<input type=text name=title></p>”我们在程序中就是$this->spArgs('title')来取得标题的输入值。请理解这一一对应的方式。

我们也可以看到，用数组的形式来进行数据库的操作，的确要比写SQL语句方便易记，而且不容易出错。并且也不需要写mysql_*的函数。

update

修改符合条件的记录

update使用的方法有些像是findAll和create的结合体，因为update需要和findAll一样的条件（$conditions），也需要像create的$newrow，只是update只是需要修改的才放到$updaterow 里面而已。

我们在留言本中加上一个test_update()，好用来测试update：

view source

print?

01

...

02	function test_update(){ // 测试update用页面

03	$guestbook = spClass("guestbook");

04	$conditions = array("id"=>2); // 查找id是2的记录

05	$newrow = array(

06	'name' => '喜羊羊',  // 然后将这条记录的name改成“喜羊羊”

07

);

08	$guestbook->update($conditions, $newrow); // 更新记录

09	echo "已修改id为2的记录！";

10

}

11

...

好了，访问http://localhost/index.php?c=main&a=test_update，然后看看数据库记录。我们的id为2的记录中的name（留言者名称）改成了“喜羊羊”。

• 请注意，update里面的$updaterow是需要修改什么才将什么放进去，和create不同。

delete

删除符合条件的记录

delete的使用方法和findAll是同样需要$conditions的，也就是delete将删除符合条件的全部记录。

比如我们要删除那条已经改成name是“喜羊羊”的记录。

view source

print?

1

...

2	function test_delete(){ // 测试delete用页面

3	$guestbook = spClass("guestbook");

4	$conditions = array('name' => '喜羊羊');

5	$guestbook->delete($conditions); // 删除记录

6	echo "已删除名称是喜羊羊的记录！";

7

}

8

...

我们访问一下test_delete，然后再看看数据库记录，刚才那条喜羊羊的记录已经没有了。

我们可以看到delete使用的同样是和findAll一样的$conditions。同时我们用delete要注意，delete是会删除全部符合条件的记录。

当然，如果直接用$guestbook->delete(); 是会报错而不是删除全部记录。

上面我们已经看到了find/findAll，create，update和delete这些操作了。这就是的数据库CRUD操作（CREATE新建，READ查找读取，UPDATE修改，DELETE删除）。了解了这些操作，日常的大部分数据库开发都是可以完成的。因为实践证明，几乎大部分的PHP程序只是用到基本的CRUD。

下章我们把留言本继续改写，把它变成使用Smarty模板的程序，我们将会看采用了模板的留言本，在PHP代码上面将更简洁；而且简洁的同时，我们的留言本也变成了可以换皮肤的程序了。