ADODB 入门

原创 2007年09月19日 09:30:00

1. 前言

ADODB 是 Active Data Objects Data Base 的简称,它是一种 PHP 存取数据库的函式组件。

虽然 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 的简单用法:

<?phpPHPChina 开源社区门户BZm+d$@S*Wz
    // 引入 adodb 的 inc 档,才能呼叫 adodb 提供的函式
3c7jQ0O+W4|]S PPj31957    include('adodb/adodb.inc.php');

    // 选择连接的数据库种类,以建立联机对象PHPChina 开源社区门户,GT�pOf1e L8U
    // 一旦对象建立,即可使用其成员函式来处理数据库。
R)HO2e%j7~B31957    // 以下 $conn 即此一物件(object)PHPChina 开源社区门户 n/ d6|&I,dp
    $conn = &ADONewConnection('mysql');

    // 要不要显示侦错讯息,false 不要,true 要。PHPChina 开源社区门户c1Zm y7J~ qIG)d
    // $conn->debug = false;
2vdj3})X{j F31957   
5uP"Fa/ q4x$c31957    $conn->debug = true;

    // 连接数据库PHPChina 开源社区门户!F}f:b$J7B{1o$f
    // 用法:$conn->Connect('主机', '使用者', '密码', '数据库');PHPChina 开源社区门户9pCzI4/�Y)u7X
    // 用例:
*R�|b)YOIB U31957    $conn->Connect('localhost', 'piza', 'ooo123', 'test');

    // 若欲采用持续性连接,上式可换用 PConnect:PHPChina 开源社区门户$]0l2v6vz�B:yA0F
    // $conn->PConnect('localhost', 'piza', 'ooo123', 'test');

    // 设定 sql 命令PHPChina 开源社区门户3[pYk2B
    $sql = "insert into t values ('abcde', 18)";

    // 执行 sql 命令PHPChina 开源社区门户:j|aO*DHEW)a
    $rs = $conn->Execute($sql);

    // 检查执行结果,若 $rs == false,则呼叫 $conn 对象的成员函式 ErrorMsg()PHPChina 开源社区门户5g |2{#X4/6x.t
    if (!$rs) print $conn->ErrorMsg(); else print "OK!";

?>

PHPChina 开源社区门户!{})G,sG
结果如下:

---------------------------------------------PHPChina 开源社区门户4|$I2[-o HNz2L/k7e
(mysql): insert into t values ("abcde",18)
'i ?/?%U]-Rf1g'p31957---------------------------------------------PHPChina 开源社区门户5V6t e9y)ur2n j3d k:f
OK!


|D,g3V/~31957若把侦错关掉,即 $conn->debug=false,则结果如下:

OK!


Cm7?o w*sb q31957以下,逐步为各位介绍:使用 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
@%W4M)?-]:v'XxC31957adodb/adodb-csvlib.inc.php
4h a"K;Uk[;Z'b K@31957adodb/adodb-errorhandler.inc.php
0o{u!X/z9oif31957adodb/adodb-errorpear.inc.php
*M~qhO7W E7IaH5@#X31957adodb/adodb-lib.inc.php
j z7z;j�WX5mV31957adodb/adodb-pager.inc.php
*?-??6XTo/G&U V31957....以下省略....


2D!S-iAO t~e31957现在,您在 /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');


&H0RK'`O9X31957例:

若您的程序和 adodb 在同一目录下:

.PHPChina 开源社区门户8tm}Y9|G:I.S/j
..PHPChina 开源社区门户}%f*[%X$Ho6/&lM
adodb/PHPChina 开源社区门户 n#w4xo;Mc)aN_
something.php*


3HH1C2X n!A*d1In;j31957则:

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

即可。

若位置是在某一个目录 somedir 中:

.PHPChina 开源社区门户4Tj%s a&L*GH&o}�bb#FB
..PHPChina 开源社区门户P*T1RB?0j @3W
adodb
,a Z7~OJ2I2J*_g[31957somedir/something.php


FKH(?;I7j31957则必须使用:

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

PHPChina 开源社区门户FZ#l Y}(d%i$rg0t
除了 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 是一样的,二者皆可使用。


,Na/O6a)]T#vW?31957上例中的 '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

