ADODB 入門第1/2頁(yè)

更新時(shí)間：2006年12月03日 00:00:00 作者：

1. 前言

ADODB 是 Active Data Objects Data Base 的簡(jiǎn)稱，它是一種 PHP 存取數(shù)據(jù)庫(kù)的函式組件。現(xiàn)在 SFS3 系統(tǒng) (校園自由軟件交流網(wǎng)學(xué)務(wù)系統(tǒng)) 計(jì)劃的主持人陳瑩光老師，決定采用此一組件，為了讓更多有心參與該項(xiàng)目的伙伴們能夠順利加入發(fā)展的行列，小弟認(rèn)為有必要把 ADODB 的中文入門介紹寫出來(lái)，以方便伙伴們參考備查。

雖然 PHP 是建構(gòu) Web 系統(tǒng)強(qiáng)有力的工具，但是 PHP 存取數(shù)據(jù)庫(kù)的功能，一直未能標(biāo)準(zhǔn)化，每一種數(shù)據(jù)庫(kù)，都使用另一種不同且不兼容的應(yīng)用程序接口(API)。為了填補(bǔ)這個(gè)缺憾，因此才有 ADODB 的出現(xiàn)。一旦存取數(shù)據(jù)庫(kù)的接口予以標(biāo)準(zhǔn)化，就能隱藏各種數(shù)據(jù)庫(kù)的差異，若欲轉(zhuǎn)換至其它不同的數(shù)據(jù)庫(kù)，將變得十分容易。

目前 ADODB 支持的數(shù)據(jù)庫(kù)種類非常地多，例如：MySQL, PostgreSQL, Interbase, Informix, Oracle, MS SQL 7, Foxpro, Access, ADO, Sybase, DB2 以及一般的 ODBC (其中 PostgreSQL、Informix、Sybase 的driver 是由自由軟件社群發(fā)展之后貢獻(xiàn)出來(lái)的)。

使用 ADODB 最大的優(yōu)點(diǎn)之一是：不管后端數(shù)據(jù)庫(kù)如何，存取數(shù)據(jù)庫(kù)的方式都是一致的，開(kāi)發(fā)設(shè)計(jì)人員不必為了某一套數(shù)據(jù)庫(kù)，而必須再學(xué)習(xí)另一套不同的存取方法，這大大減輕開(kāi)發(fā)人員的知識(shí)負(fù)擔(dān)，過(guò)去的知識(shí)往后仍可繼續(xù)使用，轉(zhuǎn)移數(shù)據(jù)庫(kù)平臺(tái)時(shí)，程序代碼也不必做太大的更動(dòng)。

其實(shí) ADODB 這樣的發(fā)展理念，并不是首創(chuàng)的，DBI 比 ADODB 出現(xiàn)得更早，它提供 Perl 存取數(shù)據(jù)庫(kù)時(shí)，使用一致的 API 呼叫接口。相信用過(guò) Perl + DBI 的朋友，再來(lái)用 ADODB 時(shí)，會(huì)有一種似曾相識(shí)的感覺(jué)。

另外，ADODB 對(duì)用過(guò) ASP 的人而言，應(yīng)該不陌生，這類朋友對(duì) ADODB 應(yīng)該很容易接受。

我們來(lái)看一下，ADODB 的簡(jiǎn)單用法：

<?php
// 引入 adodb 的 inc 檔，才能呼叫 adodb 提供的函式
include('adodb/adodb.inc.php');

    // 選擇連接的數(shù)據(jù)庫(kù)種類，以建立聯(lián)機(jī)對(duì)象，
    // 一旦對(duì)象建立，即可使用其成員函式來(lái)處理數(shù)據(jù)庫(kù)。
    // 以下 $conn 即此一物件(object)
    $conn = &ADONewConnection('mysql');

    // 要不要顯示偵錯(cuò)訊息，false 不要，true 要。
    // $conn->debug = false;

    $conn->debug = true;

    // 連接數(shù)據(jù)庫(kù)
    // 用法：$conn->Connect('主機(jī)', '使用者', '密碼', '數(shù)據(jù)庫(kù)');
    // 用例：
    $conn->Connect('localhost', 'piza', 'ooo123', 'test');

