【dedecms二次开发教程】dedecms二次开发教程Dedesql数据库类详解

更新时间:2019-11-30 来源:应用教程 点击:

【www.hzclsc.cn--应用教程】

  注意:图片为缩略图,点击看大图.更清晰...

  今天花点时间讲解下织梦的sql数据库类,近期本来是准备录制一套视频教程的,但由于视频压缩的问题迟迟没有开展工作,如果大家有什么好的视频压缩方式可以通过邮件的方式告诉我:tianya#dedecms.com(# = @).目前视频主要想做成wmv或者rmvb这种格式的,里面含有ppt文档以及课程的相关附件.

  其实数据库类织梦之前就有一个介绍,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系统后台的命令运行器中执行下:


(图3)


-- ----------------------------
-- 表 `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- isClose)
    {
      $this- Open(false);
      $dsql- isClose = false;
    }
    if(!empty($sql))
    {
      if(!eregi( limit ,$sql)) $this- SetQuery(eregi_replace( [,;]$ , ,trim($sql)). limit 0,1; //这里用正则看看limit是否存在,如果不存在的话就自动加上limit 0,1这个内容,关于limit的介绍可以去看看SQL关于这个的介绍
      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);//清空资源,返回这个数组
    }
  }


3.深入查询,继续研究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的记录:
显示结果:
      print_r($row);
      //-------------------
      //|  查询多条记录 |
      //|  Execute()  |
      //-------------------
      //  ↓
      echo

查询dede_test表中的所有记录:
显示结果:

      $sql = SELECT * FROM dede_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}

      }
 

 

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



4.插入删除,也要用到SQL
  上面我们介绍了如何用dsql来查询数据,主要有获取单条记录和获取多条记录2种,接下来我们来了解下使用dsql其他特性来为我们的test.php加入添加内容和删除内容的功能.

  先来了解下插入数据库的操作,我们先做一个表单,这个表单用于提交数据name的.表单代码如下:


用于提交数据的表单:


 
  名称:
 



  这里我们用了一个隐藏域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 id = {$dbobj- id} ,name = {$dbobj- name} id} [删除] 
//这里增加了一个删除的超链接
        }else{
          echo id = {$dbobj- id} ,name = {$dbobj- name} id} [删除]

        }
      }

下面是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.hzclsc.cn/anzhuo/42055.html

为您推荐

支付宝怎么自动还信用卡还款_支付宝怎么自动还信用卡 支付宝设置信用卡自动还款教程

支付宝可以对信用卡还款进行管理,有些办了信用卡的童鞋,还不知道支付宝怎么自动还信用卡,通过设置我们可以实现支付宝信用卡自动还款,省时省力,下面带来设置详细教程。支付宝怎么自动还信用卡? 进入支付宝,点教你一招

2020-12-14 07:03:59   支付宝可以自动还信用卡吗   支付宝如何自动还款信用卡   支付宝怎么自动还款信用卡  

【炼金与魔法按键怎么用】炼金与魔法按键怎么操作 炼金与魔法按键操作方法介绍

炼金与魔法是一款国产沙盒游戏,游戏的操作并不难,但是游戏中没有独立的按键使用教程,很多玩家不清楚如何操作,下面为大家带来炼金与魔法按键操作方法介绍。炼金与魔法按键操作方法介绍独立游戏

2020-12-13 23:04:59  

【王冠之心怎么样】王冠之心怎么联机 王冠之心联机教程

王冠之心(Heart of Crown PC)是一款卡牌策略类型的游戏,那么玩家该怎么联机进行游戏呢?下面就来分享一下王冠之心联机教程。王冠之心联机教程准备工作,把skip open port che策略与战棋

2020-12-13 07:06:08   王冠怎么折   手工王冠怎么做   银色王冠怎么用  

网易白金卡潮玩版|网易白金卡是什么 网易白金卡怎么激活

网易白金卡是什么?网易与中国联通联合推出了手机号码品牌网易白金卡,让用户可以免流量使用网易全系应用。现在炉石传说已经加入白金卡免流套餐!下面就一起来看看网易白金卡怎么激活吧。什么是网易白金卡网易白金卡游戏资讯

2020-12-12 11:04:25   网易白金卡免流范围   网易白金卡官网  

中国快递|中国快充标准详细介绍 中国手机快充技术介绍一览

手机快充技术发展已经有几年了,各家厂商的技术也不一样,在泰尔论坛2017快充技术标准与应用研讨会上,带来了中国首部快充标准《通信终端快速充电技术要求和测试方法》,下面一起来看下中国快充标准详细介绍!2知识加油站

2020-12-12 11:04:25   中国快递协会   中国快递公司排行榜   中国快餐连锁50强品牌