Smarty實例教學 實例篇（三、使用ADODB連接數據庫）
前兩個月因為工作上的原因一直很忙,所以沒有及時完成這個教程,正好今天周六不用加班,抽個空完成它吧! 在開始新的的教程的時候,我
先把以前的我寫的那個教程中的一些錯誤的地方修改過來,在這裡要感謝 nesta2001zhang兄弟,是他找出了文章中的一些錯誤,否則真的被別人
罵"誤人子弟了"(說來真是慚愧,我的初稿發布後後就發現在一大堆的問題,後來一些時候發重新修改後的文件中居然也出現了錯誤,真是不應
該...)
在上幾篇教程中的：
=========================================================
while($db->next_record() && $i > 0)
{
$array[] = array("NewsID", csubstr($db->f("iNewsID"), 0, 20),
"NewsTitle", csubstr($db->f("vcNewsTitle"), 0, 20));
$i--;
}
=========================================================
應該更改為：
=========================================================
while($db->next_record() && $i > 0)
{
$array[] = array("NewsID" => $db->f("iNewsID"),
"NewsTitle" => csubstr($db->f("vcNewsTitle"), 0, 20));
$i--;
}
=========================================================
為什麼這樣改呢?因為第二種方法更清晰明了一些,實際上第一種方式所執行的效果與第二種方法沒什麼差別,而且那幾個程序我都曾經調試過,
沒有任何問題.
好了,那我們今天就先來說說ADODB.說到ADODB,可能做過ASP的都知道WINDOWS平台的ADO組件,但我們這裡的ADODB不是微軟的那個數據庫操
作組件,而是由php語言寫的一套數據庫操作類庫,先讓我們來看看它倒底有什麼樣的優點.
1. 以標准的SQL語句書寫的數據庫執行代碼在進行數據庫移植時不用更改源程序,也就是說它可以支持多種數據庫,包括ACCESS.
2. 提供與微軟ADODB相似的語法功能.這一點對於從ASP轉行到PHP的人們是一大福音,它的很多操作都與WINDOWS中的ADODB相似.
3. 可以生成Smarty循環需要的二維數組,這樣會簡化smarty開發.這一點是等會我給大家演示.
4. 支持數據庫的緩存查詢，最大可能的提高查詢數據庫的速度。
5. 其它的實用功能.
雖然說優點很多,但是由於這個類庫非常的龐大,光它的主執行類就107K,所以如果大家考慮執行效率的話就要認真想想了.不過說實話,它的
功能還是很強大的,有很多的很實用的功能,使用它的這些功能,可以非常方便的實現我們想要的功能.所以對於那些老板沒有特殊要求時大家不
防用用它
一、如何得到ADODB? 它的運行環境是什麼？
從http://sourceforge.net/project/show...簆hp4.0.5以上。
二、如何安裝ADODB?
解壓下載回的壓縮文件，注意：大家下載回來的格式為ADODB.tar.gz，這是linux的壓縮格式，在windows下大家可以使用winrar對其進
行解壓，解壓完成後將目錄拷貝到指定的目錄的adodb目錄下，像我在例子中將它拷貝到了/comm/adodb/中。
三、如何調用ADODB?
使用include_once ("./comm/adodb/adodb.inc.php");這行就不用說了吧？包含ADODB的主文件。
四、如何使用ADODB?
1.進行初始化：
ADODB采用$conn = ADONewConnection();這樣的語句進行初始化,對ADODB進行初始化有兩種方式：
第一種方式為：傳統方式。我暫時稱它為這個名稱。它使用的建立一個新連接的方式很像php中的標准連接方式：
$conn = new ADONewConnection($dbDriver);
$conn->Connect($host, $user, $passwd, $db);
簡單吧？如果使用過phplib中的db類應該對它很熟悉的。
第二種方式：采用dsn方式，這樣是將數據庫的連接語句寫成一條語句來進行初始化，dsn的寫法有為：$dsn =
"DBType://User:Passwd@Host/DBName"; 其中DBType表示數據庫類型，User表示用戶名，Passwd為密碼，Host為服務器名，DBName為數據庫名
，像這樣我使用oracle數據庫，用戶名：oracleUser,密碼為oraclePasswd,數據庫服務器為localhost, 數據庫為oradb的dsn這樣寫：
$dsn = "oracle://oracleUserraclePasswd@localhost/oradb";
$conn = new ADONewConnection($dsn);
這種方式可能從ASP轉行來的程序員會更感興趣。
這兩種方式都可以使用，要看個人習慣來選用了.
2. 相關的概念：
使用ADODB有兩個基本的類，一是是ADOConnection類，另一個是ADORecordSet類，使用過ASP的人看到這兩個類會明白它的含義，
ADOConnection指的是數據庫連接的類，而ADORecordSet指的是由ADOConnection執行查詢語句返回的數據集類，相關的資料大家可以查詢ADODB
類的手冊。
3.基本的函數：
關於ADOConnection類的相關方法有：
1.Connect：數據庫連接方法，上邊我們介紹過的。對於mysql還有PConnect，與PHP語言中的用法一樣
2.Execute($sql):執行查詢語句結果返回一個ADORecordSet類。
3.GetOne($sql):返回第一行的第一個字段
4.GetAll($sql):返回所有的數據。這個函數可是大有用處，記得不記的我在以前的教程中寫關於新聞列表的輸入時要將需要在頁面顯示的
新聞列表做成一個二維數組？就是這樣的語句：
=====================================================================================
while($db->next_record())
{
$array[] = array("NewsID" => $db->f("iNewsID"),
"NewsTitle" => csubstr($db->f("vcNewsTitle"), 0, 20));
}
=====================================================================================
這一行是什麼意思呢？就是將要顯示的新聞例表生成
$array[0] = array("NewsID"=>1, "NewsTitle"=>"這裡新聞的第一條");
$array[1] = array("NewsID"=>2, "NewsTitle"=>"這裡新聞的第二條");
...
這樣的形式，但如果我們不需要對標題進行控制，在ADODB中我們就有福了，我們可以這樣寫：
==================================================================================
$strQuery = "select iNews, vcNewsTitle from tb_news_ch";
$array = &$conn->GetAll($strQuery);//注意這條語句
$smarty->assign("News_CH", $array);
unset($array);
==================================================================================
當然，這裡的$conn應該進行初始化過了，不知大家看明白了沒有？原來我要手工創建的二維數據在這裡直接使用GetAll就行了！！！這也是為
什麼有人會說ADODB+Smarty是無敵組合的原因之一了...
4.SelectLimit($sql, $numrows=-1, $offset=-1, $inputarrr=false): 返回一個數據集，大家從語句上也不難看出它是一條限量查詢語
句，與mysql語句中的limit 有異曲同工之效，來一個簡單的例子：
$rs = $conn->SelectLimit("select iNewsID, vcNewsTitle from tb_news_CH", 5, 1);
看明白了嗎？$rs中保存的是數據庫中從第一記錄開始的5條記錄。我們知道，在oracle數據庫不支持在SQL語句中使用limit，但是我們如果使
用ADODB的話，那這個問題就容易解決多了！
5.Close():關閉數據庫，雖然說PHP在頁面結束時會自動關閉，但為了程序的完整大家還是要在頁面結束進行數據庫的關閉。
關於ADORecordSet.ADORecordSet為$conn->Execute($sql)返回的結果,它的基本函數如下:
1. Fields($colname):返回字段的值.
2. RecordCount():所包含的記錄數.這個記錄確定數據集的記錄總數.
3. GetMenu($name, [$default_str=''], [$blank1stItem=true], [$multiple_select=false], [$size=0], [$moreAttr=''])非常好的一
個函數,使用它可以返回一個name=$name的下拉菜單(或多選框)!!!當然,它是一個HTML的字符串,這是一個令人激動的好東西,$name指的是
option的name屬性,$default_str是默認選中的字串,$blank1stItem指出第一項是否為空,$multiple_select指出是否為多選框,而我們得到這個
字串後就可以使用$smarty->("TemplateVar", "GetMenuStr")來在模板的"TemplateVar" 處輸入一個下拉列表(或是多先框)
4. MoveNext():來看一段代碼:
=========================================================
$rs = &$conn->Exceute($sql);
if($rs)
{
while($rs->EOF)
{
$array[] = array("NewsID" => $rs->fields["iNewsID"],
"NewsTitle" => csubstr($rs->fields["vcNewsTitle"]), 0, 20);
$rs->MoveNext();
}
}
=========================================================
明白了嗎?很像MS ADODB中的那一套嘛!
5. MoveFirst(),MoveLast(), Move($to):一樣的,看函數名大家就可以知道它是什麼意思了.
6. FetchRow():返回一行,看代碼:
=========================================================
$rs = &$conn->Exceute($sql);
if($rs)
{
while($row = $rs->FetchRow())
{
$array[] = array("NewsID" => $row["iNewsID"],
"NewsTitle" => csubstr($row["vcNewsTitle"]), 0, 20);
}
}
=========================================================
它實現了與4一樣的功能,但看起來更符合PHP的習慣,而4的習慣看起來更像是MS ADODB的辦法．
7.GetArray($num):返回數據集中的$num行數據,將其組合成二維數組.這個方法我們在例子index.php要用到.
8. Close():同mysql_free_result($rs);清除內容占用.
好了,初步的函數就介紹到這裡,夠我們用的啦!實際上ADODB還有很多實用的技術,包括格式化日期時間,格式化查詢語句,輸出表格,更高級
點的Cache查詢,帶參查詢等等,大家可以自行查看手冊.
下面我們開始學習我們的程序,同樣還是那個Web程序,我將其中的comm目錄重新組織了一下,同時為了提高效率對Smarty重新進行了封裝
,mySmarty.class.php是封裝後的類,它繼承自Smarty,所以以後所有的程序文件中只調用新的類MySmarty,先來看看目錄結構:
+Web (站點根目錄)
|----+comm (Smarty相關文檔目錄)
| |----+smarty (Smarty原始文件目錄)
| |----+adodb (adodb原始文目錄)
| |-----mySmarty.class.php (擴展後的smarty文件)
| |-----csubstr.inc (截取中文字符)
|----+cache (Smarty緩存目錄，*nix下保證讀寫權限)
|----+templates (站點模板文件存放目錄)
| |----header.tpl(頁面頁頭模板文件)
| |----index.tpl(站點首頁模板文件)
| |----foot.tpl(頁面頁腳模板文件)
| |----news.tpl (新聞頁模板文件)
|
|----+templates_c (模板文件編譯後存放目錄，*nix下保證讀寫權限)
|----+css (站點CSS文件目錄)
|----+image (站點圖片目錄)
|----+media (站點Flash動畫存放目錄)
|----indexbak.htm (首頁原始效果圖)
|----newsbak,htm (新聞頁原始效果圖)
|----index.php (Smarty首頁程序文件)
|----news.php (Smarty新聞顯示文件)
|----newsList.php (顯示新聞列表)
|----例程說明.txt (本文檔)
相對於前兩個教程,有將comm目錄重新組織了一下,其它的文件結構沒有變化,整個站點相對於上兩個教程來講,改變的地方只有comm目錄與
index.php與news.php,同時增加了新聞列表,大家可以在index.php執行後的頁面中點擊"國內新聞","國際新聞", "娛樂新聞"來分別查看各自的
新聞列表, 我們先來看看index.php:
======================================================
index.php
======================================================
<?php
/*********************************************
*
* 文件名： index.php
* 作 用： 顯示實例程序
*
* 作 者： 大師兄
* Email： [email protected]
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的擴展類文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主執行文件
include_once("./comm/csubstr.inc"); //包含中文截取類
define ("NEWS_NUM", 5); //定義新聞列表顯示數目
$smarty = new MySmarty(); //建立smarty實例對象$smarty
1. $conn = ADONewConnection("mysql"); //初始化ADODB
2. $conn->Connect("localhost", "root", "", "News"); //連接數據庫
//這裡將處理國內新聞部分
3. $strQuery = "SELECT iNewsID AS NewsID, vcNewsTitle AS NewsTitle FROM tb_news_CH ORDER BY iNewsID DESC";
4. $rs = &$conn->Execute($strQuery);
5. $smarty->assign("News_CH", $rs->GetArray(NEWS_NUM));
6. unset($rs);
//這裡處理國際新聞部分
$strQuery = "SELECT iNewsID AS NewsID, vcNewsTitle AS NewsTitle FROM tb_news_IN ORDER BY iNewsID DESC";
$rs = &$conn->Execute($strQuery);
$smarty->assign("News_IN", $rs->GetArray(NEWS_NUM));
unset($rs);
//這裡將處理娛樂新聞部分
$strQuery = "SELECT iNewsID AS NewsID, vcNewsTitle AS NewsTitle FROM tb_news_MU ORDER BY iNewsID DESC";
$rs = &$conn->Execute($strQuery);
$smarty->assign("News_MU", $rs->GetArray(NEWS_NUM));
unset($rs);
7. $conn->close();
//編譯並顯示位於./templates下的index.tpl模板
$smarty->display("index.tpl");
?>
=============================================================================
同樣,我在關鍵的地方加了數標,下面來說明一下它們的含義:
1. 建立一個連接對象$conn,大家在這裡要注意的是它的初始不是以$conn = new ADONewConnection($dbType)這樣的形式出現的,也就是說
,ADONewConnection不是一個class,你不能使用new 對它進行初始化.看看它的源碼你就會明白,這只不過是一個函數.
2. 這個就不用說了吧?打開一個News的數據庫,主機為:localhost, 用戶名為root, 密碼為""
3. 一個查詢語句,注意,這裡要將查詢的字段使用AS關鍵字來重新標識,名稱為你在模板中設置的模板變量的名稱.
4. 使用Execute來執行這個查詢,結果返回一個RecordSet數據集
5. 這裡有個方法:$rs->GetArray($num) 這個在上邊介紹過,它是要從$rs這個數據集中返回$num行,結果為一個可被Smarty所識別的二維數
據.這樣ADODB就自動為我們構建起了這樣的結構,而在我們以前的例子中,都是使用一個循環構建這樣的數組的.
6. 這一句我看也不用說了吧?
7. 關閉內存中的相關資源.
大家可以看看,整個程序中再沒有出現什麼while語句,程序整體結構顯的非常清楚,這就是為什麼ADODB+Smarty是黃金組合的原因.不過話也
說回來了,簡單有簡單的問題,不知大家想過沒有,這裡對顯示的新聞標題的長度沒有控制,也就是說,如果某條新聞標題的長度超出一行顯示的范
圍,它就是自動折行到下一行,那麼整個的版面就會變亂,所說大家自已適自己的情況來決定是否這樣使用吧當然,你也可以使用像上一節中介
紹的那樣,使用一個循環語句重構這個二維數組,使它符合你的用途,怎麼做大家自己去想吧,參考PHPLIB中的做法,上節我介紹過了...
再來看看新聞頁吧
=============================================================
news.php
=============================================================
<?php
/*********************************************
*
* 文件名： news.php
* 作 用： 新聞顯示程序
*
* 作 者： 大師兄
* Email： [email protected]
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的擴展類文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主執行文件
$smarty = new MySmarty(); //建立smarty實例對象$smarty
$conn = ADONewConnection("mysql"); //初始化ADODB
$conn->Connect("localhost", "root", "", "News"); //連接數據庫
$NewsID = $_GET["id"]; //獲取新聞編號
$NewsType = $_GET["type"]; //要顯示的新聞類型
switch($NewsType)
{
case 1:
$dbName = "tb_news_CH";
break;
case 2:
$dbName = "tb_news_IN";
break;
case 3:
$dbName = "tb_news_MU";
break;
}
$strQuery = "SELECT vcNewsTitle AS NewsTitle, ltNewsContent AS NewsContent FROM " . $dbName;
1. $row = &$conn->GetRow($strQuery); //返回一個一維數組,下標為模板變量名
$smarty->display($row);
unset($row);
$conn->Close();
?>
=============================================================
說明一下關鍵的地方,其實在news.php中也只有一個地方值的說明一下了.
1. $conn->GetRow($strQuery):這一句返回一個一維數組,返回的形式為:
$array = ("NewsTitle"=>"xxxx", "NewsContent"=>"yyyyy...")
明白如果使用$smarty($array)後Smarty會干什麼嗎?對了,就是相當於:
$smarty->assign("NewsTitle", "xxxx");
$smarty->assign("NewsContent", "yyyyy...");
簡單吧,確實很簡單
下面再來看看新聞列表:
================================================================
newsList.php
================================================================
<?php
/*********************************************
*
* 文件名： newsList.php
* 作 用： 新聞列表顯示程序
*
* 作 者： 大師兄
* Email： [email protected]
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的擴展類文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主執行文件
$smarty = new MySmarty(); //建立smarty實例對象$smarty
$conn = ADONewConnection("mysql"); //初始化ADODB
$conn->Connect("localhost", "root", "", "News"); //連接數據庫
$NewsID = $_GET["id"]; //獲取新聞編號
$NewsType = $_GET["type"]; //要顯示的新聞類型
switch($NewsType)
{
case 1:
$tbName = "tb_news_CH";
break;
case 2:
$tbName = "tb_news_IN";
break;
case 3:
$tbName = "tb_news_MU";
break;
}
$strQuery = "SELECT iNewsID AS NewsID, vcNewsTitle AS NewsTitle FROM " . $tbName;
1. $rs = &$conn->GetAll($strQuery);
2. $smarty->assign("NewsType", $NewsType); //這一句為新聞列表中的鏈接服務
3. $smarty->assign("NewsList", $rs);
unset($rs);
$conn->close();
$smarty->display("newsList.tpl");
?>
================================================================
分別來說明一下:
1. GetAll($strQuery):這個函數可是個好東東,它的作用是將$strQuery查詢到的所有數據組合成為一個能夠被Smarty所識別的二維數組,
記住:它返回的是一個二維數組而不是一個RecordSet,所在你可以程序中直接在3處使用.
2. 這裡是為了給新聞標題做鏈接時要GET參數type=XX而做的
後記:
大家在使用ADODB時有幾個地方要注意:
1. 初始化: 初始化的方式不是使用new,因為它不是一個對象
2. 方 法: 基本上每個方法都是以大寫字母開頭大小寫混合的名稱,這一點好像與*NIX的習慣有些不同,也不同於PHP的整體風格,所以
注意這裡的大小寫問題.
好了,這個Smarty的系列教程到這裡就基本已經完成了,我的這幾篇初級教程就算是拋磚引玉吧,希望更多的高手將更多的經驗寫出來,大家
共同提高!因為公司不允許開QQ,如果大家有想要與我進行交流的話,請大家加我的MSN:[email protected],歡迎大家一起討論!
（出處：Viphot）