// 若欲采用持續(xù)性連接，上式可換用 PConnect：
// $conn->PConnect('localhost', 'piza', 'ooo123', 'test');

// 設(shè)定 sql 命令
$sql = "insert into t values ('abcde', 18)";

// 執(zhí)行 sql 命令
$rs = $conn->Execute($sql);

// 檢查執(zhí)行結(jié)果，若 $rs == false，則呼叫 $conn 對(duì)象的成員函式 ErrorMsg()
if (!$rs) print $conn->ErrorMsg(); else print "OK!";

結(jié)果如下：

---------------------------------------------
(mysql): insert into t values ("abcde",18)
---------------------------------------------
OK!

若把偵錯(cuò)關(guān)掉，即 $conn->debug=false，則結(jié)果如下：

OK!

以下，逐步為各位介紹：使用 ADODB 的重點(diǎn)方法。

2. 安裝

ADODB 的首頁(yè)在：http://php.weblogs.com/ADOdb，目前(2002/10/24)最新版是：2.42 版，可至 ADODB 下載或至臺(tái)南縣教網(wǎng)中心 FTP 下載。

安裝 ADODB 的方法超極簡(jiǎn)單，只要下載、解壓、放入適當(dāng)位置，即可完成 ! 如下所示：

1. 下載：

$ ncftp ftp.tnc.edu.tw

cd sysop/ADODB

get adodb242.tgz

2. 解壓：

假設(shè)我把 adodb242.tgz 放入 /var/www/html 中

$ cp adodb242.tgz /var/www/html

$ tar xvzf adodb242.tgz

如下所示：

adodb/adodb-cryptsession.php
adodb/adodb-csvlib.inc.php
adodb/adodb-errorhandler.inc.php
adodb/adodb-errorpear.inc.php
adodb/adodb-lib.inc.php
adodb/adodb-pager.inc.php
....以下省略....

現(xiàn)在，您在 /var/www/html/adodb 已安裝好 ADODB 了。

3. 引入 ADODB

一旦安裝好 ADODB，使用前，應(yīng)把 ADODB 相關(guān)的含入文件引入您的程序中。adodb 目錄放在任何位置無(wú)所謂，只要能指向正確路徑文件名即可。一般而言，您的程序代碼只須引入 adodb.inc.php。

作法如下：

在您的 PHP 程序中：

include('路徑/adodb/adodb.inc.php');

或

include_once('路徑/adodb/adodb.inc.php');

例：

若您的程序和 adodb 在同一目錄下：

.
..
adodb/
something.php*

則：

include('adodb/adodb.inc.php');

即可。

若位置是在某一個(gè)目錄 somedir 中：

.
..
adodb
somedir/something.php

則必須使用：

include('../adodb/adodb.inc.php');

除了 adodb.inc.php 這個(gè)含入檔，ADODB 還提供許多 adodb-*.inc.php 的含入檔，這些多半是為驅(qū)動(dòng)某些數(shù)據(jù)庫(kù)的特殊用法而設(shè)的。

若是引入 adodb-session.php 則可讓您將 session 存入數(shù)據(jù)庫(kù)中來(lái)維護(hù)運(yùn)用。

若是引入 adodb-pager.inc.php，可方便您做分頁(yè)顯示。

若是引入 adodb-errorhandler.inc.php，可讓您自訂錯(cuò)誤處理訊息。

若是含入 adodb-pear.inc.php，可讓您使用 PHP4 的 PEAR DB 語(yǔ)法來(lái)使用 ADODB。此時(shí)，尚可使用 DSN 連接數(shù)據(jù)庫(kù)的字符串設(shè)定。如 $dsn="mysql://piza:ooo123@localhost/test";

若是引入 tohtml.inc.php，可幫您在程序代碼中，方便將取出的記錄，轉(zhuǎn)成 HTML 的表格(table)來(lái)顯示。

