ADODB用法详解
我們可以使用GetAll方法代替Execute()方法，該方法返回的結果為一個二維關聯數據，這樣可以使用foreach或for循環語句處理，非常方便。另外，GetAll取得的數組與Smarty模板的foreach配合得非常好。
我們一起看下面的腳本例子：
<?php
include_once("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "root", "library") or die("Unable to connect");
// 構造并執行一個查詢
$query = "SELECT * FROM library";
$result = $db->GetAll($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 清除無用的對象
$db->Close();
// 可以使用print_r打印該數組的內容
// print_r($result); exit(0);
// 遍歷記錄集，顯示列的內容：TITLE 和AUTHOR
foreach ($result as $row){
?? echo $row[1] . " - " . $row[2] . "\n";
}
// 取得和顯示返回的記錄行數
echo "\n[" . sizeof($result) . " 行記錄被返回]\n";
?>
GetAll()方法取得記錄集后，產生一個二維數組，類似于下面的樣子：
Array
(
[0] => Array
(
[0] => 14
[id] => 14
[1] => Mystic River
[title] => Mystic River
[2] => Dennis Lehane
[author] => Dennis Lehane
)
[1] => Array
(
[0] => 15
[id] => 15
[1] => For Kicks
[title] => For Kicks
[2] => Dick Francis
[author] => Dick Francis
)
?? //下略
)
我們在數組一章，提到過這類混合數組最適合用foreach來處理。這種方法是對Execute()方法的補充或替代，尤其適合在遍歷查詢整個表時使用。
另外，ADODB還提供取得一條記錄的方法：GetOne()。
2．GetOne()方法ADODB有個比較直接的方法可以比較方便地檢測某條記錄是否存在，那就是它的GetOne($sql)方法。
該方法返回查詢記錄的第1條第1個字段名的值，如果執行過程中出現錯誤，則返回布爾值false。
我們可以檢測這個值是否存在：
<?php
Include_once("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", “root”, “passwd”, “adodb”) or die("Unable to connect!");
$rs = $db->GetOne("SELECT * FROM library WHERE id='$id'");
if($rs){
echo '記錄存在';
}else {
?? echo '記錄不存在';
}
?>
不過這樣有一個問題是，如果數據表中id=$id的記錄有多條，不僅僅要知道是否存在有這樣一條記錄，還要把這條記錄提取出來，則可以使用ADODB的GetRow()方法。
3．GetRow()方法<?php
Include_once("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", “root”, “passwd”, “adodb”) or die("Unable to connect!");
$rs = $db->GetRow("SELECT * FROM library WHERE id='$id'");
if(is_array($rs)){
?? echo '記錄存在';
?? print_r($rs);
} else {
?? echo '記錄不存在';
}
?>
需要注意的是，GetOne($sql) 和 GetRow($sql) 都能得到一條特定的記錄，或者得到該記錄不存在的信息，但是如果符合查詢條件的記錄存在多條時，則這兩個方法只傳回第一條記錄，其他的都自動拋棄。
如果只要得到查詢結果的行數，則可以使用結果集方法中的RecordCount()方法。
4．取得返回的記錄行數ADODB還提供了一批實用功能，如在進行查詢時，提供了非常有用的RecordCount() 和FieldCount()方法，分別返回記錄的數量和字段的數量，以下是應用這兩個方法的例子。
<?php
include("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", “root”, “passwd”, “adodb”) or die("Unable to connect!");
// 構造并執行一個查詢
$query = "SELECT * FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 取得和顯示返回的記錄行數
echo $result->RecordCount() . " 行記錄被返回\n";
// 取得和顯示返回的字段個數
echo $result->FieldCount() . " 個字段被返回\n";
// clea up
$db->Close();
?>
我們可以使用FetchField()方法取得字段的信息，其中含有該字段的詳細資料，包括名稱和類型等，請看如下的腳本例子。
<?php
include("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");?
// 打開一個數據庫連接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 構造并執行一個查詢
$query = "SELECT * FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 取得記錄集中字段的結構信息
for($x=0; $x<$result->FieldCount(); $x++){
?? print_r($result->FetchField($x));
}
// 清理無用的對象
$db->Close();
?>
下面輸出的是有關id字段的結構信息。
stdClass myMagicbject
(
[name] => id
[table] => library
[def] =>
[max_length] => 3
[not_null] => 1
[primary_key] => 1
[multiple_key] => 0
[unique_key] => 0
[numeric] => 1
[blob] => 0
[type] => int
[unsigned] => 1
[zerofill] => 0
[binary] =>
)
5．其他相關方法當執行一個INSERT查詢時，如果該表的主鍵是一個自動增量的字段，則可以使用ADODB的insert_id()方法，來獲得最后數據插入時自動產生的增量值。
<?php
include_once(“libs/adodb/adodb.inc.php”);
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", “root”, “root”, “adodb”) or die("Unable to connect!");
// 構造并執行INSERT插入操作
$title = $db->qstr("PHP5與MySQL5 Web開發技術詳解");
$author = $db->qstr("杜江");
$query = "INSERT INTO library (title, author) VALUES ($title, $author)";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 顯示插入的記錄號
if ($result){
?? echo "最后插入的記錄ID： " . $db->Insert_ID();
}
// 清理無用的對象
$db->Close();
?>
腳本中的qstr()方法，功能是過濾SQL查詢中的非法字符。
執行后，即無論查詢（SELECT）、刪除（DELETE）或修改（UPDATE）數據，如果想知道是否對表有影響，可以使用affected_rows()方法，它可以告訴我們操作后有多少（記錄）行受到了影響。請看下面的腳本例子：
<?php
include_once("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", “root”, “root”, “adodb”) or die("Unable to connect!");
// 構造并執行一個查詢
$query = "DELETE FROM library WHERE author = 'J. Luser'";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 取得和顯示執行后影響的記錄行數
if ($result){
?? echo $db->Affected_Rows() . " 行已被刪除";
}
// 清理無用的對象
$db->Close();
?>
上面 我們討論了如何通過使用一個數據庫庫函數使應用程序更簡潔，更易于移植。比如從MS SQL Server轉移到MySQL，在MS SQL Server中使用指令“SELECT TOP 15 name FROM employee”取得數據的前15條，可在MySQL中卻不支持這種寫法，而要寫成：SELECT name FROM employee LIMIT 15。
它似乎對我們敲響了警鐘，應該停止在查詢語句中使用非標準SQL指令，而去認真地學習標準的SQL。
幸運的是，ADODB有一個處理 LIMIT的方法：SelectLimit()，這樣我們就根本不用管連接的是MySQL還是MS SQL Server，ADODB會在底層為我們自動轉換，請見下面的腳本例子：
<?php
include_once("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 構造并執行一個查詢
// 我們要取得5行記錄，從符合記錄的第3行開始取
$query = "SELECT * FROM library";
$result = $db->SelectLimit($query, 5, 3) or die("Error in query: $query. " . $db->ErrorMsg());
// 遍歷記錄集
while (!$result->EOF) {
?? echo $result->fields[1] . " - " . $result->fields[2] . "\n";
$result->MoveNext();
}
// 清理無用的對象
$db->Close();
?>
在這個例子中，selectlimit()方法類似于MySQL的LIMIT語句，可用于控制從某行開始查詢，到某行的結果，從而取得我們指定的記錄集。
我們可以利用ADODB提供的MetaDatabases()方法取得當前服務器中所有數據庫的清單。還有一個方法和它很類似，即使用MetaTables()方法可以取得當前庫中所有表的清單。請看下面的例子：
<?php
include(“libs/adodb/adodb.inc.php”);
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 取得數據列表
echo "數據庫:\n";
foreach($db->MetaDatabases() as $d){
?? echo "* $d\n";???
}
// 取得數據表清單
echo "\n當前數據庫下的表:\n";
foreach($db->MetaTables() as $table){
?? echo "* $table\n";???
}
// 清理無用的對象
$db->Close();
?>
有時，我們需要對一些不同的值做一些特殊的查詢，比如一系列的INSERT（插入）語句。ADODB類提供了兩個方法，可以使我們既節約時間又節省系統的開銷，請看如下示例：
<?php
include(“libs/adodb/adodb.inc.php”);
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 構造準備查詢，使用參數綁定
$query = $db->Prepare("INSERT INTO library (title, author) VALUES (?, ?)");
// 從CSV 中取得要插入的標題和作者名稱
$data = file("./book_list.csv");
// 遍歷該文件，并執行插入操作
foreach ($data as $l){
?? $arr = explode(",", $l);
?? // 插入值并綁定準備語句
?? $result = $db->Execute($query, array($arr[0], $arr[1])) or die("Error in query: $query. " . $db->ErrorMsg());
}
// 清理無用的對象
$db->Close;
?>
prepare()函數，把一個SQL查詢作為參數，讀取一個查詢，但并不立即執行。prepare()返回一個句柄給一個prepare查詢，當保存和傳遞給Execute()方法后，則立即執行該查詢。
8．處理事務處理事務是許多應用程序的一個重要的特征（比如，錢從你的賬戶轉出，然后轉入到某個人的賬戶中。只要其中任意一步操作失敗，這整個過程都必須被認定為失敗。不然，錢被劃出，而沒有進對方的賬戶；或者，錢沒有劃出，但對方賬戶無端多了一筆錢）。
處理事務可以在代碼級上進行機警地管理控制。常數錯誤檢查被用來判斷執行COMMIT（事務的所有各項都正確，執行正確，結束事務）還是執行ROLLBACK（事務中有錯誤，所有改動需要恢復原來狀況）。
現在的數據庫系統絕大多數都支持事務，如MySQL、Oracle、MS SQL Server等，ADODB提供一個非常好的功能，能夠讓你更透明地使用這一特性。請看下面的例子：
<?php
include(“libs/adodb/adodb.inc.php”);
// 創建一個mysql連接實例對
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", “root”, “root”, “adodb”) or die("Unable to connect!");
//關閉auto-commit自動提交事務
// 開始事務處理語句塊
$db->BeginTrans();
// 第一次查詢
$query = "INSERT INTO library (title, author) VALUES ('測試用書', '佚名')";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
//使用第一次查詢返回的ID號
if ($result){
?? $id = $db->Insert_ID();
?? $query = "INSERT INTO purchase_info (id, price) VALUES ($id, 'RMB 31.9')";
?? $result = $db->Execute($query)
or die("Error in query: $query. " . $db->ErrorMsg());
}
// 如果操作成功
if ($result){
?? // 事務提交
?? $db->CommitTrans();
}// 否則回滾
else{
?? $db->RollbackTrans();
}
// 清理無用的對象
$db->Close;
?>
該腳本首先 需要關掉數據庫的auto commit功能，通過begintrans()方法來處理，這種方法也標志著一個事務的開始。可以使用CommitTrans()或 RollbackTrans()函數來處理操作，一旦auto commit已經關掉，你就可以任意執行所需要的查詢，確認事務的查詢執行無誤并完畢后，由我們自己決定何時執行commit操作。
每一 次執行Execute()事務塊后，它會返回一個布爾值，告訴我們是否成功地執行了查詢。可以跟蹤到這個值，以及使用的時間，以決定是否要進行整個交易行 為。一旦你相信一切都沒問題，則告訴數據庫committrans()方法；如果發現有錯誤發生，則可以進行回滾操作——執行 rollbacktrans()方法。
值得注意的是，注意您的數據庫類型是否支持這些事務函數，前面已經說過，MySQL的InnoDB類型表支持事務，但是MyISAM類型并不支持。
9．使用緩存查詢在一個動態頁面中，如果其中的一個查詢指令很少改變且頻繁被執行，我們則可以使用ADODB的緩存功能，可以將查詢指令的結果緩存成靜態文件，從而提高PHP腳本的性能。
當試圖通過緩存來提高你的應用程序的性能之前，建議先去優化查詢指令再開始本操作，這樣才會起到事半功倍之效果。
ADODB最棒的功能就是提供查詢緩存的功能。緩存可以大大改善應用程序的性能，尤其是網站系統，因為大部分用戶都是在瀏覽網站，數據庫完成的任務多半是查詢（SELECT操作）。為了更好地理解與應用緩存查詢的功能，我們來看下面的腳本例子。
<?php
include_once("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "root", "adodb") or die("Unable to connect!");
// 構造并執行一個查詢
$query = "SELECT * FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 遍歷返回的記錄集，顯示列數據的內容 TITLE 和 AUTHOR
while (!$result->EOF) {
?? echo $result->fields[1] . " - " . $result->fields[2] . "\n";
?? $result->MoveNext();
}
// 顯示取得的記錄行數
echo "\n[" . $result->RecordCount() . " 行記錄被返回]\n";
// 關閉數據庫連接
$db->Close();
?>
這段代碼使用ADODB進行一個SELECT操作。比如說，這就是您的網站，平均有每分鐘5000次的點擊（PV，Page View）量，那么數據庫系統每小時至少要被查詢3萬次以上，可以想象，這對我們的MySQL數據庫的負載是相當繁重的。
因此ADODB提供了緩存的功能，可以將經常查詢的結果保存起來，進而降低數據庫服務器的負荷，同時也向用戶提供更快速的內容響應。
下面是修改上面的腳本，改為使用CacheExecute來進行緩存查詢的示例：
<?php
include("libs/adodb/adodb.inc.php");
//設置緩存保存的路徑，.表示當前目錄
$ADODB_CACHE_DIR = '.'; //為了管理方便，實際開發環境請指向到獨立的目錄中，如/tmp/adodb
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 構造并執行一個查詢
$query = "SELECT * FROM library";
$result = $db->CacheExecute(300,$query) or die("Error in query: $query. " . $db->ErrorMsg());
// 遍歷返回的記錄集，顯示列數據的內容 TITLE 和 AUTHOR
while (!$result->EOF) {
?? echo $result->fields[1] . " - " . $result->fields[2] . "\n";
?? $result->MoveNext();
}
// 取得和顯示返回的記錄行數
echo "\n[" . $result->RecordCount() . " 行記錄被返回]\n";
// 關閉數據庫連接
$db->Close();
?>
CacheExecute()方法的第一個參數是緩存文件（緩存文件被命名為adodb_*.cache）將被保留的時間，以秒計時；第二個參數是SQL聲明。第一個參數是可選擇的，若沒有限定時間，默認值是3600秒，也就是1個小時。
值得一提的是，使用CacheExcute()方法時，需要將php.ini中的參數magic_quotes_runtime設為0。
也可以根據需要，在程序運行時動態修改它的值：
set_magic_quotes_runtime(0)；
注意：將上述代碼放到調用數據庫的指令之前，我們還可以在任何時候，通過調用CacheFlush()來清除過時的緩存。
10．生成下拉列表菜單ADODB特意為Web開發任務提供幾個通用的方法。其中，最有用的是GetMenu()方法，通過抽取數據庫的記錄集，自動地生成表單及菜單列表框。
下面介紹的就是從數據庫動態構建下拉菜單（Option）的例子。
<html>
<head></head>
<body>
<?php
include_once("libs/adodb/adodb.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "root", "library") or die("Unable to connect!");
// 構造并執行一個查詢
$query = "SELECT title, id FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
//顯示HTML下拉列表菜單
echo $result->GetMenu("library", '', false);
// 關閉數據庫連接
$db->Close();
?>
</body>
</html>
GetMenu()方法需要傳入參數，用來控制列表框的行為。上例中第一個參數是列表框的名字（這個例子為“library”）；第二個參數是顯示時默認的值，可以為空，從第一個記錄開始；第三個參數，指定列表框的項目是否為空；第四個參數，控制是否允許用戶多選。
上例的顯示結果如下：
<select name="library" >
<option value="15">Mystic River</option>
<option value="16">Where Eagles Dare</option>
<option value="17">XML and PHP</option>
</select>
可以看到，該列表菜單內容是從library表抽取的記錄，列表框的名字為“library”，在記錄集中，ID是菜單選項的值，名稱為菜單框顯示的元素。
由此可以看出，GetMenu()方法可以大幅度簡化Web開發任務，大大減少代碼量。
11．輸出到文件ADODB還允許我們將記錄輸出為一個不同形式的文件：如逗號分隔符CSV文件，制表符表格，甚至于HTML形式的表格。
這些功能屬于ADODB的附屬功能，在使用時需要包含相關ADODB類文件，下面是樣例的內容。
<?php
include("libs/adodb/adodb.inc.php");
// 包含轉換方法的文件
include_once("libs/adodb/toexport.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "passwd", "library") or die("Unable to connect!");
// 構造并執行一個查詢
$query = "SELECT title, id FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 返回一個CSV字符串
echo rs2csv($result);
// 關閉數據庫的連接
$db->Close();
?>
輸出結果如下：
title,id
Mystic River,15
Where Eagles Dare,16
XML and PHP,17
我們也可以去除結果中第一行，即字段的名稱，使用腳本格式如下：
// 返回一個 CSV 字符串
echo rs2csv($result, false);
腳本的輸出結果將沒有字段名稱，如下：
Mystic River,15
Where Eagles Dare,16
XML and PHP,17
ADODB還提供生成制表符或分隔符文件功能，使用rs2tab()方法：
<?php
include("libs/adodb/adodb.inc.php");
// 包含轉換方法的文件
include("toexport.inc.php");
//創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "root", "library") or die("Unable to connect!");
// 構造并執行一個查詢
$query = "SELECT title, id FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 返回一個TAB制表符分隔的字符串
echo rs2tab($result);
// 關閉數據庫連接
$db->Close();
?>
顯示結果如下：
title?? id
Mystic River?? 15
Where Eagles Dare?? 16
XML and PHP?? 17
ADODB還提供生成HTML表格的功能，使用rs2html()方法：
<html>
<head></head>
<body>
<?php
include_once(“libs/adodb/adodb.inc.php”);
// 包含轉換方法的文件
include_once("libs/adodb/tohtml.inc.php");
// 創建一個mysql連接實例對象
$db = NewADOConnection("mysql");
// 打開一個數據庫連接
$db->Connect("localhost", "root", "passwd", "library") or die("Unable to connect!");
// 構造并執行一個查詢
$query = "SELECT title, id FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 返回一個HTML格式的表格
echo rs2html($result);
// 關閉數據庫連接
$db->Close();
?>
</body>
</html>
總結
- 上一篇： 机器学习-查准率、查全率、调和平均值
- 下一篇： jquery+baidu map api