Dedesql数据库类详解(二次开发必备教程)

其实数据库类织梦之前就有一个介绍,http://help.dedecms.com/v53/archives/functions/db/,这篇文章讲解了数据库类的一些常见的使用方法,不过没有结合例子去介绍,很多人估计看了还不是很懂,为了让更多人理解织梦的数据库使用类,并能够运用到开发中,这里就来做个教程.

1.创建数据表
    在使用这个类之前,我们需要创建数据表,这里我们推荐几个数据库操作工具:PHPMyadmin,Navicat for MySQL,我这里以后者为例.
当然这里需要注意,在创建表的时候我们已经安装了一个DedeCMS程序,我们今天的操作是以DedeCMS程序扩展来讲解的.当然程序安装后他自己也会创建N多表,这些表以后再来介绍吧,或者也可以看看http://help.dedecms.com/v53/archives/extend/commontable/,这里有一些常用表的说明.

这里我们这个数据库叫dedebbs,表前缀用的默认的"dede_",我们用Navicat for MySQL来创建一个名为"dede_test"的表,里面就2个字段,1个id,作为唯一标识,另一个name作为名称(图1).然后往里面添加测试数据(图2),这个操作类似于Access或者EXCEL,比较简单,这里不做冗述.

(图1)

(图2)

这里需要注意的是,我们采用的是gbk版本的程序,所以数据表相关的编码也要采用相应版本的编码,在表的"选项"中设置为gbk相关.下面我将sql列出,如果懒得去创建表,可以在dedecms系统后台的命令运行器中执行下:

-- ----------------------------
-- 表 `dede_test`结构
-- ----------------------------
DROP TABLE IF EXISTS `dede_test`;
CREATE TABLE `dede_test` (
  `id` mediumint(8) NOT NULL AUTO_INCREMENT,
  `name` char(60) NOT NULL DEFAULT ‘‘,
  PRIMARY KEY (`id`)
) ENGINE=MyISAM AUTO_INCREMENT=5 DEFAULT CHARSET=gbk;

-- ----------------------------
-- 插入到 dede_test中的数据
-- ----------------------------
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.连接数据库,查询数据表
    表"dede_test"我们已经创建完成了,接下来我们要连接数据库了,其实方法非常简单.我们在网站根目录中创建一个test.php的文件,这个文件最好也用gbk的编码,可以用专门的编辑器来创建文件.

连接数据库最简单的方法就是引入include文件夹下面的common.inc.php文件,编辑php代码:
写入以下内容:

test.php

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

　　

上面代码就是将一个$dsql类输出,我们再执行下这个文件http://www.dedebbs.com/test.php(注dedebbs.com只是在本地做了个解析,其实就是localhost),我们查看源代码,看到下面的内容(图4):

(图4)

DedeSql Object
(
    [linkID] => Resource id #6
    [dbHost] => localhost
    [dbUser] => root
    [dbPwd] => 123456
    [dbName] => dedebbs
    [dbPrefix] => dede_
    [result] => Array
        (
            [me] => 0
        )

[queryString] => 
    [parameters] => Array
        (
        )

[isClose] => 
    [safeCheck] => 1
)

这个就说明我们已经成功连接数据库了,[dbHost],[dbUser]...这些都是数据库的相关信息,也就是我们保存在配置文件中的\data\common.inc.php内容,引入数据库类的时候,默认就被创建了$dsql或者$db,所以直接引入配置文件就可以了.

接下来我们来做一个简单的查询操作,接着上面的代码我们继续写
test.php

<?php
      require_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‘]来输出我们查询出来的结果

Tip:其实我们可以深入的研究下dedesql.class.php这个类,258行就有这个方法:

    //执行一个SQL语句,返回前一条记录或仅返回一条记录
    function GetOne($sql=‘‘,$acctype=MYSQL_ASSOC)
    {
        global $dsql;
		if(!$dsql->isInit)
		{
			$this->Init($this->pconnect);
		}
        if($dsql->isClose)
        {
            $this->Open(FALSE);
            $dsql->isClose = FALSE;
        }
        if(!empty($sql))
        {
            if(!preg_match("/LIMIT/i",$sql)) $this->SetQuery(preg_replace("/[,;]$/i", ‘‘, trim($sql))." LIMIT 0,1;");
            else $this->SetQuery($sql);
        }
        $this->Execute("one");
        $arr = $this->GetArray("one",$acctype);
        if(!is_array($arr))
        {
            return ‘‘;
        }
        else
        {
            @mysql_free_result($this->result["one"]); return($arr);
        }
    }

