原文来自:https://www.zixuephp.com
织梦DedeCMS的二次开发不仅仅是会写写织梦的标签,会制作织梦的模板。很多时候,我们需要对织梦DedeCMS的数据库进行查询、插入、删除等等之类的操作,进行这一类的操作之前,我们必须知道织梦DedeCMS的数据库类,No牛网整理了织梦天涯版主关于DedeCMS程序的dedesql类常见的用法讲解的文章,希望有朋友用的上。
1.创建数据表
为了让讲解更加的贴合实际,天涯版主创建了一个名为"dede_test"的表,里面就2个字段,1个id,作为唯一标识,另一个name作为名称。然后往里面添加测试数据,这个操作类似于Access或者EXCEL,比较简单,这里不做冗述。
使用如下的SQL语句插入一些数据供操作使用:
INSERTINTO`dede_test`VALUES('1','测试名字1'); INSERTINTO`dede_test`VALUES('2','这是第二个'); INSERTINTO`dede_test`VALUES('3','第三个喽'); INSERTINTO`dede_test`VALUES('4','第四个');
2.连接数据库
在对织梦DedeCMS的数据库进行操作之前,当然是先连接数据库了,方法非常简单。只需要在操作的文件中引入include文件夹下面的common.inc.php文件即可。可以在网站根目录中创建一个test.php的文件来进行相关的测试操作,在这个文件中写入如下的代码:
在浏览器中运行之后,查看源代码就可以得到如下图所示的代码:
这个就说明我们已经成功连接数据库了,[dbHost],[dbUser]…这些都是数据库的相关信息,也就是我们保存在配置文件中的\data\common.inc.php内容,引入数据库类的时候,默认就被创建了$dsql或者$db,所以直接引入配置文件就可以了。
接下来做一个简单的查询操作,接着上面的代码我们继续写test.php文件,代码如下:
IsTable('dede_test')){ //如果存在dede_test表 //------------------- //|查询一条记录| //|GetOne()| //------------------- //↓ $row=$dsql->GetOne("SELECT*FROMdede_testWHEREid=3"); print_r($row); } ?>
这里我们用了$dsql类的2个方法,IsTable()以及GetOne(),IsTable先来判断这个表是否存在,如果存在我们就继续执行,他返回的是一个bool值,如果存在为true否则就为false。
接下来判断如果有这个表存在,则我们就执行查询单条记录的这个过程,即GetOne,通过帮助文档可以知道:$arr = $db->GetOne($sql);也就是说查询的sql语句会传送回来一个数组,我们运行test.php看到如下运行结果:
Array ( [id]=>3 [name]=>第三个喽 )
这个说明我们查询dede_test这个表id为3的数据成功了,返回了一个$row数组,其中就存放了字段的值。当然我们可以用echo $row['name'];或者$row['id']来输出我们查询出来的结果。
3.查询数据库
刚才讲了查询一条记录,其实这个查询一条记录可以理解为我们内容页查询一篇文章,只是获取单条记录并将内容显示出来,但往往我们经常遇到的是查询列表,及{dede:arclist/}或者{dede:list/},查询列表的话涉及到查询多条记录。
继续修改test.php代码:
IsTable('dede_test')){ //如果存在dede_test表 //------------------- //|查询一条记录| //|GetOne()| //------------------- //↓ $row=$dsql->GetOne("SELECT*FROMdede_testWHEREid=3"); echo"查询id=3的记录: 显示结果:"; print_r($row); //------------------- //|查询多条记录| //|Execute()| //------------------- //↓ echo"[objectObject]查询dede_test表中的所有记录: 显示结果: "; $sql="SELECT*FROMdede_test"; $dsql->Execute('me',$sql); while($arr=$dsql->GetArray('me')) { echo"id={$arr['id']},name={$arr['name']} "; } } ?>
运行test.php看到显示以下的内容:
查询dede_test表中的所有记录: 显示结果: id=1,name=测试名字1 id=2,name=这是第二个 id=3,name=第三个喽 id=4,name=第四个
这个说明我们已经成功将表dede_test中的数据输出,当然主要是执行了那个"SELECT * FROM dede_test",这是一个最简单的sql查询语句,当然也能够用到order by这些排序或者条件去查询,详细可以参考sql相关内容。
同时这里需要说明的是这里除了用$dsql->GetArray('me')来获取内容到数组,还可以用$dsql->GetObject("me")获取内容到对象,不过调用方法有些不同,主要这里通过$dbobj->fieldname来调用查询出来的数据:
while($dbobj=$dsql->GetObject('me')) { echo"id={$dbobj->id},name={$dbobj->name} "; }
4.插入删除操作数据库
上面我们介绍了如何用dsql来查询数据,主要有获取单条记录和获取多条记录2种,接下来我们来了解下使用dsql其他特性来为我们的test.php加入添加内容和删除内容的功能。先来了解下插入数据库的操作,我们先做一个表单,这个表单用于提交数据name的。表单代码如下:
[objectObject]用于提交数据的表单:
这里我们用了一个隐藏域dopost来存放操作方法,输入框name用来存放输入数据,然后传递给当前页面,再进行处理,这时候我们需要在test.php中加入部分的表单处理操作:
//------------------- //|表单处理过程| //|Save()| //------------------- //↓ empty($dopost)?"":$dopost; if($dopost=="save"){ //如果执行插入操作 $sql="INSERTINTO`dede_test`(`name`)VALUES('{$name}')"; $dsql->ExecuteNoneQuery($sql);//执行这个插入语句 $lastInsertID=$dsql->GetLastID();//获取插入后的最后的ID,然后再传给下一个页面 ShowMsg("成功增加一条记录内容!","test.php?id={$lastInsertID}"); exit(); }
这里主要是一个INSERT INTO 语句,然后通过$dsql的ExecuteNoneQuery方法来执行这个操作,并且获取插入数据最后一个id再将其传递给下一个页面以便高亮显示。我们可以在编辑框中插入一条数据来测试下,看看插入数据后的返回结果:
其实删除的操作也是如此,我们只需要稍微做个修改就可以了,增加一个dopost操作为del的判断,然后在显示数据后面增加一个超链接,将id以get方式进行传递.并最后进行处理。下面是我们修改循环查询输出的部分内容,有如下修改:
while($dbobj=$dsql->GetObject('me')) { if($id==$dbobj->id){ //如果传递的id值和查询值相同,则高亮显示最后一条插入记录 echo" ";//这里增加了一个删除的超链接 }else{ echo"id={$dbobj->id},name={$dbobj->name} "; } } //下面是del这个post的判断: empty($dopost)?"":$dopost; if($dopost=="save"){ //如果执行插入操作 $sql="INSERTINTO`dede_test`(`name`)VALUES('{$name}')"; $dsql->ExecuteNoneQuery($sql); $lastInsertID=$dsql->GetLastID(); ShowMsg("成功增加一条记录内容!","test.php?id={$lastInsertID}"); exit(); }elseif($dopost=="del"){ //如果dopost为del,则删除数据 $id=isset($id)&&is_numeric($id)?$id:0; $sql="DELETEFROM`dede_test`WHERE(`id`='{$id}')"; $dsql->ExecuteNoneQuery($sql); ShowMsg("成功删除一条记录内容!","test.php"); exit(); }