Smarty實例教學(xué) 實例篇（三、使用ADODB連接數(shù)據(jù)庫）

前兩個月因為工作上的原因一直很忙,所以沒有及時完成這個教程,正好今天周六不用加班,抽個空完成它吧! 在開始新的的教程的時候,我

先把以前的我寫的那個教程中的一些錯誤的地方修改過來,在這里要感謝 nesta2001zhang兄弟,是他找出了文章中的一些錯誤,否則真的被別人

罵"誤人子弟了"(說來真是慚愧,我的初稿發(fā)布后后就發(fā)現(xiàn)在一大堆的問題,后來一些時候發(fā)重新修改后的文件中居然也出現(xiàn)了錯誤,真是不應(yīng)

該...)
在上幾篇教程中的：
=========================================================
while($db->next_record() && $i > 0)
{
$array[] = array("NewsID", csubstr($db->f("iNewsID"), 0, 20),
"NewsTitle", csubstr($db->f("vcNewsTitle"), 0, 20));

$i--;
}
=========================================================
應(yīng)該更改為：
=========================================================
while($db->next_record() && $i > 0)
{
$array[] = array("NewsID" => $db->f("iNewsID"),
"NewsTitle" => csubstr($db->f("vcNewsTitle"), 0, 20));

$i--;
}
=========================================================
為什么這樣改呢?因為第二種方法更清晰明了一些,實際上第一種方式所執(zhí)行的效果與第二種方法沒什么差別,而且那幾個程序我都曾經(jīng)調(diào)試過,

沒有任何問題.
好了,那我們今天就先來說說ADODB.說到ADODB,可能做過ASP的都知道WINDOWS平臺的ADO組件,但我們這里的ADODB不是微軟的那個數(shù)據(jù)庫操

作組件,而是由php語言寫的一套數(shù)據(jù)庫操作類庫,先讓我們來看看它倒底有什么樣的優(yōu)點(diǎn).
1. 以標(biāo)準(zhǔn)的SQL語句書寫的數(shù)據(jù)庫執(zhí)行代碼在進(jìn)行數(shù)據(jù)庫移植時不用更改源程序,也就是說它可以支持多種數(shù)據(jù)庫,包括ACCESS.
2. 提供與微軟ADODB相似的語法功能.這一點(diǎn)對于從ASP轉(zhuǎn)行到PHP的人們是一大福音,它的很多操作都與WINDOWS中的ADODB相似.
3. 可以生成Smarty循環(huán)需要的二維數(shù)組,這樣會簡化smarty開發(fā).這一點(diǎn)是等會我給大家演示.
4. 支持?jǐn)?shù)據(jù)庫的緩存查詢，最大可能的提高查詢數(shù)據(jù)庫的速度。
5. 其它的實用功能.
雖然說優(yōu)點(diǎn)很多,但是由于這個類庫非常的龐大,光它的主執(zhí)行類就107K,所以如果大家考慮執(zhí)行效率的話就要認(rèn)真想想了.不過說實話,它的

功能還是很強(qiáng)大的,有很多的很實用的功能,使用它的這些功能,可以非常方便的實現(xiàn)我們想要的功能.所以對于那些老板沒有特殊要求時大家不

防用用它

一、如何得到ADODB? 它的運(yùn)行環(huán)境是什么？
從http://sourceforge.net/project/show...簆hp4.0.5以上。
二、如何安裝ADODB?
解壓下載回的壓縮文件，注意：大家下載回來的格式為ADODB.tar.gz，這是linux的壓縮格式，在windows下大家可以使用winrar對其進(jìn)

行解壓，解壓完成后將目錄拷貝到指定的目錄的adodb目錄下，像我在例子中將它拷貝到了/comm/adodb/中。
三、如何調(diào)用ADODB?
使用include_once ("./comm/adodb/adodb.inc.php");這行就不用說了吧？包含ADODB的主文件。
四、如何使用ADODB?
1.進(jìn)行初始化：
ADODB采用$conn = ADONewConnection();這樣的語句進(jìn)行初始化,對ADODB進(jìn)行初始化有兩種方式：
第一種方式為：傳統(tǒng)方式。我暫時稱它為這個名稱。它使用的建立一個新連接的方式很像php中的標(biāo)準(zhǔn)連接方式：
$conn = new ADONewConnection($dbDriver);
$conn->Connect($host, $user, $passwd, $db);
簡單吧？如果使用過phplib中的db類應(yīng)該對它很熟悉的。

第二種方式：采用dsn方式，這樣是將數(shù)據(jù)庫的連接語句寫成一條語句來進(jìn)行初始化，dsn的寫法有為：$dsn =