　　.深入查询,继续研究SELECT
    刚才讲了查询一条记录,其实这个查询一条记录可以理解为我们内容页查询一篇文章,只是获取单条记录并将内容显示出来,但往往我们经常遇到的是查询列表,及{dede:arclist/}或者{dede:list/},查询列表的话涉及到查询多条记录.

继续修改代码:
test.php

<?php
      require_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 = 测试名字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}<br />";
            }

  tips:这里查询完了其实还可以用$dsql->GetTotalRow("me")来获取下查询出来的总数.

4.插入删除,也要用到SQL
    上面我们介绍了如何用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中加入部分的表单处理操作:

        //-------------------
        //|    表单处理过程 |
        //|    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再将其传递给下一个页面以便高亮显示.

我们可以在编辑框中插入一条数据来测试下,看看插入数据后的返回结果(图5).

(图5)

其实删除的操作也是如此,我们只需要稍微做个修改就可以了,增加一个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();
      }

　　

  tips:这里用到了一个ShowMsg()函数,这个是用来返回一个对话框的,详细可以查看下\include\common.func.php的372行相关函数的代码.

这里我们结合了DedeCMS程序的dedesql类讲解了这个类的常见的用法,我们不难发现用这个类操作数据库是非常方便的,当然这个需要用户对sql比较熟悉.今天我们就讲解到这里了,下次有机会再结合datalist类和模板引擎来介绍织梦二次开发相关的内容.如果大家有什么好的学习织梦的意见或建议还希望给我电邮:tianya#dedecms.com(#<=>@).

来自：织梦官网：http://www.dedecms.com/help/development/2009/1028/1076.html

以上全部代码：

<?php
	  require_once (dirname(__FILE__) . "/include/common.inc.php");

		//-------------------
		//|    表单处理过程 |
		//|    Save()     |
		//-------------------
		//        ↓
	  empty($dopost)? "" : $dopost;
	  if($dopost == "save"){
	  	//如果执行插入操作
	  	$sql = "INSERT INTO `#@__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 `#@__test` WHERE (`id`=‘{$id}‘)";
	  	$dsql->ExecuteNoneQuery($sql);
	  	ShowMsg("成功删除一条记录内容！","test.php");
	  	exit();
	  }

	  if($dsql->IsTable(‘dede_test‘)){
	  	//如果存在dede_test表
	  	//-------------------
	  	//|    查询一条记录 |
	  	//|    GetOne()     |
	  	//-------------------
	  	//        ↓
	  	$row = $dsql->GetOne("SELECT * FROM #@__test WHERE id = 3");
	  	echo "查询id=3的记录:<br />显示结果:";
	  	print_r($row);
	  	//-------------------
	  	//|    查询多条记录 |
	  	//|    Execute()     |
	  	//-------------------
	  	//        ↓
	  	echo "<hr />查询dede_test表中的所有记录:<br />显示结果:<br />";
	  	$sql = "SELECT * FROM #@__test order by id desc";
			$dsql->Execute(‘me‘,$sql);
			/*
			while($arr = $dsql->GetArray(‘me‘))
			{
				echo "id = {$arr[‘id‘]} ,name = {$arr[‘name‘]}<br />";
			}
			*/
			//Or $dsql->GetObject("me")
			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 />";
				}
			}
			echo "总共查询".$dsql->GetTotalRow("me")."条记录";
	  }
?>

<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>

　　

原文地址：https://www.cnblogs.com/dreamboycx/p/12072021.html

时间： 2024-07-31 10:17:50

Dedesql数据库类详解(二次开发必备教程)的相关文章

Dedesql数据库类详解(二次开发必备教程)(转)

http://www.dedecms.com/help/development/2009/1028/1076.html 织梦DedeCMS的二次开发不仅仅是会写写织梦的标签,会制作织梦的模板.很多时候,我们需要对织梦DedeCMS的数据库进行查询.插入.删除等等之类的操作,进行这一类的操作之前,我们必须知道织梦DedeCMS的数据库类,No牛网整理了织梦天涯版主关于DedeCMS程序的dedesql类常见的用法讲解的文章,希望有朋友用的上. 1.创建数据表 为了让讲解更加的贴合实际,天涯版主创建

