织梦 dedecms 的二次开发不仅仅是会写写织梦的标签,会制作织梦的模板。很多时候,我们需要对织梦 DedeCMS 的数据库进行查询、插入、删除等等之类的操作,进行这一类的操作之前,我们必须知道织梦 DedeCMS 的数据库类,织梦学习网整理了织梦天涯版主关于 DedeCMS 程序的 dedesql 类常见的用法讲解的文章,希望有朋友用的上。
1.创建数据表
为了让讲解更加的贴合实际,天涯版主创建了一个名为"dede_test"的表,里面就 2 个字段,1 个 id,作为唯一标识,另一个 name 作为名称。然后往里面添加测试数据,这个操作类似于 Access 或者 EXCEL,比较简单,这里不做冗述。使用如下的 SQL 语句插入一些数据供操作使用:
INSERT INTO `dede_test` VALUES ('1', '测试名字1');INSERT INTO `dede_test` VALUES ('2', '这是第二个');INSERT INTO `dede_test` VALUES ('3', '第三个喽');INSERT INTO `dede_test` VALUES ('4', '第四个');
2.连接数据
库在对织梦 DedeCMS 的数据库进行操作之前,当然是先连接数据库了,方法非常简单。只需要在操作的文件中引入 include 文件夹下面的 common.inc.php 文件即可。可以在网站根目录中创建一个 test.php 的文件来进行相关的测试操作,在这个文件中写入如下的代码:
<?phprequire_once (dirname(__FILE__) . "/include/common.inc.php");print_r($dsql);?>
在浏览器中运行之后,查看源代码就可以得到如下图所示的代码:
织梦 DedeCMS 二次开发必用之数据库类操作,这个就说明我们已经成功连接数据库了,[dbHost],[dbUser]...这些都是数据库的相关信息,也就是我们保存在配置文件中的datacommon.inc.php 内容,引入数据库类的时候,默认就被创建了$dsql 或者$db,所以直接引入配置文件就可以了。接下来做一个简单的查询操作,接着上面的代码我们继续写 test.php 文件,代码如下:
<?phprequire_once (dirname(__FILE__) . "/include/common.inc.php");if($dsql->IsTable('dede_test')){//如果存在dede_test表//-------------------//| 查询一条记录 |//| GetOne() |//-------------------// ↓$row = $dsql->GetOne("SELECT * FROM dede_test WHERE id = 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 代码:
<?phprequire_once (dirname(__FILE__) . "/include/common.inc.php");if($dsql->IsTable('dede_test')){//如果存在dede_test表//-------------------//| 查询一条记录 |//| GetOne() |//-------------------// ↓$row = $dsql->GetOne("SELECT * FROM dede_test WHERE id = 3");echo "查询id=3的记录:<br />显示结果:";print_r($row);//-------------------//| 查询多条记录 |//| Execute() |//-------------------// ↓echo "<hr />查询dede_test表中的所有记录:<br />显示结果:<br />";$sql = "SELECT * FROM dede_test";$dsql->Execute('me',$sql);while($arr = $dsql->GetArray('me')){echo "id = {$arr['id']} ,name = {$arr['name']}<br />";}}?>
运行 test.php 看到显示以下的内容,查询 dede_test 表中的所有记录,显示结果:
id = 1 ,name = 测试名字1id = 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 来调用查询出来的数据:
hile($dbobj = $dsql->GetObject('me')){echo "id = {$dbobj->id} ,name = {$dbobj->name}<br />";}
4.插入删除操作数据
库上面我们介绍了如何用 dsql 来查询数据,主要有获取单条记录和获取多条记录 2 种,接下来我们来了解下使用 dsql 其他特性来为我们的 test.php 加入添加内容和删除内容的功能。先来了解下插入数据库的操作,我们先做一个表单,这个表单用于提交数据 name 的。表单代码如下:
<hr />用于提交数据的表单:<br /><form action="test.php" type="post"><input type="hidden" name="dopost" value="save">名称:<input type="text" name="name" value=""><input name="提交" type="submit" value="提交"></form>
这里我们用了一个隐藏域 dopost 来存放操作方法,输入框 name 用来存放输入数据,然后传递给当前页面,再进行处理,这时候我们需要在 test.php 中加入部分的表单处理操作:这里主要是一个 INSERT INTO 语句,然后通过$dsql 的 ExecuteNoneQuery 方法来执行这个操作,并且获取插入数据最后一个 id 再将其传递给下一个页面以便高亮显示。我们可以在编辑框中插入一条数据来测试下,看看插入数据后的返回结果:
织梦 DedeCMS 二次开发必用之数据库类操作 其实删除的操作也是如此,我们只需要稍微做个修改就可以了,增加一个 dopost 操作为 del 的判断,然后在显示数据后面增加一个超链接,将 id 以 get 方式进行传递.并最后进行处理。下面是我们修改循环查询输出的部分内容,有如下修改:
while($dbobj = $dsql->GetObject('me')){if($id==$dbobj->id){//如果传递的id值和查询值相同,则高亮显示最后一条插入记录echo "<font color='red'>id = {$dbobj->id} ,name = {$dbobj->name}</font> <a href='test.php?dopost=del&id={$dbobj->id}'>[删除]</a> <br />";//这里增加了一个删除的超链接}else{echo "id = {$dbobj->id} ,name = {$dbobj->name} <a href='test.php?dopost=del&id={$dbobj->id}'>[删除]</a><br />";}}//下面是del这个post的判断:empty($dopost)? "" : $dopost;if($dopost == "save"){//如果执行插入操作$sql = "INSERT INTO `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 = "DELETE FROM `dede_test` WHERE (`id`='{$id}')";$dsql->ExecuteNoneQuery($sql);ShowMsg("成功删除一条记录内容!","test.php");exit();}
以上就是织梦 DedeCMS 数据库类操作的全部过程。