PHPChina 开源社区门户m/?!EUA A_.]8[
关闭侦错模式,使用法:

$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('主机', '使用者', '密码', '数据库');

    $conn->PConnect('localhost', 'piza', 'ooo123', 'test');PHPChina 开源社区门户 {(|4E/goR0g
 

若欲探查是否有联机成功,可用一个变量来接取传回值:

$mch="localhost";PHPChina 开源社区门户fDM5z3o']
$user="piza";
DcshbZ%gTE31957$pwd="ooo123";PHPChina 开源社区门户$O%`2@&`/s5t,^
$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);

PHPChina 开源社区门户8f#DcoO"wl:?|
其中,$rs 为回传的结果,若 $rs == false,则表示执行失败,您必须仔细检查一下。

您不一定要把命令语法放在 $sql 变量中,也可以直接放入 Execute( ) 括号中。若命令较短无妨,若命令较长,我建议您还是用一个变量 $sql 来设定命令字符串吧 !

下一节开始,为各位介绍 SQL 的基本命令,如:Insert、Select、Update、Delete 等等的用法。

8. 插入记录(Insert)

Insert 的用法如下:

// $name 为字符串,$year 为数字
Dmz9JizRq31957$name='abcde';PHPChina 开源社区门户G�?.m6_y
$year=18;

// 插入一笔记录,命令的大小写无妨,但数据表 t 及变量则大小写有分别 !
.WK8gh] D!y31957$sql = "INSERT INTO t VALUES ('$name', $year)";

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

// 执行
/O6TC$P$d"?31957$rs = $conn->Execute($sql);

// 检查执行结果,进行错误处理;若正常,则继续其它动作....
/d0d@D/k;E!h1A31957if (!$rs) print $conn->ErrorMsg();

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

PHPChina 开源社区门户1ep RE/"E1D
ErrorMsg() 是错误显示的函式,它会取出错误讯息,并显示出来。

另外,ADODB 提供一种 记录集(RecordSet) 函式 GetInsertSQL(),可帮您产生 Insert 的语法。

例子如下:

<?php

// 引入 ADODBPHPChina 开源社区门户0w(JRU%nVn^6jC
include('adodb/adodb.inc.php');

// 建立联机对象PHPChina 开源社区门户-s| CS#RK,ZH#N
$conn = &ADONewConnection('mysql');

// 侦错
MM Tq @8@&dn31957$conn->debug=true;

// DSN 四项基本数据设定PHPChina 开源社区门户J FR4LS;U(IQx,A
$mch="localhost";
(aX bTN#D.E4u#P{V31957$user="root";PHPChina 开源社区门户3U4?$w'z+_-L5if:p5h2d3C
$pwd="jack168";PHPChina 开源社区门户1v�` Z7Bt]&?RL8Cc
$database="test";

// 连接至数据库 test
6[6j;yK} [ wIT31957$conn->PConnect($mch, $user, $pwd, $database);

// 产生一笔空记录
(U"W [0X*D&_4N31957$sql = "select * from t where year=-1";

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


[{(I"ch1[tX1Vu-j31957// 用一个空数组来装要更新的数据PHPChina 开源社区门户_IIQ r:y%q;s0O'Tt|
$r = array();

$r['name']='john';
G.K On,U$V1r f&u"GX{9X31957$r['year']=28;

// 用 GetInsertSQL 函式来制作一个完整的 sql 命令,此 sql 命令放在 $insertSQL 中
9Y%K1Ul o;/TV31957$insertSQL = $conn->GetInsertSQL($rs, $r);

// 执行插入
j(jf d?31957$conn->Execute($insertSQL);

$conn->Close();PHPChina 开源社区门户 D$yn]F&a;X
?>


|.IW$u4}2j(t31957侦错讯息如下:

-----------------------------------------------------------
e{]N^9Xk#y31957(mysql): select * from t where year=-1
g!Ubo8FF+K31957-----------------------------------------------------------
[&F`d q wS31957(mysql): INSERT INTO t ( name, year ) VALUES ( 'john', 28 )
5I8OW(N@a)WB%`"O31957-----------------------------------------------------------
   

9. 取出记录(Select)

Select 的用法如下:

<?php

// 引入 ADODBPHPChina 开源社区门户/Jq8L0e'HW.e{
include('adodb/adodb.inc.php');

// 建立联机对象PHPChina 开源社区门户*iudlm1g1j
$conn = &ADONewConnection('mysql');

// 不侦错
k7[ P*J sp2L K31957$conn->debug=false;

// DSN 四项基本数据设定
._ N`0u0G6E[31957$mch="localhost";
t+~r5Q!{1F31957$user="piza";
9KS Qp;P8{j31957$pwd="ooo123";
a |!c.n O t|^`T]31957$database="test";

// 连接至数据库 test
c%t8UgS9Q2q&L(h31957$conn->PConnect($mch, $user, $pwd, $database);

// 执行 Select 由表格 t 取出数据,
&x V'c_g/n;D7D P31957// 它会传回一个 ADORecordSet 记录集对象 $rs (RecordSet)PHPChina 开源社区门户%z$uaN8Y$g2C1xh
// 实际上 $rs 是一个 cursor 指标,它拥有目前的记录(row 或称 record),
1F2PE$hwa'[$U v31957// 该记录的所有字段数据的内容,存放在 fields 这个数组之中PHPChina 开源社区门户4OgHl-w_(g%AN
// ,以数字为索引,第一个由 0 开始
)D5b/Va%i*kb^31957$rs = &$conn->Execute('select * from t');

// 若 $rs 为 false,则秀出错误讯息PHPChina 开源社区门户/alc-| L9K K%v
if (!$rs) {
E*ffEEy)i�gq31957    print $conn->ErrorMsg();
GXX3f,@q~a31957} else {

// 当尚未到达 记录集 $rs 的结束位置(EOF:End Of File)时,(即:还有记录尚未取出时)PHPChina 开源社区门户(f B!F9NA!o0W
    while (!$rs->EOF) {PHPChina 开源社区门户6},B*s7d G(G5}'z
        // 秀出所有字段,$FieldCount() 会传回字段总数
^y*Fy0H7hXq@-x31957    for ($i=0, $max=$rs->FieldCount(); $i < $max; $i++) {PHPChina 开源社区门户:x)j+L1V IJTrdV
        print $rs->fields[$i] . " ";PHPChina 开源社区门户Apv8Gu].nwA L
    }

        // 移至下一笔记录
VaS:x{.n z5SXy31957    $rs->MoveNext();
9} P8{NM3Z`e31957   
7u@y;uaB J*kk)p31957    // 换列
0wN+St"Xrftl31957    echo "<br>/n";
X2D[wq-C['q31957    }
"|^^7Kjg31957}

$rs->Close(); // 可不用PHPChina 开源社区门户h3@eG-Ax3{
$conn->Close(); // 可不用
7r'`*R9U(Zf#Vv T31957?>


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

若欲使用名称当作索引,也就是俗称的 hash 或 associative arrays,则需使用全域变量 $ADODB_FETCH_MODE 加以指定。

以下设定:使用数字索引 $ADODB_FETCH_MODE= ADODB_FETCH_NUM;

PHPChina 开源社区门户-Rz na:[
以下设定:使用名称索引 $ADODB_FETCH_MODE= ADODB_FETCH_ASSOC;

PHPChina 开源社区门户1V9?i}G-kW,U%b$?n
下面是使用名称索引的例子:

<?php

// 引入 ADODB
Z/VJLI2G/xF31957include('adodb/adodb.inc.php');

// 建立联机对象
_*y/w&~7f z31957$conn = &ADONewConnection('mysql');

// 不侦错PHPChina 开源社区门户W//O(R)H-oy$Z2F
$conn->debug=false;

// DSN 四项基本数据设定
%}5[QyH sK31957$mch="localhost";PHPChina 开源社区门户 j2R*}8F:M6M~C
$user="root";
um M4V#UE,a5a-G31957$pwd="jack168";PHPChina 开源社区门户8] t9wM/5^AC
$database="test";

// 连接至数据库 test
:Z1jNJ"l s31957$conn->PConnect($mch, $user, $pwd, $database);

// 执行 sql 之前,指定使用名称索引PHPChina 开源社区门户;mAdj9qq)a5C v
$ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;

// 执行 Select,它会传回一个 ADORecordSet 记录集对象 $rs
,I` XP7D8q'?!c#Of31957// 实际上 $rs 是一个 cursor 指标,它拥有目前的记录内容,PHPChina 开源社区门户!KqmC.Qz%vv6ZB
// 该记录存放在 fields 这个数组之中PHPChina 开源社区门户!H4}6{| d(z
$rs = &$conn->Execute('select * from t');

// 若 $rs 为 false,则秀出错误讯息
oL@!j y3Q31957if (!$rs) {
1s*P%a-U.eB31957    print $conn->ErrorMsg();
,SZ%JM1b/is7b31957} else {

// 当尚未到达记录集结束位置(EOF)时,PHPChina 开源社区门户 q H7s{5F$E H
    while (!$rs->EOF) {PHPChina 开源社区门户u~Y?#Y!r
        // 秀出所有字段

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

        // 移至下一笔记录
l'W*m-AH]31957    $rs->MoveNext();PHPChina 开源社区门户5u%|8Cf GhX je�_i
    PHPChina 开源社区门户)/P3p2Rp[!s ]E
    // 换列
&? `!}3y4l)gO8f31957    echo "<br>/n";
Q0C z(G5r+Z oT31957    }
y(g-P ?u$?31957}

$rs->Close();  // 可不用
/E M#j%F%F+U9Ee zw B31957$conn->Close(); // 可不用PHPChina 开源社区门户W+g{xQr$Q#V
?>

10. 取出记录(使用 FetchRow)

这里示范 FetchRow 的用法:

$sql = "select * from t";

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

if ($rs) {
y ^0E0`i1T%^D31957    while( $ar = $rs->FetchRow() ) {PHPChina 开源社区门户%g;Zxo'X O
        print $ar['name'] ." " . $ar['year'];
QJ:^ O`%x;A `-I31957        print "<br>/n";PHPChina 开源社区门户Lv6RHaF#^ b
    }

}

PHPChina 开源社区门户zq@VAf'c
FetchRow() 会将取出的记录传回,您可用一个 array 来接取。

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

11. 更新记录(Update)

您可以用传统的方式:

$sql ="UPDATE t SET name='john', year=28 WHERE year=18";
9F*`ld6EK7]8}31957$conn->Execute($sql);

PHPChina 开源社区门户@XSF7^vr @P
也可以用以下这种方式:

<?php

// 引入 ADODBPHPChina 开源社区门户�?�k;|*IDA7P?M!VF Q#O
include('adodb/adodb.inc.php');

// 建立联机对象PHPChina 开源社区门户/W,r4p,p%|3f
$conn = &ADONewConnection('mysql');

// 侦错PHPChina 开源社区门户` F'DYV#v
$conn->debug=true;

// DSN 四项基本数据设定PHPChina 开源社区门户.Q2/y6[xCD Q
$mch="localhost";PHPChina 开源社区门户2A(JSCa.U9X&P
$user="piza";PHPChina 开源社区门户~3w$h$w#O.~^N
$pwd="ooo123";PHPChina 开源社区门户 QE xd T [`3g
$database="test";

// 连接至数据库 test
w8Ho0N@5FO"Jf31957$conn->PConnect($mch, $user, $pwd, $database);

// 选择要更新的那一笔记录PHPChina 开源社区门户GY&] S L_kQ8oR
$sql = "select * from t where year=18";

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

PHPChina 开源社区门户Tq[8TE
// 用一个空数组来装要更新的数据PHPChina 开源社区门户y!/pP3O
$r = array();

$r['name']='john';
W{"k&A:yF)i z31957$r['year']=28;

// 用 GetUpdateSQL 函式来制作一个完整的 sql 命令,此 sql 命令放在 $updateSQL 中
l N)^l&D4NB31957$updateSQL = $conn->GetUpdateSQL($rs, $r);

// 执行更新PHPChina 开源社区门户0J({1I9h"}
$conn->Execute($updateSQL);

$conn->Close();
0]8y d)xuL31957?>

PHPChina 开源社区门户~;MnC7JR.E
侦错讯息如下:

-------------------------------------------------------------PHPChina 开源社区门户G4P%_"{A4T[iW
(mysql): select * from t where year=18
)J$N hx WX#~31957-------------------------------------------------------------
i@/c0f F9a/ F�?-Gu31957(mysql): UPDATE t SET name = 'john', year = 28 WHERE year=18PHPChina 开源社区门户 s}/Y~'?.m
-------------------------------------------------------------

12. 删除记录(Delete)

删除记录很简单,采传统方式即可: $sql = "DELETE FROM t WHERE year=18";

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

13. 使用字段对象(Field Objects)

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

$sql = "select * from t";

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

if ($rs) {
,Q PEZj&m a4A31957   while (!$rs->EOF) {
vbn$NI8n31957    // 取出第二个字段PHPChina 开源社区门户$kG1h/xfJ glm
    $f = $rs->FetchField(1);

    // 印出字段名称 及 字段型态
8/z2a D YA31957    print $f->name . ":" . $f->type;

    $rs->MoveNext();

    print "<br>/n";PHPChina 开源社区门户 Uwb,I9X(n_
   }
PdD ep,S31957}
#_)O1dV`,y ]�O31957
 

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

C : 字符
?(w-}?o.X7l31957X : textPHPChina 开源社区门户k_F q r-gW`%f9BQ2V6~
B : blobPHPChina 开源社区门户};T3L,C.l}E
D : 日期PHPChina 开源社区门户] _dl6iqv%O%b2g-|
T : timestampPHPChina 开源社区门户 x {/%BS5}R"c
L : 布尔值或位
b9E)a:PP3s.hfV31957I : 整数PHPChina 开源社区门户? ir6} T Z
N : 数字型态,包括:自动增加、数值、浮点数、实数及整数PHPChina 开源社区门户Tw*Q,g5w5L
R : serial、自动增加


3W%U#B N0k-J~Yk31957用例: 

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

    // 印出字段名称 及 字段型态的代码
Na Y4Fd8N-x:Q31957    print $f->name . ":" . $rs->MetaType($f->type);

14. 简单分页(Pager)

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

<?php

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

// 引入分页功能PHPChina 开源社区门户9{P.t*l']u
include('adodb/adodb-pager.inc.php');

// 启动 session
N+Q,}ES N31957session_start();

$db = ADONewConnection('mysql');

$mch="localhost";PHPChina 开源社区门户^-Q rD(Kq,q
$user="piza";PHPChina 开源社区门户B%PX9Gw /
$pwd="ooo123";
3}2QN0o1@HK ?31957$database="test";

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

$sql = "select * from t";

// 产生 pager 对象PHPChina 开源社区门户L {;YLpN3N]
$pager = new ADODB_Pager($db, $sql);

// 每一页秀 5 笔记录PHPChina 开源社区门户(DE!G1M:o?5m CT
$pager->Render($rows_per_page=5);

?>


z8Kx*i1A31957结果如下:

Figure 1. 简单分页功能


A1j%XM(d_ c S"O;D5{31957每页显示记录的数目是由 Render() 来控制的,若没有传入指定的 row 数给 Render(),默认值每页秀 10 笔。

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

<?php

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

// 引入分页功能PHPChina 开源社区门户]2e8a[)]Q?
include('adodb/adodb-pager.inc.php');

// 启动 session
5a)vvIF*Dnl Yc31957session_start();

$db = ADONewConnection('mysql');

$mch="localhost";
"~'?!{(c|&Q9@~4Q31957$user="piza";
4X%]o)I�/31957$pwd="ooo123";PHPChina 开源社区门户 ~|;ZpacPE
$database="test";

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

$sql = "select name as '姓名', year as '年纪' from t";

// 产生 pager 对象
1u6V$K X,q31957$pager = new ADODB_Pager($db, $sql);

// 每一页秀 5 笔记录
_rA2J/`A31957$pager->Render($rows_per_page=5);
7z q�j^y~5GG31957?>

PHPChina 开源社区门户x6S)A;wxo?
结果如下:

Figure 2. 改变字段名称

PHPChina 开源社区门户6V3wdF;O D_*`e
15. 输出 CSV 档

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

<?php

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

// 引入输出 CSV 文件功能PHPChina 开源社区门户xm$vtR*t1|
include('adodb/toexport.inc.php');

$db = ADONewConnection('mysql');

$mch="localhost";PHPChina 开源社区门户i)]$tVsZ
$user="piza";
4Q#{!q�M$Ik1oy#e31957$pwd="ooo123";PHPChina 开源社区门户`g1G7s;GK2h5N
$database="test";

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

$sql = "select name as '姓名', year as '年纪' from t";

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

// 秀出 CSV 格式
)a$u5p6U ourS%e em31957print rs2csv($rs);PHPChina 开源社区门户7By7y0sa:P H
?>


U1]_|"o31957结果如下:

