PHP中ADODB类详解_php教程-查字典教程网
PHP中ADODB类详解
PHP中ADODB类详解
发布时间:2016-12-29 来源:查字典编辑
摘要:虽然PHP是建构Web系统强有力的工具,但是PHP存取数据库的功能,一直未能标准化,每一种数据库,都使用另一种不同且不兼容的应用程序接口(A...

虽然PHP是建构Web系统强有力的工具,但是PHP存取数据库的功能,一直未能标准化,每一种数据库,都使用另一种不同且不兼容的应用程序接口(API)。为了填补这个缺憾,因此才有ADODB的出现。一旦存取数据库的接口予以标准化,就能隐藏各种数据库的差异,若欲转换至其它不同的数据库,将变得十分容易。

目前ADODB支持的数据库种类非常地多,例如:MySQL,PostgreSQL,Interbase,Informix,Oracle,MSSQL7,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="insertintotvalues('abcde',18)";

//执行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的首页在:http://php.weblogs.com/ADOdb,目前(2002/10/24)最新版是:2.42版,可至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

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的PEARDB语法来使用ADODB。此时,尚可使用DSN连接数据库的字符串设定。如$dsn="mysql://piza:ooo123@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使用对象导向的作法,因此您在引入档之后,接着请视您后端数据库的种类,建立一个联机对象。作法如下:

以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(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命令

接下来,您就可以设计您要执行的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);

//产生一笔空记录

$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";

$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"<br>n";

}

}

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

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

?>

$rs->fields[]数组是由PHP的数据库扩展功能产生的,某些扩展功能并不支持使用字段名称当作索引。

若欲使用名称当作索引,也就是俗称的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();

}else{

//当尚未到达记录集结束位置(EOF)时,

while(!$rs->EOF){

//秀出所有字段

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

//移至下一笔记录

$rs->MoveNext();

//换列

echo"<br>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"<br>n";

}

}

FetchRow()会将取出的记录传回,您可用一个array来接取。

注意!使用FetchRow()就不必再用MoveNext(),FetchRow内部会自动完成移至下一笔记录的动作。

11.更新记录(Update)

您可以用传统的方式:

$sql="UPDATEtSETname='john',year=28WHEREyear=18";

$conn->Execute($sql);

也可以用以下这种方式:

<?php

//引入ADODB

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

//建立联机对象

$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

-------------------------------------------------------------

12.删除记录(Delete)

删除记录很简单,采传统方式即可:$sql="DELETEFROMtWHEREyear=18";

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

13.使用字段对象(FieldObjects)

这里示范字段对象FetchField的用法,用以取得字段名称及字段型态:

$sql="select*fromt";

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

if($rs){

while(!$rs->EOF){

//取出第二个字段

$f=$rs->FetchField(1);

//印出字段名称及字段型态

print$f->name.":".$f->type;

$rs->MoveNext();

print"<br>n";

}

}

另外,ADODB提供一个RecordSet函式MetaType(),可将原始的字段型态转成一般型态代码:

C:字符

X:text

B:blob

D:日期

T:timestamp

L:布尔值或位

I:整数

N:数字型态,包括:自动增加、数值、浮点数、实数及整数

R:serial、自动增加

用例:

$f=$rs->FetchField(1);

//印出字段名称及字段型态的代码

print$f->name.":".$rs->MetaType($f->type);

14.简单分页(Pager)

ADODB提供一种简单分页显示记录的方法,使用前,要将adodb-pager.inc.php引入。

<?php

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

//引入分页功能

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

//启动session

session_start();

$db=ADONewConnection('mysql');

$mch="localhost";

$user="piza";

$pwd="ooo123";

$database="test";

$db->Connect($mch,$user,$pwd,$database);

$sql="select*fromt";

//产生pager对象

$pager=newADODB_Pager($db,$sql);

//每一页秀5笔记录

$pager->Render($rows_per_page=5);

?>

结果如下:

Figure1.简单分页功能

每页显示记录的数目是由Render()来控制的,若没有传入指定的row数给Render(),默认值每页秀10笔。

另外,字段名称也可以改变,如下示范:

<?php

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

//引入分页功能

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

//启动session

session_start();

$db=ADONewConnection('mysql');

$mch="localhost";

$user="piza";

$pwd="ooo123";

$database="test";

$db->Connect($mch,$user,$pwd,$database);

$sql="selectnameas'姓名',yearas'年纪'fromt";

//产生pager对象

$pager=newADODB_Pager($db,$sql);

//每一页秀5笔记录

$pager->Render($rows_per_page=5);

?>

结果如下:

Figure2.改变字段名称

15.输出CSV档

ADODB提供输出CSV档的方法,使用前,要将toexport.inc.php引入。

<?php

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

//引入输出CSV文件功能

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

$db=ADONewConnection('mysql');

$mch="localhost";

$user="piza";

$pwd="ooo123";

$database="test";

$db->Connect($mch,$user,$pwd,$database);

$sql="selectnameas'姓名',yearas'年纪'fromt";

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

//秀出CSV格式

printrs2csv($rs);

?>

结果如下:

姓名,年纪

abcde,45

yyy,20

ppp,34

mmm,13

hhh,41

rrr,65

kkk,29

miso,154

sss,89

abc,18

abcde,0

uyt,58

john,28

也可用tab分隔字段,使用rs2tab方法如下:

printrs2tab($rs,false);

注:false表示不显示字段名称

结果如下:

abcde45

yyy20

ppp34

mmm13

hhh41

rrr65

kkk29

miso154

sss89

abc18

abcde0

uyt58

john28

若是printrs2tab($rs,true);

结果如下:

姓名年纪

abcde45

yyy20

ppp34

mmm13

hhh41

rrr65

kkk29

miso154

sss89

abc18

abcde0

uyt58

john28

也可以将结果由标准输出(STDOUT)显示,使用rs2tabout方法如下:

printrs2tabout($rs);

执行结果如下:

Figure1.在console中显示结果

也可以存成CSV档:

//档案路径

$path="/tmp/test.csv";

//开档供写入

$fhd=fopen($path,"w");

//若开档成功

if($fhd){

//则写入CSV

rs2csvfile($rs,$fhd);

//也可以使用rs2tabfile($rs,$fhd);

//关档

fclose($fhd);

}

结果如下:

[ols3@pweb]$cat/tmp/test.csv

姓名,年纪

abcde,45

yyy,20

ppp,34

mmm,13

hhh,41

rrr,65

kkk,29

miso,154

sss,89

abc,18

abcde,0

uyt,58

john,28

16.取出一定笔数的记录(使用SelectLimit)

ADODB提供一个ADOConnect函式SelectLimit,可供您取出一定笔数的记录,用法如下:

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

rs=$conn->SelectLimit("Select*fromt",3,1);

//取出3笔、在第1笔之后

//秀出这3笔记录

if($rs){

while($ar=$rs->FetchRow()){

print$ar['name']."".$ar['year'];

print"<br>n";

}

}

上式是说:在第1笔记录之后,取出3笔,也就是第2、3、4笔记录。

结果如下:

--------------------------------------

(mysql):select*fromtLIMIT1,3

--------------------------------------

注意!SelectLimit的写法刚好和MySQL语法相反!

相关阅读
推荐文章
猜你喜欢
附近的人在看
推荐阅读
拓展阅读
  • 大家都在看
  • 小编推荐
  • 猜你喜欢
  • 最新php教程学习
    热门php教程学习
    编程开发子分类