Dedesql數據庫類詳解(二次開發必備教程)(轉)

http://www.dedecms.com/help/development/2009/1028/1076.html

織夢DedeCMS的二次開發不僅僅是會寫寫織夢的標簽，會制作織夢的模板。很多時候，我們需要對織夢DedeCMS的數據庫進行查詢、插入、刪除等等之類的操作，進行這一類的操作之前，我們必須知道織夢DedeCMS的數據庫類，No牛網整理了織夢天涯版主關于DedeCMS程序的dedesql類常見的用法講解的文章，希望有朋友用的上。

1.創建數據表

為了讓講解更加的貼合實際，天涯版主創建了一個名為"dede_test"的表，里面就2個字段，1個id，作為唯一標識，另一個name作為名稱。然后往里面添加測試數據，這個操作類似于Access或者EXCEL，比較簡單，這里不做冗述。

?

使用如下的SQL語句插入一些數據供操作使用：

1	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.連接數據庫

在對織夢DedeCMS的數據庫進行操作之前，當然是先連接數據庫了，方法非常簡單。只需要在操作的文件中引入include文件夾下面的common.inc.php文件即可。可以在網站根目錄中創建一個test.php的文件來進行相關的測試操作，在這個文件中寫入如下的代碼：

1	<!--?php??????? require_once (dirname(__FILE__) . "/include/common.inc.php");??????? print_r($dsql);?-->

在瀏覽器中運行之后，查看源代碼就可以得到如下圖所示的代碼：

這個就說明我們已經成功連接數據庫了，[dbHost],[dbUser]...這些都是數據庫的相關信息，也就是我們保存在配置文件中的\data\common.inc.php內容，引入數據庫類的時候，默認就被創建了$dsql或者$db，所以直接引入配置文件就可以了。

接下來做一個簡單的查詢操作，接著上面的代碼我們繼續寫test.php文件，代碼如下：

1

<!--?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看到如下運行結果：

1	Array(??? [id] => 3??? [name] => 第三個嘍)

這個說明我們查詢dede_test這個表id為3的數據成功了，返回了一個$row數組，其中就存放了字段的值。當然我們可以用echo $row['name'];或者$row['id']來輸出我們查詢出來的結果。

3.查詢數據庫

剛才講了查詢一條記錄，其實這個查詢一條記錄可以理解為我們內容頁查詢一篇文章，只是獲取單條記錄并將內容顯示出來，但往往我們經常遇到的是查詢列表，及{dede:arclist/}或者{dede:list/}，查詢列表的話涉及到查詢多條記錄。

繼續修改test.php代碼：

1

<!--?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看到顯示以下的內容:

1	查詢dede_test表中的所有記錄:顯示結果:id = 1 ,name = 測試名字1id = 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'))??????????? {??????????????? echo "id = {$dbobj->id} ,name = {$dbobj->name}<br>";??????????? }

4.插入刪除操作數據庫

上面我們介紹了如何用dsql來查詢數據，主要有獲取單條記錄和獲取多條記錄2種，接下來我們來了解下使用dsql其他特性來為我們的test.php加入添加內容和刪除內容的功能。先來了解下插入數據庫的操作，我們先做一個表單，這個表單用于提交數據name的。表單代碼如下:

1	<hr>用于提交數據的表單:<br><form action="test.php" type="post">??? <input name="dopost" type="hidden" value="save">??? 名稱:<input name="name" type="text" value="">??? <input name="提交" type="submit" value="提交"></form>

這里我們用了一個隱藏域dopost來存放操作方法，輸入框name用來存放輸入數據，然后傳遞給當前頁面，再進行處理，這時候我們需要在test.php中加入部分的表單處理操作:

1

//-------------------??????? //|??? 表單處理過程 |??????? //|??? 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再將其傳遞給下一個頁面以便高亮顯示。我們可以在編輯框中插入一條數據來測試下，看看插入數據后的返回結果：

其實刪除的操作也是如此，我們只需要稍微做個修改就可以了，增加一個dopost操作為del的判斷，然后在顯示數據后面增加一個超鏈接，將id以get方式進行傳遞.并最后進行處理。下面是我們修改循環查詢輸出的部分內容，有如下修改:

1

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();????? }

以上就是織夢DedeCMS數據庫類操作的全部過程，如果有不明白的地方，可以去查看天涯版主的原文，原文的地址如下：http://www.dedecms.com/help/development/2009/1028/1076.html。