php ADODB 开发浅谈.docx
《php ADODB 开发浅谈.docx》由会员分享，可在线阅读，更多相关《php ADODB 开发浅谈.docx（19页珍藏版）》请在冰豆网上搜索。
phpADODB开发浅谈
1.前言
ADODB是ActiveDataObjectsDataBase的简称，它是一种PHP存取数据库的函式组件。
现在SFS3系统（校园自由软件交流网学务系统）计划的主持人陈莹光老师，决定采用此一组件，为了让更多有心参与该项目的伙伴们能够顺利加入发展的行列，小弟认为有必要把ADODB的中文入门介绍写出来，以方便伙伴们参考备查。
虽然PHP是建构Web系统强有力的工具，但是PHP存取数据库的功能，一直未能标准化，每一种数据库，都使用另一种不同且不兼容的应用程序接口（API）。
为了填补这个缺憾，因此才有ADODB的出现。
一旦存取数据库的接口予以标准化，就能隐藏各种数据库的差异，若欲转换至其它不同的数据库，将变得十分容易。
目前ADODB支持的数据库种类非常地多，例如：
MySQL,PostgreSQL,Interbase,Informix,Oracle,MSSQL7,Foxpro,Access,ADO,Sybase,DB2以及一般的ODBC（其中PostgreSQL、Informix、Sybase的driver是由自由软件社群发展之后贡献出来的）。
使用ADODB最大的优点之一是：
不管后端数据库如何，存取数据库的方式都是一致的，开发设计人员不必为了某一套数据库，而必须再学习另一套不同的存取方法，这大大减轻开发人员的知识负担，过去的知识往后仍可继续使用，转移数据库平台时，程序代码也不必做太大的更动。
字串8
其实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="insertintotvalues（'abcde',18）";字串1
//执行sql命令
$rs=$conn->Execute（$sql）;
//检查执行结果，若$rs==false，则呼叫$conn对象的成员函式ErrorMsg（）
if（!
$rs）print$conn->ErrorMsg（）;elseprint"OK!
";
?
>
结果如下：
---------------------------------------------
（mysql）:
insertintotvalues（"abcde",18）
---------------------------------------------
OK!
若把侦错关掉，即$conn->debug=false，则结果如下：
OK!
以下，逐步为各位介绍：
使用ADODB的重点方法。
2.安装
ADODB的首页在：
版，可至ADODB下载或至台南县教网中心FTP下载。
安装ADODB的方法超极简单，只要下载、解压、放入适当位置，即可完成!
如下所示：
1.下载：
$ncftpftp.tnc.edu.tw
cdsysop/ADODB
getadodb242.tgz
2.解压：
假设我把adodb242.tgz放入/var/www/html中
$cpadodb242.tgz/var/www/html
$tarxvzfadodb242.tgz
如下所示：
adodb/adodb-cryptsession.php字串1
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的含入档，这些多半是为驱动某些数据库的特殊用法而设的。
字串8
若是引入adodb-session.php则可让您将session存入数据库中来维护运用。
若是引入adodb-pager.inc.php，可方便您做分页显示。
若是引入adodb-errorhandler.inc.php，可让您自订错误处理讯息。
若是含入adodb-pear.inc.php，可让您使用PHP4的PEARDB语法来使用ADODB。
此时，尚可使用DSN连接数据库的字符串设定。
如$dsn="mysql:
//pizaoo123@localhost/test";
若是引入tohtml.inc.php，可帮您在程序代码中，方便将取出的记录，转成HTML的表格（table）来显示。
若是引入toexport.inc.php，可让您方便地输出CSV档或以tab分隔字段的数据文件。
若是引入rsfilter.inc.php，可让您在使用记录之前，预做过滤处理。
若是引入pivottable.inc.php，可让您使用pivottable功能（俗称cross-tabulations）。
注意!
adodb.inc.php是一定要引入的，其它，则视您要使用那一个功能，再引入该含入档即可。
4.选用数据库种类，建立联机对象
由于ADODB使用对象导向的作法，因此您在引入档之后，接着请视您后端数据库的种类，建立一个联机对象。
作法如下：
字串1
以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字串9
6.连接数据库
接着，使用$conn联机对象的Connect或PConnect函式来连接特定的数据库，此时必须提供DSN（DataSourceNames）相关数据，DSN可能包括：
主机名称、数据库使用者、数据库密码、数据库名称。
不同的数据库种类，DSN可能可以省略其中若干项。
以MySQL而言，则上述四者都要提供。
该函式会传回true或false，用以表示是否连接成功。
用例：
//格式：
$conn->Connect（'主机','使用者','密码','数据库'）;
$conn->Connect（'localhost','piza','ooo123','test'）;
或者，采持续性连接：
//格式：
$conn->PConnect（'主机','使用者','密码','数据库'）;
$conn->PConnect（'localhost','piza','ooo123','test'）;
若欲探查是否有联机成功，可用一个变量来接取传回值：
$mch="localhost";
$user="piza";
$pwd="ooo123";
$database="test";
$cok=$conn->Connect（$mch,$user,$pwd,$database）;
或者，采持续性连接：
$cok=$conn->PConnect（$mch,$user,$pwd,$database）;
if（!
$cok）{echo"无法连接数据库$database";exit;}
7.设定sql命令语法、执行sql命令
字串6
接下来，您就可以设计您要执行的sql命令语法，然后付诸执行。
$sql="这里放SQL的命令语法";
$rs=$conn->Execute（$sql）;
其中，$rs为回传的结果，若$rs==false，则表示执行失败，您必须仔细检查一下。
您不一定要把命令语法放在$sql变量中，也可以直接放入Execute（）括号中。
若命令较短无妨，若命令较长，我建议您还是用一个变量$sql来设定命令字符串吧!
下一节开始，为各位介绍SQL的基本命令，如：
Insert、Select、Update、Delete等等的用法。
8.插入记录（Insert）
Insert的用法如下：
//$name为字符串，$year为数字
$name='abcde';
$year=18;
//插入一笔记录，命令的大小写无妨，但数据表t及变量则大小写有分别!
$sql="INSERTINTOtVALUES（'$name',$year）";
//$sql="insertintotvalues（'$name',$year）";亦可。
//执行
$rs=$conn->Execute（$sql）;
//检查执行结果，进行错误处理；若正常，则继续其它动作....
if（!
$rs）print$conn->ErrorMsg（）;
....以下省略....
ErrorMsg（）是错误显示的函式，它会取出错误讯息，并显示出来。
另外，ADODB提供一种记录集（RecordSet）函式GetInsertSQL（），可帮您产生Insert的语法。
例子如下：
php
//引入ADODB
include（'adodb/adodb.inc.php'）;
//建立联机对象
$conn=&ADONewConnection（'mysql'）;
//侦错
$conn->debug=true;
//DSN四项基本数据设定
$mch="localhost";
$user="root";
$pwd="jack168";
$database="test";
//连接至数据库test
$conn->PConnect（$mch,$user,$pwd,$database）;
字串3
//产生一笔空记录
$sql="select*fromtwhereyear=-1";
$rs=$conn->Execute（$sql）;
//用一个空数组来装要更新的数据
$r=array（）;
$r['name']='john';
$r['year']=28;
//用GetInsertSQL函式来制作一个完整的sql命令，此sql命令放在$insertSQL中
$insertSQL=$conn->GetInsertSQL（$rs,$r）;
//执行插入
$conn->Execute（$insertSQL）;
$conn->Close（）;
?
>
侦错讯息如下：
-----------------------------------------------------------
（mysql）:
select*fromtwhereyear=-1
-----------------------------------------------------------
（mysql）:
INSERTINTOt（name,year）VALUES（'john',28）
-----------------------------------------------------------
9.取出记录（Select）
Select的用法如下：
php
//引入ADODB
include（'adodb/adodb.inc.php'）;
//建立联机对象
$conn=&ADONewConnection（'mysql'）;
//不侦错
$conn->debug=false;
//DSN四项基本数据设定
$mch="localhost";
字串9
$user="piza";
$pwd="ooo123";
$database="test";
//连接至数据库test
$conn->PConnect（$mch,$user,$pwd,$database）;
//执行Select由表格t取出数据，
//它会传回一个ADORecordSet记录集对象$rs（RecordSet）
//实际上$rs是一个cursor指标，它拥有目前的记录（row或称record），
//该记录的所有字段数据的内容，存放在fields这个数组之中
//，以数字为索引，第一个由0开始
$rs=&$conn->Execute（'select*fromt'）;
//若$rs为false，则秀出错误讯息
if（!
$rs）{
print$conn->ErrorMsg（）;
}else{
//当尚未到达记录集$rs的结束位置（EOF：
EndOfFile）时，（即：
还有记录尚未取出时）
while（!
$rs->EOF）{
//秀出所有字段，$FieldCount（）会传回字段总数
for（$i=0,$max=$rs->FieldCount（）;$i<$max;$i++）{
print$rs->fields[$i]."";
}
//移至下一笔记录
$rs->MoveNext（）;
//换列
echo"
n";
}
}
$rs->Close（）;//可不用
$conn->Close（）;//可不用
?
>
$rs->fields[]数组是由PHP的数据库扩展功能产生的，某些扩展功能并不支持使用字段名称当作索引。
字串2
若欲使用名称当作索引，也就是俗称的hash或associativearrays，则需使用全域变量$ADODB_FETCH_MODE加以指定。
以下设定：
使用数字索引$ADODB_FETCH_MODE=ADODB_FETCH_NUM;
以下设定：
使用名称索引$ADODB_FETCH_MODE=ADODB_FETCH_ASSOC;
下面是使用名称索引的例子：
php
//引入ADODB
include（'adodb/adodb.inc.php'）;
//建立联机对象
$conn=&ADONewConnection（'mysql'）;
//不侦错
$conn->debug=false;
//DSN四项基本数据设定
$mch="localhost";
$user="root";
$pwd="jack168";
$database="test";
//连接至数据库test
$conn->PConnect（$mch,$user,$pwd,$database）;
//执行sql之前，指定使用名称索引
$ADODB_FETCH_MODE=ADODB_FETCH_ASSOC;
//执行Select，它会传回一个ADORecordSet记录集对象$rs
//实际上$rs是一个cursor指标，它拥有目前的记录内容，
//该记录存放在fields这个数组之中
$rs=&$conn->Execute（'select*fromt'）;
//若$rs为false，则秀出错误讯息
if（!
$rs）{
print$conn->ErrorMsg（）;
字串9
}else{
//当尚未到达记录集结束位置（EOF）时，
while（!
$rs->EOF）{
//秀出所有字段
print$rs->fields['name']."".$rs->fields['year'];
//移至下一笔记录
$rs->MoveNext（）;
//换列
echo"
n";
}
}
$rs->Close（）;//可不用
$conn->Close（）;//可不用
?
>
10.取出记录（使用FetchRow）
这里示范FetchRow的用法：
$sql="select*fromt";
$rs=$conn->Execute（$sql）;
if（$rs）{
while（$ar=$rs->FetchRow（））{
print$ar['name']."".$ar['year'];
print"
n";
}
}
FetchRow（）会将取出的记录传回，您可用一个array来接取。
注意!
使用FetchRow（）就不必再用MoveNext（），FetchRow内部会自动完成移至下一笔记录的动作。
11.更新记录（Update）
您可以用传统的方式：
$sql="UPDATEtSETname='john',year=28WHEREyear=18";
$conn->Execute（$sql）;
也可以用以下这种方式：
php
//引入ADODB
include（'adodb/adodb.inc.php'）;
字串6
//建立联机对象
$conn=&ADONewConnection（'mysql'）;
//侦错
$conn->debug=true;
//DSN四项基本数据设定
$mch="localhost";
$user="piza";
$pwd="ooo123";
$database="test";
//连接至数据库test
$conn->PConnect（$mch,$user,$pwd,$database）;
//选择要更新的那一笔记录
$sql="select*fromtwhereyear=18";
$rs=$conn->Execute（$sql）;
//用一个空数组来装要更新的数据
$r=array（）;
$r['name']='john';
$r['year']=28;
//用GetUpdateSQL函式来制作一个完整的sql命令，此sql命令放在$updateSQL中
$updateSQL=$conn->GetUpdateSQL（$rs,$r）;
//执行更新
$conn->Execute（$updateSQL）;
$conn->Close（）;
?
>
侦错讯息如下：
-------------------------------------------------------------
（mysql）:
select*fromtwhereyear=18
-------------------------------------------------------------
（mysql）:
UPDATEtSETname='john',year=28WHEREyear=18
-------------------------------------------------------------字串8
12.删除记录（Delete）
删除记录很简单，采传统方式即可：
$sql="DELETEFROMtWHEREyear=18";
$rs=$conn->Execute（$sql）;
13.使用字段对象（FieldObjects）
这里示范
升级会员 