姓名,年纪PHPChina 开源社区门户4ZV.X1?$zU2a
abcde,45PHPChina 开源社区门户:v hNj]g,?~$s
yyy,20PHPChina 开源社区门户q p,OzL;Tie#M
ppp,34
i{Zc!P,N:x3L31957mmm,13
"v tw?�y(yh+u+b iH31957hhh,41
@[`5_[%}%Q@6G31957rrr,65PHPChina 开源社区门户3A&^]$Y�kG4[
kkk,29PHPChina 开源社区门户D)H y1l-px$NC#H
miso,154PHPChina 开源社区门户T2M;/2/{(m aPc
sss,89PHPChina 开源社区门户.H/u;w%}:{h*J
abc,18PHPChina 开源社区门户 w+Y/|0_c0v
abcde,0PHPChina 开源社区门户4gm/wi3/
uyt,58PHPChina 开源社区门户+E_6J8p8w�X@
john,28

PHPChina 开源社区门户0EUe UE%SL4i G
也可用 tab 分隔字段,使用 rs2tab 方法如下:

print rs2tab($rs, false);

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

结果如下:

abcde  45
(G0EHV!N Sw2R Z31957yyy    20PHPChina 开源社区门户"x)V6/(nZ0f@.P:Q`
ppp    34
at)s8}$M6|31957mmm    13PHPChina 开源社区门户/0V:sc Kl
hhh    41PHPChina 开源社区门户L:{"KkX4v.L EH
rrr    65
x0A(S9FV3|*i31957kkk    29PHPChina 开源社区门户/K6w$u9g(`^ pI-U2I
miso   154PHPChina 开源社区门户YH /M VQ
sss    89
x3@^$Pn K Q31957abc    18
/oHJ;NY/M�L31957abcde  0PHPChina 开源社区门户O-xS0l _ Rw
uyt    58
-}g4k4}k31957john   28

若是 print rs2tab($rs, true);PHPChina 开源社区门户Y-Od1O!ZH5IH
结果如下:

姓名    年纪
Z2P6Zm,Y31957abcde   45
u4Bv-ShA2z31957yyy     20
2p'w4N-u /6S"|.i31957ppp     34PHPChina 开源社区门户:~!N"m`5M*~I`
mmm     13
Dd"/%S]5r31957hhh     41PHPChina 开源社区门户v6I[*Y.I*Q)@+@ nR
rrr     65
#NfP(W#B2?31957kkk     29
s-/$|-/ Th#x4y31957miso    154
q#Y#f6X9jbM&t31957sss     89PHPChina 开源社区门户iS&Q8^_
abc     18
Go]?QKo4q ow31957abcde   0PHPChina 开源社区门户vX7kS:S
uyt     58
xY)O4cqa31957john    28


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

print rs2tabout($rs);


.DTn4u@4w31957执行结果如下:

Figure 1. 在console中显示结果


y0zH*h J6c Vf+Z31957也可以存成 CSV 档:

// 档案路径PHPChina 开源社区门户l"Li{z7j9}O
$path = "/tmp/test.csv";

// 开档供写入PHPChina 开源社区门户U[b(Bp!H#K
$fhd = fopen($path, "w");

// 若开档成功
_9b7|S:UFHG31957if ($fhd) {

   // 则写入 CSVPHPChina 开源社区门户?k^#Y&Bd B�Xfl:P$]
   rs2csvfile($rs, $fhd);

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

   // 关档PHPChina 开源社区门户3`4bybO
   fclose($fhd);PHPChina 开源社区门户k0]s;ql9}8M Z!n
}

