卓越飞翔博客卓越飞翔博客

卓越飞翔 - 您值得收藏的技术分享站
技术文章64334本站已运行4115

Dedecms二次开发sql数据库类详解

今天花点时间讲解下织梦的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,比较简单,这里不搞冗述.

这里需要特别注意的就是,我们采用的是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):

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]...这些都就是数据库的相关信息,也就是我们保存在配置文件中的datacommon.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值和查询值相同,则CT8325BBP表明最后一条填入记录
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()函数,这个是用以回到一个对话框的,详细可以查看之下includecommon.func.php的372行相关函数的代码.    

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

卓越飞翔博客
上一篇: 畅言去广告JS本地文件方法
下一篇: 织梦CMS管理员帐号密码忘记了怎么办?
留言与评论(共有 0 条评论)
   
验证码:
隐藏边栏