"DBType://User:Passwd@Host/DBName"; 其中DBType表示數(shù)據(jù)庫類型，User表示用戶名，Passwd為密碼，Host為服務(wù)器名，DBName為數(shù)據(jù)庫名

，像這樣我使用oracle數(shù)據(jù)庫，用戶名：oracleUser,密碼為oraclePasswd,數(shù)據(jù)庫服務(wù)器為localhost, 數(shù)據(jù)庫為oradb的dsn這樣寫：
$dsn = "oracle://oracleUserraclePasswd@localhost/oradb";
$conn = new ADONewConnection($dsn);
這種方式可能從ASP轉(zhuǎn)行來的程序員會更感興趣。

這兩種方式都可以使用，要看個人習(xí)慣來選用了.

2. 相關(guān)的概念：
使用ADODB有兩個基本的類，一是是ADOConnection類，另一個是ADORecordSet類，使用過ASP的人看到這兩個類會明白它的含義，

ADOConnection指的是數(shù)據(jù)庫連接的類，而ADORecordSet指的是由ADOConnection執(zhí)行查詢語句返回的數(shù)據(jù)集類，相關(guān)的資料大家可以查詢ADODB

類的手冊。

3.基本的函數(shù)：

關(guān)于ADOConnection類的相關(guān)方法有：
1.Connect：數(shù)據(jù)庫連接方法，上邊我們介紹過的。對于mysql還有PConnect，與PHP語言中的用法一樣
2.Execute($sql):執(zhí)行查詢語句結(jié)果返回一個ADORecordSet類。
3.GetOne($sql):返回第一行的第一個字段
4.GetAll($sql):返回所有的數(shù)據(jù)。這個函數(shù)可是大有用處，記得不記的我在以前的教程中寫關(guān)于新聞列表的輸入時要將需要在頁面顯示的

新聞列表做成一個二維數(shù)組？就是這樣的語句：
=====================================================================================
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"=>"這里新聞的第二條");
...
這樣的形式，但如果我們不需要對標(biāo)題進(jìn)行控制，在ADODB中我們就有福了，我們可以這樣寫：
==================================================================================
$strQuery = "select iNews, vcNewsTitle from tb_news_ch";
$array = &$conn->GetAll($strQuery);//注意這條語句
$smarty->assign("News_CH", $array);
unset($array);
==================================================================================
當(dāng)然，這里的$conn應(yīng)該進(jìn)行初始化過了，不知大家看明白了沒有？原來我要手工創(chuàng)建的二維數(shù)據(jù)在這里直接使用GetAll就行了！??！這也是為

什么有人會說ADODB+Smarty是無敵組合的原因之一了...
4.SelectLimit($sql, $numrows=-1, $offset=-1, $inputarrr=false): 返回一個數(shù)據(jù)集，大家從語句上也不難看出它是一條限量查詢語

句，與mysql語句中的limit 有異曲同工之效，來一個簡單的例子：
$rs = $conn->SelectLimit("select iNewsID, vcNewsTitle from tb_news_CH", 5, 1);
看明白了嗎？$rs中保存的是數(shù)據(jù)庫中從第一記錄開始的5條記錄。我們知道，在oracle數(shù)據(jù)庫不支持在SQL語句中使用limit，但是我們?nèi)绻?

用ADODB的話，那這個問題就容易解決多了！
5.Close():關(guān)閉數(shù)據(jù)庫，雖然說PHP在頁面結(jié)束時會自動關(guān)閉，但為了程序的完整大家還是要在頁面結(jié)束進(jìn)行數(shù)據(jù)庫的關(guān)閉。

關(guān)于ADORecordSet.ADORecordSet為$conn->Execute($sql)返回的結(jié)果,它的基本函數(shù)如下:
1. Fields($colname):返回字段的值.
2. RecordCount():所包含的記錄數(shù).這個記錄確定數(shù)據(jù)集的記錄總數(shù).
3. GetMenu($name, [$default_str=''], [$blank1stItem=true], [$multiple_select=false], [$size=0], [$moreAttr=''])非常好的一

個函數(shù),使用它可以返回一個name=$name的下拉菜單(或多選框)!!!當(dāng)然,它是一個HTML的字符串,這是一個令人激動的好東西,$name指的是

option的name屬性,$default_str是默認(rèn)選中的字串,$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):一樣的,看函數(shù)名大家就可以知道它是什么意思了.
6. FetchRow():返回一行,看代碼:
=========================================================
$rs = &$conn->Exceute($sql);
if($rs)
{
while($row = $rs->FetchRow())
{
$array[] = array("NewsID" => $row["iNewsID"],
"NewsTitle" => csubstr($row["vcNewsTitle"]), 0, 20);
}
}
=========================================================
它實現(xiàn)了與4一樣的功能,但看起來更符合PHP的習(xí)慣,而4的習(xí)慣看起來更像是MS ADODB的辦法．