结果如下:

[ols3@p web]$ cat /tmp/test.csvPHPChina 开源社区门户 Yl/WxWgQ$Dn
姓名,年纪
,@9o /4].{{_+W%Ei31957abcde,45PHPChina 开源社区门户]gKY6Yp
yyy,20
I wS'I)n1ZDd/Wa6p31957ppp,34PHPChina 开源社区门户N2W,vR b/6j
mmm,13PHPChina 开源社区门户5Q�xk*g"VC@
hhh,41PHPChina 开源社区门户,G j2LO/"u/r:?D
rrr,65PHPChina 开源社区门户1c&m1NL:WIA4|t[
kkk,29PHPChina 开源社区门户h4byeA4}U
miso,154
$?0SV] w#w!Z7L31957sss,89
t7YsN|R31957abc,18PHPChina 开源社区门户E3rqfe
abcde,0
yb6XC2Vt31957uyt,58
4f$gha Dr31957john,28

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

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

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

rs = $conn->SelectLimit("Select * from t", 3, 1);
]mG2Y.fm NF31957//                             取出 3 笔、在第 1 笔之后

// 秀出这 3 笔记录PHPChina 开源社区门户(o2k5L#YS3y)g:y
if ($rs) {
$_d/C"E"K)^Z s3L2kjl31957    while( $ar = $rs->FetchRow() ) {
%F9H4N6@ Rq31957        print $ar['name'] ." " . $ar['year'];PHPChina 开源社区门户y+N0B }i!B
        print "<br>/n";PHPChina 开源社区门户L4|8?.v2w
    }

}