ecmall数据库表详解 二次开发必备

文章分类表ecm_acategory 字段 类型 Null 默认 注释 cate_id int(10) 否   自增ID号,分类ID号 cate_name varchar(100) 否   分类的名称 parent_id int(10) 否   分类的父级ID sort_order Tinyint(3) 否   分类排序数字标识 code varchar(10) 否   分类的代码标识 用户地址表(ecm_address) 字段 类型 Null 默认 注释 addr_id int(10) 否  

Dedesql数据库类详解

今天花点时间讲解下织梦的sql数据库类,近期本来是准备录制一套视频教程的,但由于视频压缩的问题迟迟没有开展工作,如果大家有什么好的视频压缩方式可以通过邮件的方式告诉我:tianya#dedecms.com(#<=>@).目前视频主要想做成wmv或者rmvb这种格式的,里面含有ppt文档以及课程的相关附件. 其实数据库类织梦之前就有一个介绍,http://help.dedecms.com/v53/archives/functions/db/,这篇文章讲解了数据库类的一些常见的使用方法,不过没有结

windows phone 8.1开发SQlite数据库操作详解

原文出自:http://www.bcmeng.com/windows-phone-sqlite1/ 本文小梦将和大家分享WP8.1中SQlite数据库的基本操作:(最后有整个示例的源码)(希望能通过本站广告支持小梦,谢谢!) 建立数据库 增加数据 删除数据 更改数据 查询数据 (注:为了让每个操作都能及时显示在UI上,所以进行了数据绑定.数据绑定会在后面文章专门讲解,先给出数据类Note,代表一个笔记.含有Name 和content  属性.其代码如下:如果不清楚,我会在之后讲解): names

Cocos2d之Node类详解之节点树（二）

一.声明 本文属于笔者原创,允许读者转载和分享,只要注明文章来源即可. 笔者使用cocos2d框架的cocos2d-x-3.3rc0版本的源代码做分析.这篇文章承接上篇<Cocos2d之Node类详解之节点树(一)>. 二.简介 节点 一个Node对象. 节点树 上篇文章介绍到,Node类有一个成员变量 Vector<Node*> _children,这是一个保存所有子节点的数组,因为Node类采用遍历树的方式获取子节点进行渲染,所以我管这两个东西的结合叫节点树. 三.源码详解 &

JAVAEE学习——struts2_01：简介、搭建、架构、配置、action类详解和练习:客户列表

一.struts2是什么 1.概念 2.struts2使用优势以及历史 二.搭建struts2框架 1.导包 (解压缩)struts2-blank.war就会看到 2.书写Action类 public class HelloAction { public String hello(){ System.out.println("hello world!"); return "success"; } } 3.书写src/struts.xml (记得加上dtd约束) &l

QAction类详解：

先贴一段描述:Qt文档原文: Detailed Description The QAction class provides an abstract user interface action that can be inserted into widgets. In applications many common commands can be invoked via menus, toolbar buttons, and keyboard shortcuts. Since the user

[转]详解C#组件开发的来龙去脉

C#组件开发首先要了解组件的功能,以及组件为什么会存在.在Visual Studio .NET环境下,将会有新形式的C#组件开发. 组件的功能 微软即将发布的 Visual Studio .NET 将使程序开发人员获得一个集成开发环境,它不但为开发传统的 C/C++ 应用程序,而且也为令人振奋的Microsoft .NET 组件提供了丰富的工具.这些以管理代码编写.在通用语言运行时构建的组件向开发人员提供了一个全新的混合开发环境,即象 Microsoft Visual Basic 一样容易,而同

Android技术18：Android中Adapter类详解

1.Adapter设计模式 Android中adapter接口有很多种实现,例如,ArrayAdapter,BaseAdapter,CursorAdapter,SimpleAdapter,SimpleCursorAdapter等,他们分别对应不同的数据源.例如,ArrayAdater对应List和数组数据源,而CursorAdapter对应Cursor对象(一般从数据库中获取的记录集).这些Adapter都需要getView方法返回当前列表项显示的View对象.当Model发生改变时,会调用Ba