找回密码
 立即注册

QQ登录

只需一步,快速开始

查看: 2746|回复: 2

[分享] 织梦二次开发必备教程-Dedesql数据库类详解大全

[复制链接]
发表于 2018-7-3 07:53:41 | 显示全部楼层 |阅读模式 来自 河南省新乡市
讲解下织梦的sql数据库类,近期本来是准备录制一套视频教程的,但由于视频压缩的问题迟迟没有开展工作,如果大家有什么好的视频压缩方式可以通过邮件的方式告诉我.目前视频主要想做成wmv或者rmvb这种格式的,里面含有ppt文档以及课程的相关附件.

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

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

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


    这里需要注意的是,我们采用的是gbk版本的程序,所以数据表相关的编码也要采用相应版本的编码,在表的"选项"中设置为gbk相关.下面我将sql列出,如果懒得去创建表,可以在dedecms系统后台的命令运行器中执行下:
3.gif
(图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.genban.org/test.php(注genban.org只是在本地做了个解析,其实就是localhost),我们查看源代码,看到下面的内容(图4):
4.gif
(图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语句会传送回来一个数组.我们运行php网站源码test.php看下运行结果:
Array
(
    [id] => 3
    [name] => 第三个喽
)
    这个说明我们查询dede_test这个表id为3的数据成功了,返回了一个$row数组,其中就存放了字段的值.
当然我们可以用echo $row['name'];或者$row['id']来输出我们查询出来的结果

Tip:其实我们可以深入的研究下dedesql.class.php这个类,258行就有这个方法:
  1.     //执行一个SQL语句,返回前一条记录或仅返回一条记录
  2.     function GetOne($sql='',$acctype=MYSQL_ASSOC)
  3.     {
  4.         global $dsql;
  5.         if($dsql->isClose)
  6.         {
  7.             $this->Open(false);
  8.             $dsql->isClose = false;
  9.         }
  10.         if(!empty($sql))
  11.         {
  12.             if(!eregi("limit",$sql)) $this->SetQuery(eregi_replace("[,;][        DISCUZ_CODE_0        ]quot;,'',trim($sql))." limit 0,1;");//这里用正则看看limit是否存在,如果不存在的话就自动加上limit 0,1这个内容,关于limit的介绍可以去看看SQL关于这个的介绍
  13.             else $this->SetQuery($sql);
  14.         }
  15.         $this->Execute("one");
  16.         $arr = $this->GetArray("one",$acctype);
  17.         if(!is_array($arr))
  18.         {
  19.             return '';
  20.         }
  21.         else
  22.         {
  23.             @mysql_free_result($this->result["one"]); return($arr);//清空资源,返回这个数组
  24.         }
  25.     }
复制代码


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

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

--------------------------------

我们运行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来调用查询出来的数据
         
  1. while($dbobj = $dsql->GetObject('me'))
  2.             {
  3.                 echo "id = {$dbobj->id} ,name = {$dbobj->name}<br />";
  4.             }
复制代码
  tips:这里查询完了其实还可以用$dsql->GetTotalRow("me")来获取下查询出来的总数.


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

    先来了解下插入数据库的操作,我们先做一个表单,这个表单用于提交数据name的.表单代码如下:
<hr />
用于提交数据的表单:<br />
  1. <form action="test.php" type="post">
  2.     <input type="hidden" name="dopost" value="save">
  3.     名称:<input type="text" name="name" value="">
  4.     <input name="提交" type="submit" value="提交">
  5. </form>
复制代码


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

  1.         //-------------------
  2.         //|    表单处理过程 |
  3.         //|    Save()     |
  4.         //-------------------
  5.         //        ↓
  6.       empty($dopost)? "" : $dopost;
  7.       if($dopost == "save"){
  8.           //如果执行插入操作
  9.           $sql = "INSERT INTO `dede_test` (`name`) VALUES ('{$name}')";
  10.           $dsql->ExecuteNoneQuery($sql); //执行这个插入语句
  11.           $lastInsertID = $dsql->GetLastID(); //获取插入后的最后的ID,然后再传给下一个页面
  12.           ShowMsg("成功增加一条记录内容!","test.php?id={$lastInsertID}");
  13.           exit();
  14.       }
复制代码


    这里主要是一个INSERT INTO 语句,然后通过$dsql的ExecuteNoneQuery方法来执行这个操作,并且获取插入数据最后一个id再将其传递给下一个页面以便高亮显示.

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


    其实删除的操作也是如此,我们只需要稍微做个修改就可以了,增加一个dopost操作为del的判断,然后在显示数据后面增加一个超链接,将id以get方式进行传递.并最后进行处理.

    下面是我们修改循环查询输出的部分内容,有如下修改:
  1.             while($dbobj = $dsql->GetObject('me'))
  2.             {
  3.                 if($id==$dbobj->id){
  4.                   //如果传递的id值和查询值相同,则高亮显示最后一条插入记录
  5.                     echo "<font color='red'>id = {$dbobj->id} ,name = {$dbobj->name}</font> <a href='test.php?dopost=del&id={$dbobj->id}'>[删除]</a>    <br />";//这里增加了一个删除的超链接
  6.                 }else{
  7.                     echo "id = {$dbobj->id} ,name = {$dbobj->name} <a href='test.php?dopost=del&id={$dbobj->id}'>[删除]</a><br />";
  8.                 }
  9.             }
复制代码


下面是del这个post的判断:
  1.       empty($dopost)? "" : $dopost;
  2.       if($dopost == "save"){
  3.           //如果执行插入操作
  4.           $sql = "INSERT INTO `dede_test` (`name`) VALUES ('{$name}')";
  5.           $dsql->ExecuteNoneQuery($sql);
  6.           $lastInsertID = $dsql->GetLastID();
  7.           ShowMsg("成功增加一条记录内容!","test.php?id={$lastInsertID}");
  8.           exit();
  9.       }elseif($dopost == "del"){
  10.           //如果dopost为del,则删除数据
  11.           $id = isset($id) && is_numeric($id) ? $id : 0;
  12.           $sql = "DELETE FROM `dede_test` WHERE (`id`='{$id}')";
  13.           $dsql->ExecuteNoneQuery($sql);
  14.           ShowMsg("成功删除一条记录内容!","test.php");
  15.           exit();
  16.       }
复制代码
  tips:这里用到了一个ShowMsg()函数,这个是用来返回一个对话框的,详细可以查看下\include\common.func.php的372行相关函数的代码.

   这里我们结合了DedeCMS程序的dedesql类讲解了这个类的常见的用法,我们不难发现用这个类操作数据库是非常方便的,当然这个需要用户对sql比较熟悉.今天我们就讲解到这里了,下次有机会再结合datalist类和模板引擎来介绍织梦二次开发相关的内容.

发帖求助前要善用【论坛搜索】功能,那里可能会有你要找的答案;

如何回报帮助你解决问题的坛友,好办法就是点击帖子下方的评分按钮给对方加【金币】不会扣除自己的积分,做一个热心并受欢迎的人!

发表于 2018-7-3 15:37:34 | 显示全部楼层 来自 内蒙古呼和浩特市
感谢分享,收藏了

发帖求助前要善用【论坛搜索】功能,那里可能会有你要找的答案;

如何回报帮助你解决问题的坛友,好办法就是点击帖子下方的评分按钮给对方加【金币】不会扣除自己的积分,做一个热心并受欢迎的人!

回复 支持 反对

使用道具 举报

发表于 2018-7-4 09:52:03 | 显示全部楼层 来自 江苏省苏州市
数据库这部分还不是很懂,先mark一下,用到的时候回来再看

发帖求助前要善用【论坛搜索】功能,那里可能会有你要找的答案;

如何回报帮助你解决问题的坛友,好办法就是点击帖子下方的评分按钮给对方加【金币】不会扣除自己的积分,做一个热心并受欢迎的人!

回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则 需要先绑定手机号

关闭

站长推荐上一条 /1 下一条

QQ|侵权投诉|广告报价|手机版|小黑屋|西部数码代理|飘仙建站论坛 ( 豫ICP备2022021143号-1 )

GMT+8, 2024-3-29 13:57 , Processed in 0.054529 second(s), 8 queries , Redis On.

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表