DedeCMS数据库类常用函数说明

昨天整理了一下自己在使用织梦DedeCMS常用到的一些数据库类函数,大致有以下几种:

首先说一下数据库类文件位置:/include/dedesql.class.php(mysql)或/include/dedesqli.class.php(mysqli)

系统会自动载入 dedesql.class.php文件,并用$dsql = $db = new DedeSql(FALSE);初始化数据库连接,因此我们不需要再单独初始化这个类,可以直接用$dsql或$db进行操作。

DEDECMS提示:为了防止错误,操作完后不必关闭数据库。

数据库类中常用到的方法

1.获取错误描述:

 

$error = $dsql->GetError();

返回值为错误描述信息

2.执行一个不返回结果的SQL语句,如update,delete,insert等

 

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

返回值为SQL语句是否执行成功(TRUE/FALSE)

该方法可以用ExecNoneQuery()替代,它实际上执行的也是ExecuteNoneQuery()

3.执行一个返回影响记录条数的SQL语句,如update,delete,insert等

 

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

与上面相比,它返回的是SQL语句影响的记录数,而不是布尔值

4.执行一个SQL语句,返回前一条记录或仅返回一条记录

 

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

即使你的SQL语句中没有写Limit,系统也会自动为其加上limit 0,1。

下面是GetOne()中为其加上limit的语句:

 

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

5.执行条件查询(select)语句

 

$dsql->SetQuery($sql);

$dsql->Execute();

while($arr = $dsql->GetArray()){

    //这里对查询结果进行操作

}

上面的写法可以简化为:

 

$dsql->Execute("me",$sql);

while($arr = $dsql->GetArray()){

    //这里对查询结果进行操作

}

GetArray()的定义(Line:383)

 

function GetArray($rsid="me",$acctype=MYSQL_ASSOC);

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

 

$dsql->Execute("q1",$sql1);

while($arr = $dsql->GetArray("q1")){

    $dsql->Execute("q2",$dsql2);

    while($arr2 = $dsql->GetArray("q2")){

        //这里对查询结果进行操作

    }

}

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

 

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

返回值为布尔值

7.获取MySql的版本号

 

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

返回值为双精度浮点数

8.获取查询的总记录数

 

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

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

 

$id = $dsql->GetLastID();

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

 

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

$dsql->FreeResultAll();//(释放所有记录集资源)

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

 

$dsql->SetQuery($sql);

$dsql->SetSql($sql);//(功能一样)

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

 

$dsql->SelectDB($dbname);

13.获取数据库连接标识

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/263cd076b3f68b47eba464f7226eb601.html