1. 主頁 > 幫助中心 > 程序開發 >

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

        來源:織夢官方 作者:天涯 發表于:2009-10-28 14:41  點擊:
        今天花點時間講解下織夢的sql數據庫類,近期本來是準備錄制一套視頻教程的,但由于視頻壓縮的問題遲遲沒有開展工作,如果大家有什么好的視頻壓縮方式可以通過郵件的方式告訴...
          注意:圖片為縮略圖,點擊看大圖.更清晰...

            今天花點時間講解下織夢的sql數據庫類,近期本來是準備錄制一套視頻教程的,但由于視頻壓縮的問題遲遲沒有開展工作,如果大家有什么好的視頻壓縮方式可以通過郵件的方式告訴我:tianya#dedecms.com(#<=>@).目前視頻主要想做成wmv或者rmvb這種格式的,里面含有ppt文檔以及課程的相關附件.

            其實數據庫類織夢之前就有一個介紹,http://help.dedecms.com/v53/archives/functions/db/,這篇文章講解了數據庫類的一些常見的使用方法,不過沒有結合例子去介紹,很多人估計看了還不是很懂,為了讓更多人理解織夢的數據庫使用類,并能夠運用到開發中,這里就來做個教程.

        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,比較簡單,這里不做冗述.

         

        (圖1)

        (圖2)



            這里需要注意的是,我們采用的是gbk版本的程序,所以數據表相關的編碼也要采用相應版本的編碼,在表的"選項"中設置為gbk相關.下面我將sql列出,如果懶得去創建表,可以在dedecms系統后臺的命令運行器中執行下:

         


        (圖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):

        (圖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).

         

        (圖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比較熟悉.今天我們就講解到這里了,下次有機會再結合datalist類和模板引擎來介紹織夢二次開發相關的內容.如果大家有什么好的學習織夢的意見或建議還希望給我電郵:tianya#dedecms.com(#<=>@).

         

        本次教程相關附件:

        課程附件下載

         

          有幫助
          (213)
          81.9%
          沒幫助
          (47)
          18.1%
        • 上一篇:{dede:field name='array' /}的簡單用法示范
        • 下一篇:沒有了
        • 2018宝宝说数特来算 土默特右旗| 江门市| 耒阳市| 苍溪县| 荔波县| 淳化县| 确山县| 周口市| 银川市| 融水| 麻城市| 郯城县| 垫江县| 河源市| 大邑县| 丘北县| 屯留县| 松桃| 凌源市| 合川市| 新昌县| 南投市| 津市市| 南部县| 河津市| 柞水县| 慈溪市| 全南县| 铜山县| 伽师县| 乌恰县| 陈巴尔虎旗| 道孚县| 且末县| 玉龙| 龙陵县| 苍梧县| 措美县| 沂源县| 永川市| 汉川市| http://v.sina7s15.pw http://china.sinaaco.pw http://www.ba7ma7.cn http://m.qgxrau.top http://www.an802.cn http://wap.lsj9pp.club