DedeCMS数据库类常用函数说明

天外飘仙

昨天整理了一下自己在使用DedeCMS时常用到的一些数据库类函数，大致有以下几种：
首先说一下数据库类文件位置：/include/dedesql.class.php(mysql)或/include/dedesqli.class.php(mysqli)
系统会自动载入 dedesql.class.php文件，并用$dsql = $db = new DedeSql(FALSE);初始化数据库连接，因此我们不需要再单独初始化这个类，可以直接用$dsql或$db进行操作。
DEDECMS提示：为了防止错误，操作完后不必关闭数据库。
数据库类中常用到的方法
1.获取错误描述：

1. $error = $dsql->GetError();

复制代码

返回值为错误描述信息
2.执行一个不返回结果的SQL语句，如update,delete,insert等

1. $result = $dsql->ExecuteNoneQuery($sql);

复制代码

返回值为SQL语句是否执行成功(TRUE/FALSE)
该方法可以用ExecNoneQuery()替代，它实际上执行的也是ExecuteNoneQuery()
3.执行一个返回影响记录条数的SQL语句，如update,delete,insert等

1. $result = $dsql->ExecuteNoneQuery2($sql);

复制代码

与上面相比，它返回的是SQL语句影响的记录数，而不是布尔值
4.执行一个SQL语句,返回前一条记录或仅返回一条记录

1. $result = $dsql->GetOne($sql);

复制代码

即使你的SQL语句中没有写Limit，系统也会自动为其加上limit 0,1。
下面是GetOne()中为其加上limit的语句：

1. if(!preg_match("/LIMIT/i",$sql)) $this->SetQuery(preg_replace("/[,;]$/i", '', trim($sql))." LIMIT 0,1;");

复制代码

5.执行条件查询（select）语句

1. $dsql->SetQuery($sql);
   
2. $dsql->Execute();
   
3. while($arr = $dsql->GetArray()){
   
4.     //这里对查询结果进行操作
   
5. }

复制代码

上面的写法可以简化为：

1. $dsql->Execute("me",$sql);
   
2. while($arr = $dsql->GetArray()){
   
3.     //这里对查询结果进行操作
   
4. }

复制代码

GetArray()的定义(Line:383)

1. function GetArray($rsid="me",$acctype=MYSQL_ASSOC)；

复制代码

其中”me”($rsid)被称为记录集游标，用来区分不同的查询，当$rsid为”me”的时候，GetArray()的参数可以省略，否则必须给出参数$rsid。如：

1. $dsql->Execute("q1",$sql1);
   
2. while($arr = $dsql->GetArray("q1")){
   
3.     $dsql->Execute("q2",$dsql2);
   
4.     while($arr2 = $dsql->GetArray("q2")){
   
5.         //这里对查询结果进行操作
   
6.     }
   
7. }

复制代码

6.检查某数据表是否存在

1. $result = $dsql->IsTable($tbname);

复制代码

返回值为布尔值
7.获取MySql的版本号

1. $version = $dsql->GetVersion($isformat=TRUE)

复制代码

返回值为双精度浮点数
8.获取查询的总记录数

1. $num = $dsql->GetTotalRow($rsid="me");

复制代码

9.获取上一步INSERT操作产生的ID

1. $id = $dsql->GetLastID();

复制代码

10.释放记录集占用的资源

1. $dsql->FreeResult($rsid="me");//(释放游标为"me"的记录集资源)
   
2. $dsql->FreeResultAll();//(释放所有记录集资源)

复制代码

11.设置SQL语句，会自动把SQL语句里的dede_替换为$this->dbPrefix(在配置文件中为$cfg_dbprefix)

1. $dsql->SetQuery($sql);
   
2. $dsql->SetSql($sql);//(功能一样)

复制代码

12.重新选择要操作的数据库

1. $dsql->SelectDB($dbname);

复制代码

13.获取数据库连接标识

1. $dsql->linkID;

复制代码

获取这个连接标识后，可以直接用mysql相关函数进行数据库操作，在非不得已情况，项目中一般不使用这个变量。