1. 前言
ADODB 是 Active Data Objects Data Base 的简称，它是一种 PHP 存取数据库的函式组件。现在 SFS3 系统 (校园自由软件交流网学务系统) 计划的主持人陈莹光老师，决定采用此一组件，为了让更多有心参与该项目的伙伴们能够顺利加入发展的行列，小弟认为有必要把 ADODB 的中文入门介绍写出来，以方便伙伴们参考备查。
虽然 PHP 是建构 Web 系统强有力的工具，但是 PHP 存取数据库的功能，一直未能标准化，每一种数据库，都使用另一种不同且不兼容的应用程序接口(API)。为了填补这个缺憾，因此才有 ADODB 的出现。一旦存取数据库的接口予以标准化，就能隐藏各种数据库的差异，若欲转换至其它不同的数据库，将变得十分容易。
目前 ADODB 支持的数据库种类非常地多，例如：MySQL, PostgreSQL, Interbase, Informix, Oracle, MS SQL 7, Foxpro, Access, ADO, Sybase, DB2 以及一般的 ODBC (其中 PostgreSQL、Informix、Sybase 的driver 是由自由软件社群发展之后贡献出来的)。
使用 ADODB 最大的优点之一是：不管后端数据库如何，存取数据库的方式都是一致的，开发设计人员不必为了某一套数据库，而必须再学习另一套不同的存取方法，这大大减轻开发人员的知识负担，过去的知识往后仍可继续使用，转移数据库平台时，程序代码也不必做太大的更动。
其实 ADODB 这样的发展理念，并不是首创的，DBI 比 ADODB 出现得更早，它提供 Perl 存取数据库时，使用一致的 API 呼叫接口。相信用过 Perl + DBI 的朋友，再来用 ADODB 时，会有一种似曾相识的感觉。
另外，ADODB 对用过 ASP 的人而言，应该不陌生，这类朋友对 ADODB 应该很容易接受。
我们来看一下，ADODB 的简单用法：
<?php
// 引入 adodb 的 inc 档，才能呼叫 adodb 提供的函式
include('adodb/adodb.inc.php');
// 选择连接的数据库种类，以建立联机对象，
// 一旦对象建立，即可使用其成员函式来处理数据库。
// 以下 $conn 即此一物件(object)
$conn = &ADONewConnection('mysql');
// 要不要显示侦错讯息，false 不要，true 要。
// $conn->debug = false;
$conn->debug = true;
// 连接数据库
// 用法：$conn->Connect('主机', '使用者', '密码', '数据库');
// 用例：
$conn->Connect('localhost', 'piza', 'ooo123', 'test');
// 若欲采用持续性连接，上式可换用 PConnect：
// $conn->PConnect('localhost', 'piza', 'ooo123', 'test');
// 设定 sql 命令
$sql = "insert into t values ('abcde', 18)";
// 执行 sql 命令
$rs = $conn->Execute($sql);
// 检查执行结果，若 $rs == false，则呼叫 $conn 对象的成员函式 ErrorMsg()
if (!$rs) print $conn->ErrorMsg(); else print "OK!";
?>
结果如下：
---------------------------------------------
(mysql): insert into t values ("abcde",18)
---------------------------------------------
OK!
若把侦错关掉，即 $conn->debug=false，则结果如下：
OK!
以下，逐步为各位介绍：使用 ADODB 的重点方法。
2. 安装
ADODB 的首页在：http://php.weblogs.com/ADOdb，目前(2002/10/24)最新版是：2.42 版，可至 ADODB 下载或至台南县教网中心 FTP 下载。
安装 ADODB 的方法超极简单，只要下载、解压、放入适当位置，即可完成 ! 如下所示：
1. 下载：
$ ncftp ftp.tnc.edu.tw
cd sysop/ADODB
get adodb242.tgz
2. 解压：
假设我把 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
....以下省略....
现在，您在 /var/www/html/adodb 已安装好 ADODB 了。
3. 引入 ADODB
一旦安装好 ADODB，使用前，应把 ADODB 相关的含入文件引入您的程序中。adodb 目录放在任何位置无所谓，只要能指向正确路径文件名即可。一般而言，您的程序代码只须引入 adodb.inc.php。
作法如下：
在您的 PHP 程序中：
include('路径/adodb/adodb.inc.php');
或
include_once('路径/adodb/adodb.inc.php');
例：
若您的程序和 adodb 在同一目录下：
.
..
adodb/
something.php*
则：
include('adodb/adodb.inc.php');
即可。
若位置是在某一个目录 somedir 中：
.
..
adodb
somedir/something.php
则必须使用：
include('../adodb/adodb.inc.php');
除了 adodb.inc.php 这个含入档，ADODB 还提供许多 adodb-*.inc.php 的含入档，这些多半是为驱动某些数据库的特殊用法而设的。
若是引入 adodb-session.php 则可让您将 session 存入数据库中来维护运用。
若是引入 adodb-pager.inc.php，可方便您做分页显示。
若是引入 adodb-errorhandler.inc.php，可让您自订错误处理讯息。
若是含入 adodb-pear.inc.php，可让您使用 PHP4 的 PEAR DB 语法来使用 ADODB。此时，尚可使用 DSN 连接数据库的字符串设定。如 $dsn="mysql://piza:ooo123@localhost/test";
若是引入 tohtml.inc.php，可帮您在程序代码中，方便将取出的记录，转成 HTML 的表格(table)来显示。
若是引入 toexport.inc.php，可让您方便地输出 CSV 档或以 tab 分隔字段的数据文件。
若是引入 rsfilter.inc.php，可让您在使用记录之前，预做过滤处理。
若是引入 pivottable.inc.php，可让您使用 pivot table 功能(俗称 cross-tabulations)。
注意 ! adodb.inc.php 是一定要引入的，其它，则视您要使用那一个功能，再引入该含入档即可。
4. 选用数据库种类，建立联机对象
由于 ADODB 使用对象导向的作法，因此您在引入档之后，接着请视您后端数据库的种类，建立一个联机对象。作法如下：
以 MySQL 数据库为例：
$conn = &ADONewConnection('mysql');
注：NewADOConnection 和 ADONewConnection 是一样的，二者皆可使用。
上例中的 'mysql' 是指数据库的 drvier 的种类，ADODB 会据此呼叫对应的数据库 driver。
其它常用的 driver 有：access、ado、ado_access、ado_mssql、db2、vfp、ibase、borland_ibase、informix、imformix72、mssql、oci8、odbc、postgres、postgres64、postgres7、sqlanywhere、sybase....等等。
我们称建立的对象 $conn 为一 ADOConnection 对象，它代表与数据库的连接事务，皆透过这个对象来处理。ADOConnection 对象会提供许多处理的方法，以对象导向的说法，这些方法称为成员函式，这是外界存取此一对象的接口。
一旦联机对象建立之后，就有许多对象函式可供您使唤啦 ! 请看下一节的介绍。
5. 侦错模式
程序开发的过程，为了方便查出出现问题可能的地方，通常我们会打开侦错模式，俟程序功能确实稳定之后，再将它关闭。ADODB 提供侦错模式，存取数据库时，能显示其运作方式。
打开侦错模式，使用法：
$conn->debug=true
关闭侦错模式，使用法：
$conn->debug=false
6. 连接数据库
接着，使用 $conn 联机对象的 Connect 或 PConnect 函式来连接特定的数据库，此时必须提供 DSN (Data Source Names)相关数据，DSN 可能包括：主机名称、数据库使用者、数据库密码、数据库名称。不同的数据库种类，DSN 可能可以省略其中若干项。以 MySQL 而言，则上述四者都要提供。
该函式会传回 true 或 false，用以表示是否连接成功。
用例：
// 格式：$conn->Connect('主机', '使用者', '密码', '数据库');
$conn->Connect('localhost', 'piza', 'ooo123', 'test');
或者，采持续性连接：
// 格式：$conn->PConnect('主机', '使用者', '密码', '数据库');