若是引入 toexport.inc.php，可讓您方便地輸出 CSV 檔或以 tab 分隔字段的數(shù)據(jù)文件。

若是引入 rsfilter.inc.php，可讓您在使用記錄之前，預(yù)做過(guò)濾處理。

若是引入 pivottable.inc.php，可讓您使用 pivot table 功能(俗稱 cross-tabulations)。

注意 ! adodb.inc.php 是一定要引入的，其它，則視您要使用那一個(gè)功能，再引入該含入檔即可。

4. 選用數(shù)據(jù)庫(kù)種類，建立聯(lián)機(jī)對(duì)象

由于 ADODB 使用對(duì)象導(dǎo)向的作法，因此您在引入檔之后，接著請(qǐng)視您后端數(shù)據(jù)庫(kù)的種類，建立一個(gè)聯(lián)機(jī)對(duì)象。作法如下：

以 MySQL 數(shù)據(jù)庫(kù)為例：

$conn = &ADONewConnection('mysql');

注：NewADOConnection 和 ADONewConnection 是一樣的，二者皆可使用。

上例中的 'mysql' 是指數(shù)據(jù)庫(kù)的 drvier 的種類，ADODB 會(huì)據(jù)此呼叫對(duì)應(yīng)的數(shù)據(jù)庫(kù) driver。

其它常用的 driver 有：access、ado、ado_access、ado_mssql、db2、vfp、ibase、borland_ibase、informix、imformix72、mssql、oci8、odbc、postgres、postgres64、postgres7、sqlanywhere、sybase....等等。

我們稱建立的對(duì)象 $conn 為一 ADOConnection 對(duì)象，它代表與數(shù)據(jù)庫(kù)的連接事務(wù)，皆透過(guò)這個(gè)對(duì)象來(lái)處理。ADOConnection 對(duì)象會(huì)提供許多處理的方法，以對(duì)象導(dǎo)向的說(shuō)法，這些方法稱為成員函式，這是外界存取此一對(duì)象的接口。

一旦聯(lián)機(jī)對(duì)象建立之后，就有許多對(duì)象函式可供您使喚啦 ! 請(qǐng)看下一節(jié)的介紹。

5. 偵錯(cuò)模式

程序開(kāi)發(fā)的過(guò)程，為了方便查出出現(xiàn)問(wèn)題可能的地方，通常我們會(huì)打開(kāi)偵錯(cuò)模式，俟程序功能確實(shí)穩(wěn)定之后，再將它關(guān)閉。ADODB 提供偵錯(cuò)模式，存取數(shù)據(jù)庫(kù)時(shí)，能顯示其運(yùn)作方式。

打開(kāi)偵錯(cuò)模式，使用法：

$conn->debug=true

關(guān)閉偵錯(cuò)模式，使用法：

$conn->debug=false

6. 連接數(shù)據(jù)庫(kù)

接著，使用 $conn 聯(lián)機(jī)對(duì)象的 Connect 或 PConnect 函式來(lái)連接特定的數(shù)據(jù)庫(kù)，此時(shí)必須提供 DSN (Data Source Names)相關(guān)數(shù)據(jù)，DSN 可能包括：主機(jī)名稱、數(shù)據(jù)庫(kù)使用者、數(shù)據(jù)庫(kù)密碼、數(shù)據(jù)庫(kù)名稱。不同的數(shù)據(jù)庫(kù)種類，DSN 可能可以省略其中若干項(xiàng)。以 MySQL 而言，則上述四者都要提供。

該函式會(huì)傳回 true 或 false，用以表示是否連接成功。

用例：

// 格式：$conn->Connect('主機(jī)', '使用者', '密碼', '數(shù)據(jù)庫(kù)');

$conn->Connect('localhost', 'piza', 'ooo123', 'test');

或者，采持續(xù)性連接：

// 格式：$conn->PConnect('主機(jī)', '使用者', '密碼', '數(shù)據(jù)庫(kù)');

$conn->PConnect('localhost', 'piza', 'ooo123', 'test');