7.GetArray($num):返回數(shù)據(jù)集中的$num行數(shù)據(jù),將其組合成二維數(shù)組.這個方法我們在例子index.php要用到.

8. Close():同mysql_free_result($rs);清除內(nèi)容占用.

好了,初步的函數(shù)就介紹到這里,夠我們用的啦!實際上ADODB還有很多實用的技術(shù),包括格式化日期時間,格式化查詢語句,輸出表格,更高級

點(diǎn)的Cache查詢,帶參查詢等等,大家可以自行查看手冊.

下面我們開始學(xué)習(xí)我們的程序,同樣還是那個Web程序,我將其中的comm目錄重新組織了一下,同時為了提高效率對Smarty重新進(jìn)行了封裝

,mySmarty.class.php是封裝后的類,它繼承自Smarty,所以以后所有的程序文件中只調(diào)用新的類MySmarty,先來看看目錄結(jié)構(gòu):
+Web (站點(diǎn)根目錄)

|----+comm (Smarty相關(guān)文檔目錄)

| |----+smarty (Smarty原始文件目錄)
| |----+adodb (adodb原始文目錄)
| |-----mySmarty.class.php (擴(kuò)展后的smarty文件)
| |-----csubstr.inc (截取中文字符)

|----+cache (Smarty緩存目錄，*nix下保證讀寫權(quán)限)

|----+templates (站點(diǎn)模板文件存放目錄)

| |----header.tpl(頁面頁頭模板文件)
| |----index.tpl(站點(diǎn)首頁模板文件)
| |----foot.tpl(頁面頁腳模板文件)
| |----news.tpl (新聞頁模板文件)

|
|----+templates_c (模板文件編譯后存放目錄，*nix下保證讀寫權(quán)限)

|----+css (站點(diǎn)CSS文件目錄)

|----+image (站點(diǎn)圖片目錄)

|----+media (站點(diǎn)Flash動畫存放目錄)

|----indexbak.htm (首頁原始效果圖)

|----newsbak,htm (新聞頁原始效果圖)

|----index.php (Smarty首頁程序文件)

|----news.php (Smarty新聞顯示文件)

|----newsList.php (顯示新聞列表)

|----例程說明.txt (本文檔)

相對于前兩個教程,有將comm目錄重新組織了一下,其它的文件結(jié)構(gòu)沒有變化,整個站點(diǎn)相對于上兩個教程來講,改變的地方只有comm目錄與

index.php與news.php,同時增加了新聞列表,大家可以在index.php執(zhí)行后的頁面中點(diǎn)擊"國內(nèi)新聞","國際新聞", "娛樂新聞"來分別查看各自的

新聞列表, 我們先來看看index.php:

