織夢DedeCMS的二次開發不僅僅是會寫寫織夢的標簽,會制作織夢的模板。很多時候,我們需要對織夢DedeCMS的數據庫進行查詢、插入、刪除等等之類的操作,進行這一類的操作之前,我們必須知道織夢DedeCMS的數據庫類,No牛網整理了織夢天涯版主關于DedeCMS程序的dedesql類常見的用法講解的文章,希望有朋友用的上。
1.創建數據表
為了讓講解更加的貼合實際,天涯版主創建了一個名為"dede_test"的表,里面就2個字段,1個id,作為唯一標識,另一個name作為名稱。然后往里面添加測試數據,這個操作類似于Access或者EXCEL,比較簡單,這里不做冗述。
使用如下的SQL語句插入一些數據供操作使用:
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文件即可??梢栽诰W站根目錄中創建一個test.php的文件來進行相關的測試操作,在這個文件中寫入如下的代碼:
<?php require_once (dirname(__FILE__) . "/include/common.inc.php"); print_r($dsql); ?>
在瀏覽器中運行之后,查看源代碼就可以得到如下圖所示的代碼:
這個就說明我們已經成功連接數據庫了,[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']來輸出我們查詢出來的結果。
3.查詢數據庫
剛才講了查詢一條記錄,其實這個查詢一條記錄可以理解為我們內容頁查詢一篇文章,只是獲取單條記錄并將內容顯示出來,但往往我們經常遇到的是查詢列表,及{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 />"; }
4.插入刪除操作數據庫
上面我們介紹了如何用dsql來查詢數據,主要有獲取單條記錄和獲取多條記錄2種,接下來我們來了解下使用dsql其他特性來為我們的test.php加入添加內容和刪除內容的功能。先來了解下插入數據庫的操作,我們先做一個表單,這個表單用于提交數據name的。表單代碼如下:
<hr /> 用于提交數據的表單:<br /> <form action="test.php" type="post"> <input type="hidden" name="dopost" value=http://blog.noniu.com/jiaocheng/"save"> 名稱:
這里我們用了一個隱藏域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再將其傳遞給下一個頁面以便高亮顯示。我們可以在編輯框中插入一條數據來測試下,看看插入數據后的返回結果:
其實刪除的操作也是如此,我們只需要稍微做個修改就可以了,增加一個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=http://blog.noniu.com/jiaocheng/'test.php?dopost=del&id={$dbobj->id}'>[刪除]
";//這里增加了一個刪除的超鏈接 }else{ echo "id = {$dbobj->id} ,name = {$dbobj->name} [刪除]
"; } } //下面是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。