若欲探查是否有聯(lián)機(jī)成功，可用一個(gè)變量來(lái)接取傳回值：

$mch="localhost";
$user="piza";
$pwd="ooo123";
$database="test";

$cok = $conn->Connect($mch, $user, $pwd, $database);

或者，采持續(xù)性連接：

$cok = $conn->PConnect($mch, $user, $pwd, $database);

if (!$cok) { echo "無(wú)法連接數(shù)據(jù)庫(kù) $database"; exit; }

7. 設(shè)定 sql 命令語(yǔ)法、執(zhí)行 sql 命令

接下來(lái)，您就可以設(shè)計(jì)您要執(zhí)行的 sql 命令語(yǔ)法，然后付諸執(zhí)行。

$sql = "這里放 SQL 的命令語(yǔ)法";

$rs = $conn->Execute($sql);

其中，$rs 為回傳的結(jié)果，若 $rs == false，則表示執(zhí)行失敗，您必須仔細(xì)檢查一下。

您不一定要把命令語(yǔ)法放在 $sql 變量中，也可以直接放入 Execute( ) 括號(hào)中。若命令較短無(wú)妨，若命令較長(zhǎng)，我建議您還是用一個(gè)變量 $sql 來(lái)設(shè)定命令字符串吧 !

下一節(jié)開(kāi)始，為各位介紹 SQL 的基本命令，如：Insert、Select、Update、Delete 等等的用法。

8. 插入記錄(Insert)

Insert 的用法如下：

// $name 為字符串，$year 為數(shù)字
$name='abcde';
$year=18;

// 插入一筆記錄，命令的大小寫無(wú)妨，但數(shù)據(jù)表 t 及變量則大小寫有分別 !
$sql = "INSERT INTO t VALUES ('$name', $year)";

// $sql = "insert into t values ('$name', $year)"; 亦可。

// 執(zhí)行
$rs = $conn->Execute($sql);

// 檢查執(zhí)行結(jié)果，進(jìn)行錯(cuò)誤處理；若正常，則繼續(xù)其它動(dòng)作....
if (!$rs) print $conn->ErrorMsg();

....以下省略....

ErrorMsg() 是錯(cuò)誤顯示的函式，它會(huì)取出錯(cuò)誤訊息，并顯示出來(lái)。

另外，ADODB 提供一種記錄集(RecordSet) 函式 GetInsertSQL()，可幫您產(chǎn)生 Insert 的語(yǔ)法。

例子如下：

<?php

// 引入 ADODB
include('adodb/adodb.inc.php');

// 建立聯(lián)機(jī)對(duì)象
$conn = &ADONewConnection('mysql');

// 偵錯(cuò)
$conn->debug=true;

// DSN 四項(xiàng)基本數(shù)據(jù)設(shè)定
$mch="localhost";
$user="root";
$pwd="jack168";
$database="test";

// 連接至數(shù)據(jù)庫(kù) test
$conn->PConnect($mch, $user, $pwd, $database);

// 產(chǎn)生一筆空記錄
$sql = "select * from t where year=-1";

$rs = $conn->Execute($sql);

// 用一個(gè)空數(shù)組來(lái)裝要更新的數(shù)據(jù)
$r = array();

$r['name']='john';
$r['year']=28;

// 用 GetInsertSQL 函式來(lái)制作一個(gè)完整的 sql 命令，此 sql 命令放在 $insertSQL 中
$insertSQL = $conn->GetInsertSQL($rs, $r);

// 執(zhí)行插入
$conn->Execute($insertSQL);

$conn->Close();
?>

偵錯(cuò)訊息如下：

-----------------------------------------------------------
(mysql): select * from t where year=-1
-----------------------------------------------------------
(mysql): INSERT INTO t ( name, year ) VALUES ( 'john', 28 )
-----------------------------------------------------------

9. 取出記錄(Select)

Select 的用法如下：

<?php

// 引入 ADODB
include('adodb/adodb.inc.php');