!J:m o-D-[ M^5T31957上式是说:在第 1 笔记录之后,取出 3 笔,也就是第 2、3、4 笔记录。

结果如下:

--------------------------------------
E9AeF7h2bm31957(mysql): select * from t LIMIT 1,3PHPChina 开源社区门户8sII(q$y;T
--------------------------------------

注意 ! SelectLimit 的写法刚好和 MySQL 语法相反 !  
版权声明:本文为博主原创文章,未经博主允许不得转载。

相关文章推荐

ADODB 入门学习基础教程

1. 前言ADODB 是 Active Data Objects Data Base 的简称,它是一种 PHP 存取数据库 的函式组件。现在 SFS3 系统 (校园自由软件交流网学务系统) 计划的主...

ADODB 入门学习基础教程[多图]

ADODB 入门学习基础教程[多图] 1. 前言 ADODB 是 Active Data Objects Data Base 的简称,它是一种 PHP 存取数据库的函式组件。现在 SFS3 ...

ADODB入门手册

英文原版位置:http://phplens.com/lens/adodb/tute.htm   ADODB入门手册:从MySQL向ADODB转移 You say eether and I say...

ADODB是如何完成符号转义的

今天在研究PHP+MYSQL的 SQL注入攻击, 发现许多攻击 都是从 单引号(')开始的, 即:如果php.ini中 magic_quotes_gpc = off ,  输入内容中有 单引号(') ...

Adodb入门教程

  • 2013-08-11 21:25
  • 63KB
  • 下载

ADODB php入门教程

  • 2011-09-09 20:03
  • 63KB
  • 下载

IIS7.0配置ASP网站出现 :ADODB.Connection 错误 '800a0e7a'

问题: IIS7.0配置ASP网站出现下面错误: ADODB.Connection错误 '800a0e7a' 未找到提供程序。该程序可能未正确安装。 /asp/mssql/Conn.asp,行...

adodb

不管后端数据库如何,存取数据库的方式都是一致的,开发设计人员不必为了某一套数据库,而必须再学习另一套不同的存取方法,这大大减轻开发人员的知识负担,过去的知识往后仍可继续使用。 ADODB 是 A...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:深度学习:神经网络中的前向传播和反向传播算法推导
举报原因:
原因补充:

(最多只允许输入30个字)