dedecms二次開發之數據庫類詳解

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，比較簡單，這裏不做冗述。

下載 (119.31 KB)

2009-10-29 11:48

圖1

下載 (40.45 KB)

2009-10-29 11:48

圖2
這裏需要注意的是，我們採用的是gbk版本的程序，所以數據表相關的編碼也要採用相應版本的編碼，在表的“選項”中設置爲gbk相關。下面我將sql列出，如果懶得去創建表，可以在dedecms系統後臺的命令運行器中執行下：

下載 (17.72 KB)

2009-10-29 11:48

圖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）：

下載 (35.82 KB)

2009-10-29 11:48

圖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的記錄:<br />顯示結果:";
      print_r($row);
      //-------------------
      //| 查詢多條記錄 |
      //| Execute()     |
      //-------------------
      //        ↓
      echo "<hr />查詢dede_test表中的所有記錄:<br />顯示結果:<br />";
      $sql = "SELECT * FROM dede_test";
         $dsql->Execute('me',$sql);
         while($arr = $dsql->GetArray('me'))
         {
            echo "id = {$arr['id']} ,name = {$arr['name']}<br />";
         }
   }
?>
--------------------------------

我們運行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}<br />";
         }

tips：這裏查詢完了其實還可以用$dsql->GetTotalRow（“me”）來獲取下查詢出來的總數。

4.插入刪除，也要用到SQL

上面我們介紹瞭如何用dsql來查詢數據，主要有獲取單條記錄和獲取多條記錄2種，接下來我們來了解下使用dsql其他特性來爲我們的test.php加入添加內容和刪除內容的功能。

先來了解下插入數據庫的操作，我們先做一個表單，這個表單用於提交數據name的。表單代碼如下：

<hr />

用於提交數據的表單：<br />

<form action="test.php" type="post">
<input type="hidden" name="dopost" value="save">
名稱:<input type="text" name="name" value="">
<input name="提交" type="submit" value="提交">
</form>

這裏我們用了一個隱藏域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）。

下載 (17.22 KB)

2009-10-29 11:48

圖5

其實刪除的操作也是如此，我們只需要稍微做個修改就可以了，增加一個dopost操作爲del的判斷，然後在顯示數據後面增加一個超鏈接，將id以get方式進行傳遞。並最後進行處理。

下面是我們修改循環查詢輸出的部分內容，有如下修改：

   while($dbobj = $dsql->GetObject('me'))
         {
            if($id==$dbobj->id){
               //如果傳遞的id值和查詢值相同,則高亮顯示最後一條插入記錄
                   echo "<font color='red'>id = {$dbobj->id} ,name = {$dbobj->name}</font> <a href='test.php?dopost=del&id={$dbobj->id}'>[刪除]</a> <br />";//這裏增加了一個刪除的超鏈接
            }else{
                   echo "id = {$dbobj->id} ,name = {$dbobj->name} <a href='test.php?dopost=del&id={$dbobj->id}'>[刪除]</a>< br />";
            }
         }

下面是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比較熟悉。