======================================================
index.php
======================================================
<?php
/*********************************************
*
* 文件名： index.php
* 作 用： 顯示實例程序
*
* 作 者： 大師兄
* Email： teacherli@163.com
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的擴(kuò)展類文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主執(zhí)行文件
include_once("./comm/csubstr.inc"); //包含中文截取類

define ("NEWS_NUM", 5); //定義新聞列表顯示數(shù)目

$smarty = new MySmarty(); //建立smarty實例對象$smarty

1. $conn = ADONewConnection("mysql"); //初始化ADODB
2. $conn->Connect("localhost", "root", "", "News"); //連接數(shù)據(jù)庫


//這里將處理國內(nèi)新聞部分
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");
?>
=============================================================================
同樣,我在關(guān)鍵的地方加了數(shù)標(biāo),下面來說明一下它們的含義:

1. 建立一個連接對象$conn,大家在這里要注意的是它的初始不是以$conn = new ADONewConnection($dbType)這樣的形式出現(xiàn)的,也就是說

,ADONewConnection不是一個class,你不能使用new 對它進(jìn)行初始化.看看它的源碼你就會明白,這只不過是一個函數(shù).

2. 這個就不用說了吧?打開一個News的數(shù)據(jù)庫,主機(jī)為:localhost, 用戶名為root, 密碼為""

3. 一個查詢語句,注意,這里要將查詢的字段使用AS關(guān)鍵字來重新標(biāo)識,名稱為你在模板中設(shè)置的模板變量的名稱.

4. 使用Execute來執(zhí)行這個查詢,結(jié)果返回一個RecordSet數(shù)據(jù)集

5. 這里有個方法:$rs->GetArray($num) 這個在上邊介紹過,它是要從$rs這個數(shù)據(jù)集中返回$num行,結(jié)果為一個可被Smarty所識別的二維數(shù)

據(jù).這樣ADODB就自動為我們構(gòu)建起了這樣的結(jié)構(gòu),而在我們以前的例子中,都是使用一個循環(huán)構(gòu)建這樣的數(shù)組的.

6. 這一句我看也不用說了吧?

7. 關(guān)閉內(nèi)存中的相關(guān)資源.

大家可以看看,整個程序中再沒有出現(xiàn)什么while語句,程序整體結(jié)構(gòu)顯的非常清楚,這就是為什么ADODB+Smarty是黃金組合的原因.不過話也

說回來了,簡單有簡單的問題,不知大家想過沒有,這里對顯示的新聞標(biāo)題的長度沒有控制,也就是說,如果某條新聞標(biāo)題的長度超出一行顯示的范

圍,它就是自動折行到下一行,那么整個的版面就會變亂,所說大家自已適自己的情況來決定是否這樣使用吧當(dāng)然,你也可以使用像上一節(jié)中介

紹的那樣,使用一個循環(huán)語句重構(gòu)這個二維數(shù)組,使它符合你的用途,怎么做大家自己去想吧,參考PHPLIB中的做法,上節(jié)我介紹過了...

再來看看新聞頁吧

=============================================================
news.php
=============================================================
<?php
/*********************************************
*
* 文件名： news.php
* 作 用： 新聞顯示程序
*
* 作 者： 大師兄
* Email： teacherli@163.com
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的擴(kuò)展類文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主執(zhí)行文件

$smarty = new MySmarty(); //建立smarty實例對象$smarty

$conn = ADONewConnection("mysql"); //初始化ADODB
$conn->Connect("localhost", "root", "", "News"); //連接數(shù)據(jù)庫

$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); //返回一個一維數(shù)組,下標(biāo)為模板變量名

$smarty->display($row);
unset($row);

$conn->Close();
?>
=============================================================
說明一下關(guān)鍵的地方,其實在news.php中也只有一個地方值的說明一下了.

1. $conn->GetRow($strQuery):這一句返回一個一維數(shù)組,返回的形式為:

$array = ("NewsTitle"=>"xxxx", "NewsContent"=>"yyyyy...")
明白如果使用$smarty($array)后Smarty會干什么嗎?對了,就是相當(dāng)于:
$smarty->assign("NewsTitle", "xxxx");
$smarty->assign("NewsContent", "yyyyy...");

簡單吧,確實很簡單

下面再來看看新聞列表:
================================================================
newsList.php
================================================================
<?php
/*********************************************
*
* 文件名： newsList.php
* 作 用： 新聞列表顯示程序
*
* 作 者： 大師兄
* Email： teacherli@163.com
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的擴(kuò)展類文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主執(zhí)行文件

$smarty = new MySmarty(); //建立smarty實例對象$smarty

$conn = ADONewConnection("mysql"); //初始化ADODB
$conn->Connect("localhost", "root", "", "News"); //連接數(shù)據(jù)庫

$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); //這一句為新聞列表中的鏈接服務(wù)
3. $smarty->assign("NewsList", $rs);
unset($rs);
$conn->close();

$smarty->display("newsList.tpl");
?>
================================================================
分別來說明一下:

1. GetAll($strQuery):這個函數(shù)可是個好東東,它的作用是將$strQuery查詢到的所有數(shù)據(jù)組合成為一個能夠被Smarty所識別的二維數(shù)組,

記住:它返回的是一個二維數(shù)組而不是一個RecordSet,所在你可以程序中直接在3處使用.
2. 這里是為了給新聞標(biāo)題做鏈接時要GET參數(shù)type=XX而做的

后記:
大家在使用ADODB時有幾個地方要注意:
1. 初始化: 初始化的方式不是使用new,因為它不是一個對象
2. 方 法: 基本上每個方法都是以大寫字母開頭大小寫混合的名稱,這一點(diǎn)好像與*NIX的習(xí)慣有些不同,也不同于PHP的整體風(fēng)格,所以

注意這里的大小寫問題.

好了,這個Smarty的系列教程到這里就基本已經(jīng)完成了,我的這幾篇初級教程就算是拋磚引玉吧,希望更多的高手將更多的經(jīng)驗寫出來,大家

共同提高!因為公司不允許開QQ,如果大家有想要與我進(jìn)行交流的話,請大家加我的MSN:teacherli@ceua.org,歡迎大家一起討論!

（出處：Viphot）