// 建立聯(lián)機(jī)對(duì)象
$conn = &ADONewConnection('mysql');

// 不偵錯(cuò)
$conn->debug=false;

// DSN 四項(xiàng)基本數(shù)據(jù)設(shè)定
$mch="localhost";
$user="piza";
$pwd="ooo123";
$database="test";

// 連接至數(shù)據(jù)庫(kù) test
$conn->PConnect($mch, $user, $pwd, $database);

// 執(zhí)行 Select 由表格 t 取出數(shù)據(jù)，
// 它會(huì)傳回一個(gè) ADORecordSet 記錄集對(duì)象 $rs (RecordSet)
// 實(shí)際上 $rs 是一個(gè) cursor 指標(biāo)，它擁有目前的記錄(row 或稱 record)，
// 該記錄的所有字段數(shù)據(jù)的內(nèi)容，存放在 fields 這個(gè)數(shù)組之中
// ，以數(shù)字為索引，第一個(gè)由 0 開(kāi)始
$rs = &$conn->Execute('select * from t');

// 若 $rs 為 false，則秀出錯(cuò)誤訊息
if (!$rs) {
print $conn->ErrorMsg();
} else {

// 當(dāng)尚未到達(dá) 記錄集 $rs 的結(jié)束位置(EOF：End Of File)時(shí)，(即：還有記錄尚未取出時(shí))
    while (!$rs->EOF) {
        // 秀出所有字段，$FieldCount() 會(huì)傳回字段總數(shù)
    for ($i=0, $max=$rs->FieldCount(); $i < $max; $i++) {
        print $rs->fields[$i] . " ";
    }

        // 移至下一筆記錄
    $rs->MoveNext();

    // 換列
    echo "<br>\n";
    }
}

$rs->Close(); // 可不用
$conn->Close(); // 可不用
?>

$rs->fields[] 數(shù)組是由 PHP 的數(shù)據(jù)庫(kù)擴(kuò)展功能產(chǎn)生的，某些擴(kuò)展功能并不支持使用字段名稱當(dāng)作索引。

若欲使用名稱當(dāng)作索引，也就是俗稱的 hash 或 associative arrays，則需使用全域變量 $ADODB_FETCH_MODE 加以指定。

以下設(shè)定：使用數(shù)字索引 $ADODB_FETCH_MODE= ADODB_FETCH_NUM;

以下設(shè)定：使用名稱索引 $ADODB_FETCH_MODE= ADODB_FETCH_ASSOC;

下面是使用名稱索引的例子：

<?php

// 引入 ADODB
include('adodb/adodb.inc.php');

// 建立聯(lián)機(jī)對(duì)象
$conn = &ADONewConnection('mysql');

// 不偵錯(cuò)
$conn->debug=false;

// DSN 四項(xiàng)基本數(shù)據(jù)設(shè)定
$mch="localhost";
$user="root";
$pwd="jack168";
$database="test";

// 連接至數(shù)據(jù)庫(kù) test
$conn->PConnect($mch, $user, $pwd, $database);

// 執(zhí)行 sql 之前，指定使用名稱索引
$ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;

// 執(zhí)行 Select，它會(huì)傳回一個(gè) ADORecordSet 記錄集對(duì)象 $rs
// 實(shí)際上 $rs 是一個(gè) cursor 指標(biāo)，它擁有目前的記錄內(nèi)容，
// 該記錄存放在 fields 這個(gè)數(shù)組之中
$rs = &$conn->Execute('select * from t');

// 若 $rs 為 false，則秀出錯(cuò)誤訊息
if (!$rs) {
print $conn->ErrorMsg();
} else {

// 當(dāng)尚未到達(dá)記錄集結(jié)束位置(EOF)時(shí)，
while (!$rs->EOF) {
// 秀出所有字段

print $rs->fields['name'] . " " . $rs->fields['year'];

        // 移至下一筆記錄
    $rs->MoveNext();

    // 換列
    echo "<br>\n";
    }
}

$rs->Close(); // 可不用
$conn->Close(); // 可不用
?>