从前面的留言本例子,我们可以看到使用sp框架进行开发,在查找和新建数据库记录的时候是不需要使用SQL语句的,而且非常的简单易用。下面我们就来详细地介绍一下在sp框架中简便的数据表操作。
使用数据库,首先是需要应用程序配置,留言本中使用了以下的配置:
4 | 'password' => '123456' , |
如果您是使用虚拟主机,上面的数据库设置请咨询您的主机服务商。如果您是使用SpeedAMP进行开发的话,默认的配置就是上面所写的。
配置好了我们的应用程序后,就可以对每一个数据表,都在model目录下新建一个数据模型类文件。如留言本中的guestbook文件一样。数据模型类文件可以很简单:
2 | class guestbook extends spModel |
5 | var $table = "guestbook" ; |
这里要注意的是文件名需要和类名相同,然后设置主键和表名即可。
接下来我们就可以在我们的controller程序里面直接使用find/findAll,create之类的函数来替代mysql函数和SQL语句了。这里我们介绍几个常用的函数:
findAll
按条件查找记录,返回数组
findAll($conditions)的$conditions是条件,可以为空,也可以是数组或者字符串。比如留言本中:
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就是:
03 | $posturl = spUrl( "main" , "write" ); |
04 | echo "<p align=center><h2>我的留言本</h2></p>" ; |
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" ); |
08 | $conditions = array ( "name" => 'jake' , "title" => '我是标题' ); |
09 | if ( $result = $guestbook ->findAll( $conditions ) ){ |
10 | foreach ( $result as $value ){ |
11 | $contentsurl = spUrl( "main" , "show" , array ( 'id' => $value [ 'id' ])); |
12 | echo "<p>这里是第{$value['id']}条留言:<a href={$contentsurl} target=_blank>{$value['title']}</a> {$value['name']}</p>" ; |
发几条留言,其中有的是符合条件而有的不是,那么我们就可以看出结果来了。
find
查找符合条件的第一条记录
和findAll不同,find仅是查找并返回第一条符合条件的记录。在留言本中:
04 | $id = $this ->spArgs( "id" ); |
05 | $guestbook = spClass( "guestbook" ); |
06 | $conditions = array ( 'id' => $id ); |
07 | $result = $guestbook ->find( $conditions ); |
09 | echo "<p>留言标题:{$result['title']}</p>" ; |
10 | echo "<p>留言者:{$result['name']}</p>" ; |
11 | echo "<p>留言内容:{$result['contents']}</p>" ; |
使用了find($condition)来查找ID符合条件的记录,然后显示出来。我们可以看到,find获得的结果数组,也与findAll不同。find的结果是一个由字段名组成的数组,而findAll是每个数组项都像一个find的结果。
create
新增一条记录
create用起来很容易,只要我们把一个有着“字段名对应数值”的数组放到create里面,那么就可以在数据表中新建一条记录了。在留言本中,我们是直接将表单提交的数据,也就是spArgs获取到的数据放到create里面的:
3 | $guestbook = spClass( "guestbook" ); |
4 | $guestbook ->create( $this ->spArgs()); |
5 | echo "留言成功,<a href=/index.php>返回</a>" ; |
我们可以更详细点写以上的代码:
03 | $guestbook = spClass( "guestbook" ); |
05 | 'name' => $this ->spArgs( 'name' ), |
06 | 'title' => $this ->spArgs( 'title' ), |
07 | 'contents' => $this ->spArgs( 'contents' ), |
09 | $guestbook ->create( $newrow ); |
10 | echo "留言成功,<a href=/index.php>返回</a>" ; |
这个和前面的效果是一样的。我们就可以清晰地看到,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:
02 | function test_update(){ |
03 | $guestbook = spClass( "guestbook" ); |
04 | $conditions = array ( "id" =>2); |
08 | $guestbook ->update( $conditions , $newrow ); |
好了,访问http://localhost/index.php?c=main&a=test_update,然后看看数据库记录。我们的id为2的记录中的name(留言者名称)改成了“喜羊羊”。
- 请注意,update里面的$updaterow是需要修改什么才将什么放进去,和create不同。
delete
删除符合条件的记录
delete的使用方法和findAll是同样需要$conditions的,也就是delete将删除符合条件的全部记录。
比如我们要删除那条已经改成name是“喜羊羊”的记录。
2 | function test_delete(){ |
3 | $guestbook = spClass( "guestbook" ); |
4 | $conditions = array ( 'name' => '喜羊羊' ); |
5 | $guestbook -> delete ( $conditions ); |
我们访问一下test_delete,然后再看看数据库记录,刚才那条喜羊羊的记录已经没有了。
我们可以看到delete使用的同样是和findAll一样的$conditions。同时我们用delete要注意,delete是会删除全部符合条件的记录。
当然,如果直接用$guestbook->delete(); 是会报错而不是删除全部记录。
上面我们已经看到了find/findAll,create,update和delete这些操作了。这就是的数据库CRUD操作(CREATE新建,READ查找读取,UPDATE修改,DELETE删除)。了解了这些操作,日常的大部分数据库开发都是可以完成的。因为实践证明,几乎大部分的PHP程序只是用到基本的CRUD。
下章我们把留言本继续改写,把它变成使用Smarty模板的程序,我们将会看采用了模板的留言本,在PHP代码上面将更简洁;而且简洁的同时,我们的留言本也变成了可以换皮肤的程序了。