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 的简单用法:
// 引入 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 的首页在:,目前(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。
作