织梦DedeCMS的二次开发之数据库类操作

Posted 2020-10-20 tt-1314

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的文件来进行相关的测试操作，在这个文件中写入如下的代码：

1 <?php 
2 require_once (dirname(__FILE__) . "/include/common.inc.php");
 print_r($dsql); 
3 ?> 

在浏览器中运行之后，查看源代码就可以得到如下图所示的代码：

 

这个就说明我们已经成功连接数据库了，[dbHost],[dbUser]...这些都是数据库的相关信息，也就是我们保存在配置文件中的\\data\\common.inc.php内容，引入数据库类的时候，默认就被创建了$dsql或者$db，所以直接引入配置文件就可以了。 接下来做一个简单的查询操作，接着上面的代码我们继续写test.php文件，代码如下：

 1 <?php 
 2 require_once (dirname(__FILE__) . "/include/common.inc.php"); if($dsql->IsTable(‘dede_test‘)){
 3  //如果存在dede_test表 
 4 //------------------- 
 5 //| 查询一条记录 | 
 6 //| GetOne() |
 7  //------------------- 
 8  $row = $dsql->GetOne("SELECT * FROM dede_test WHERE id = 3"); 
 9 print_r($row); } 
10 ?>

这里我们用了$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代码：

 1 <?php
 2  require_once (dirname(__FILE__) . "/include/common.inc.php"); if($dsql->IsTable(‘dede_test‘)){ 
 3 //如果存在dede_test表 
 4 //------------------- 
 5 //| 查询一条记录 |
 6  //| GetOne() | 
 7 //------------------- 
 8 // ↓
 9  $row = $dsql->GetOne("SELECT * FROM dede_test WHERE id = 3");
10  echo "查询id=3的记录:<br />显示结果:";
11  print_r($row);
12  //------------------- 
13 //| 查询多条记录 |
14  //| Execute() | 
15 //------------------- 
16 // ↓ 
17 echo "<hr />查询dede_test表中的所有记录:<br />显示结果:<br />"; 
18 $sql = "SELECT * FROM dede_test";
$dsql->Execute(‘me‘,$sql); while($arr = $dsql->GetArray(‘me‘)) {
19  echo "id = {$arr[‘id‘]} ,
20 name = {$arr[‘name‘]
21 }<br />";
22  }
23  }
24  ?>

运行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的。表单代码如下: 

<hr />
用于提交数据的表单:<br />
<form action="test.php" type="post"> 
<input type="hidden"name="dopost"value=http://blog.noniu.com/jiaocheng/"save">
 名称:

这里我们用了一个隐藏域dopost来存放操作方法，输入框name用来存放输入数据，然后传递给当前页面，再进行处理，这时候我们需要在test.php中加入部分的表单处理操作: 

//-------------------
 //| 表单处理过程 |
 //| Save() | 
//------------------- 
// ↓ 
empty($dopost)? "" : $dopost;
 if($dopost == "save"){
 //如果执行插入操作
 $sql = "INSERT INTO `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 "id = {$dbobj->id} ,name = {$dbobj->name} id}‘>[删除] ";//这里增加了一个删除的超链接 
}else{ 
echo "id = {$dbobj->id} ,name = {$dbobj->name} [删除]"; 
}
 }
 //下面是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数据库类操作的全部过程，如果有不明白的地方，可以去查看天涯版主的原文，原文的地址如下：http://www.dedecms.com/help/development/2009/1028/1076.html。链接：https://www.noniu.com/jiaocheng/dedecms-erci-shujuku.html