`
varsoft
  • 浏览: 2438926 次
  • 性别: Icon_minigender_1
  • 来自: 上海
文章分类
社区版块
存档分类
最新评论

PHP ADODB1.99版手册 (修正版)

PHPMySQLSQLOracleSQL Server 
阅读更多

PHP ADODB 1.99版手册中文翻译 <修正版>


感谢
记事

PHP ADODB 1.99版手册中文翻译 <修正版>


感谢
记事

PHP ADODB 1.99版手册中文翻译
翻译作者：Tripc
修正作者：heiyeluren
----------------------------------------------

修正说明：因为之前的版本是台湾版的，所以很多语句不符合大陆的使用习惯，于是我稍微用Editplus修正了一下，希望给学习ADODB的同志们一个参考。
(heiyeluren修正于2005-6-22)

ADODB

PHP 在数据库的支持上是很令人称道的，几乎所有的知名数据库系统都有对应的函数群支持，而且支持的很完整。但很不幸的，每一群数据库支持函数无论在名称或参数结构上，都有很大的差异，这使得PHP的系统开发者在面临更换数据库时，总会觉得痛苦万分。难道这个问题就没有解决方法吗？呵呵，当然有，答案就是我现在要介绍的 ADODB 这个PHP物件。

ADODB提供了完整的方法和属性让工程师去控制数据库系统，更棒的是你只要记得它的功能就好了，因为不同的数据库系统，只要修改一个属性值就可以了，ADODB会自动依据设定取用正确的PHP函数。此外，最多再配合数据库系统修改修改SQL指令，你的PHP系统就可以在最短的时间内更换到另一个数据库系统了，如果在编写程序时，对SQL指令能做妥善规划，那就更快了。

经过以上的介绍，相信你已经对ADODB的功用有所了解，以下为ADODB的详细介绍。

取得ADODB

你可以在 http://php.weblogs.com/ADOdb 取得最新版的ADODB。我在编写本文时，最新版本是1.99版，版权采BSD-Style及LGPL双轨制，换句话就是Freeware，没有什么限制。但在取得ADODB后，最好还是要看一下相关版权说明及用法，并和本文对照一下，以免错误。

使用ADODB

基本上使用ADODB是相当容易的，取得压缩文件后解开，我建议将整个内容都解到ADODB的目录里。然后你可以一边参考本文，一边研究里面的范例，就放在里面的test目录下。

由于ADODB附上的说明十分完整详实，以下的说明大部份来自ADODB的readme.htm，这里不是全部的内容，我把一些我认为没有用的内容都去掉了，像版本差异说明、何编写支持ADODB的驱动程序等与应用无关的部份。想要了解全部内容的读者还是可以自己去参考 readme.htm。

简介

由于PHP的数据库存取函数没有标准化，所以我们需要一组函数库或是类别来隐藏不同数据库函数介面间的差异，让我们可以很简单的去切换数据库，而这，就是ADODB的目的。

ADODB目前支持MySQL, Oracle, Microsoft SQL Server, Sybase, Sybase SQL Anywhere, Informix, PostgreSQL, FrontBase, Interbase (Firebird 及 Borland 版本), Foxpro, Access, ADO 和 ODBC。ADODB也有透过ODBC成功连接Progress及DB2的报告，我们希望能有更的人提供驱动介面来支持更多的数据库。

PHP4支持连接变量(session variables)，使用者可以透过ADODB保存连接信息，以达成真正的可携性及弹性，相关的用法及信息请自行参考ADOdb-session.php这个范例。

另外，如果要编写一个具有高度可移植性的SQL码，也可以参阅 http://php.weblogs.com/portable_sql 这篇文章。

特色

  • 对熟悉Windows的工程师而言，ADODB很容易使用，因为ADODB里的很多功能和Microsoft的ADO很像。

  • 与其它的PHP数据库类别不同，它们大多集中在处理与 select 指令有关的东西，而ADODB对于 inserts 及 update 也提供额外的支持，并且可以很快的连接到多数据库。所提供的方法更扩及日期的掌握，字串的连接及字串标记字元差异处理(在某些数据库间字串的连接和标记符号是有差异的)

  • 类型对照系统是内建的，所以我们可以设定或描述像CHAR,TEXT及STRING在不同的数据库间其实是相同的数据类型。

  • 更容易去移植，因为所有与数据库相依的程序码被都隐藏在后端，所以使用者不再需要去移植类别里的逻辑。

  • 支持 PHP4 连接变量，请参考 ADOdb-session.php。

安装

首先要确定你所使用的PHP版本是 4.01pl2 或是之后的版本(因为ADODB使用到了 require_once及include_once两个函数)。解压缩全部的文件到你的Web服务器可以存取的一个目录里。

要测试ADODB你需要一个数据库，开启 testdatabase.inc.php 这个文件，并且修改连接参数，以适合你所使用的数据库。这个程序会建立一个新的数据表在你的数据库中，以支持我们提供的测试程序及范例。

就这样，你安装好了。

启动ADODB

当要执行ADODB时，至少有两个文件要被载进来，第一个是 ADOdb.inc.php ，这里面包含了所有数据库类中要被使用的函数。而对数据库实作的程序码则被置放在ADOdb-????.inc.php文件里。

例如说，要连接一个mysql数据库：

include('/path/to/set/here/ADOdb.inc.php');
$conn = &ADONewConnection('mysql');

无论何时你需要连接到一个数据库时，你必需使用ADONewConnection()函数建立了一个连接物件。ADONewConnection接受一个选择性参数, <database-name-here>。如果没有参数被指定，它将会使用被 ADOLoadCode() 所载入的最后一个数据库。 NewADOConnection() 是另一个相同的函数。

当你建立好一个连接物件时，你并没有真的连接上你的数据库。你仍需要使用 $conn->Connect() 或者 $conn->PConnect() 两个方法来完成真正的连接。

你可以参考教学手册里的范例，对上面的说明做更深入的了解。

支持的数据库

名称

测试状态

数据库

RecordCount() 支持与否

需安装的驱动程序

操作系统

access

B

Microsoft Access/Jet. 需要建立一个 ODBC/DSN。

Y/N

ODBC

Windows only

ado

B

一般未经特别指定的数据库系统， 透过ADO，允许不设定 DSN连接，使用OLEDB以提供较佳的效能。

? 视数据库而定

ADO or OLEDB provider

Windows only

ado_access

B

Microsoft Access/Jet 透过ADO，允许不设定 DSN连接，使用OLEDB以提供较佳的效能。

Y/N

ADO or OLEDB provider

Windows only

ado_mssql

B

Microsoft SQL Server 透过ADO，允许不设定 DSN连接，使用OLEDB以提供较佳的效能。

Y/N

ADO or OLEDB provider

Windows only

db2

C

DB2. 可以透过ODBC获得可以信赖的运作效果。

Y/N

DB2 CLI/ODBC interface

Unix and Windows. Unix install hints.

vfp

A

Microsoft Visual FoxPro，需要建立一个ODBC/DSN

Y/N

ODBC

Windows only

fbsql

C

FrontBase.

Y

?

Unix and Windows

ibase

B

Interbase 6或更早的版本。有些使用者报告必需使用如下的方式连接
$db->PConnect('localhost:c:/ibase/employee.gdb', "sysdba", "masterkey")目前没有支持 Affected_Rows 方法

Y/N

Interbase client

Unix and Windows

firebird

C

interbase的Firebird版本

Y/N

Interbase client

Unix and Windows

borland_ibase

C

Borland 的Interbase 6.5 或更新版

Y/N

Interbase client

Unix and Windows

informix

C

Informix

Y/N

Informix client

Unix and Windows

mssql

A

Microsoft SQL Server 7.也可以和Microsoft SQL Server 2000运作的很好。但在日期格式上仍有一些问题。例如在日期时间的返回值上，就不会返回秒数数值。

Y/N

Mssql client

Unix and Windows.
Unix install howto.

mysql

A

MySQL 不支持交易处理

Y/N

MySQL client

Unix and Windows

mysqlt 或 maxsql

A

MySQL 支持交易处理

Y/N

MySQL client

Unix and Windows

oci8

A

Oracle 8/9. 支持比 oracle 驱动程序还多的功能 (例如： Affected_Rows). 在连接之前，你可能需要先配好环境变量('ORACLE_HOME=...')

有两个方式进行连接，用服务器的IP或服务名称：
PConnect('serverip:1521','scott','tiger','service')
PConnect('', 'scott', 'tiger', 'tnsname').

Y/N

Oracle client

Unix and Windows

oci8po

A

Oracle 8/9 可携式驱动程序

Y/N

Oracle client

Unix and Windows

odbc

A

标准 ODBC

用 PConnect('DSN','user','pwd').连接。

? depends on database

ODBC

Unix and Windows. Unix hints.

odbc_mssql

C

用 ODBC 连接 MSSQL

Y/N

ODBC

Unix and Windows.

odbc_oracle

C

用 ODBC 连接 ORACLE

Y/N

ODBC

Unix and Windows.

oracle

C

支持旧的 Oracle 7 client API. 不支持 $ADODB_FETCH_MODE.

Y/N

Oracle client

Unix and Windows

postgres

A

PostgreSQL 不支持 LIMIT 指令.

Y

PostgreSQL client

Unix and Windows.

postgres7

A

PostgreSQL 支持 LIMIT 及其它版本 7 功能

Y

PostgreSQL client

Unix and Windows.

sqlanywhere

C

Sybase SQL Anywhere.

Y/N

SQL Anywhere ODBC client

?

sybase

C

Sybase.

Y/N

Sybase client

Unix and Windows. Unix hints.

　

测试状态栏的代码说明如下：

A=已经经过很多人验证及测试，可靠度最高。
B=已经测试并使用了，但可能仍有一些功能没有达成。
C=使用者自行配置或试用的驱动程序，可能没有完全支持ADODB的功能。

"RecordCount()支持与否"，指的是RecordCount()函数是否会返回用SELECT指令取得的记录笔数(不支持时传回-1)。如果这个字段的值出现了 Y/N ，那表示当全域变量 $ADODB_COUNTER=true 时，会以模拟的方式取得，而这是预设值。要注意的是，如果你预测记录笔数会很大时，最好把这个值设为false，也就是关掉这个模拟功能，因为这会耗掉非常多的内存，以做为快取之用。由于这个变量在每次执行时都会检查，所以你可以选择性的使用或不使用。

所有支持$ADODB_FETCH_MODE的数据库都支持 ADODB_FETCH_NUM(以字段顺序存取) 及 ADODB_FETCH_ASSOC(以字段名称存取)，两种模式。而将值设为 ADODB_FETCH_DEFAULT(数据库预设模式存取)，则是由数据库的功能来决定的，所以不具备可携性，而 ADODB_FETCH_BOTH(双模式存取) 也一样。

学习手册

范例 1: Select 指令

任务：连接到 Access 的 Northwind DSN，然后在每一列显示头2个字段。(Northwind 北风数据库，在ODBC设定的DSN，是Access的标准范例数据库)

在这个范例中，我们建立一个 ADOConnection 物件，它代表了和数据库的连接。连接是以 PConnect 函数来初始化的，然后会持续的连接着。任何时候我们要查询数据库时，我们就调用 ADOConnection.Execute() 函数，这将会返回一个 ADORecordSet物件。事实上它只是一个指向在fields[]阵列中，目前记录的指标，我们使用MoveNext()来在记录间移动。

注意：另一个很有用的函数 SelectLimit 并没有在这个范例里使用，这个函数允许我们去限制显示的数据笔数。 

<?
include('ADOdb.inc.php');       # 载入ADODB
$conn = &ADONewConnection('access');    # 建立一个连接
$conn->PConnect('northwind');   # 连接到 MS-Access 北风数据库
$recordSet = &$conn->Execute('select * from products');
if (!$recordSet) 
        print $conn->ErrorMsg();
else
while (!$recordSet->EOF) {
        print $recordSet->fields[0].' '.$recordSet->fields[1].'<BR>';
        $recordSet->MoveNext();
}

$recordSet->Close(); # 选择性执行
$conn->Close(); # 选择性执行

?>

在这个例子中，$recordSet返回了存在$recordSet->fields阵列里，目前所指向的记录。以字段编号为索引，起始值为0。我们使用MoveNext()函数来移动到下一笔记录，当到了最后一笔时，EOF属性会被设定为true。当Execute()函数执行有错误时，会返回一个false值，而不是一个recordset物件。

$recordSet->fields[]阵列是由PHP数据库扩充函数库所产生的。有一些数据库扩充函数库仅支持以编号来进行索引，而不支持以字段名为索引。要强迫使用字段名索引，也就是要使用关连式阵列，请使用 $ADODB_FETCH_MODE 全域变量来设定。当一个数据集被Execute()或是SelectLimit()函数建立时，都会保存而且使用储如此类的设定模式。 

       $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
        $rs1 = $db->Execute('select * from table');
        $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;
        $rs2 = $db->Execute('select * from table');
        print_r($rs1->fields); # shows array([0]=>'v0',[1] =>'v1')
        print_r($rs2->fields); # shows array(['col1']=>'v0',['col2'] =>'v1')

上面的范例说明，如果要以顺序来存取字段，就将 $ADODB_FETCH_MODE 的值设为 ADODB_FETCH_NUM，要以关连式阵列(以字段名)存取字段，就要将值设为 ADODB_FETCH_ASSOC。

要取得在被选到的记录笔数，你可以使用$recordSet->RecordCount()方法。注意，如果不能确定得到的记录笔数，会返回 -1 。

范例 2: 进阶的 Select 指令(使用 Field 物件)

任务：选取一个数据表，显示最前面的二栏。如果第二栏是一个日期或时间型态字段，将它格式化成US格式。

<?
include('ADOdb.inc.php');       
$conn = &ADONewConnection('access');    
$conn->PConnect('northwind');   
$recordSet = &$conn->Execute('select CustomerID,OrderDate from Orders');
if (!$recordSet) 
        print $conn->ErrorMsg();
else
while (!$recordSet->EOF) {
        $fld = $recordSet->FetchField(1);
        $type = $recordSet->MetaType($fld->type);

        if ( $type == 'D' || $type == 'T')
                print $recordSet->fields[0].' '.
                        $recordSet->UserDate($recordSet->fields[1],'m/d/Y').'<BR>';
        else 
                print $recordSet->fields[0].' '.$recordSet->fields[1].'<BR>';

        $recordSet->MoveNext();
}
$recordSet->Close(); # optional
$conn->Close(); # optional

?>

在这个例子中，我们使用 FetchField() 函数来检查第二个字段的数据类型。这将会返回一个至少有三个字段的物件，字段说明如下：

  • name: 字段名

  • type: 字段的数据原生类型native field type of column

  • max_length: 字段的最大长度，部份数据库像MySQL，并不返回字段的正确值，以这个例子而言，就会返回 -1 。

然后我们使用 MetaType() 去转换原生类型成通用类型，目前通用类型定义如下：

  • C: character 字段，应该使用 <input type="text"> 标记来取值。

  • X: 文字字段(Text) , 长文字字段，使用 <textarea> 标记来显示数据。

  • B: Blob 字段或者大型的二位元物件(像程序,图档等)。

  • D: 日期字段

  • T: 时间字段

  • L: 逻辑字段(真假值)或位元字段

  • N: 数字字段，包含自动进位、编号、整数、浮点数、实数等。

  • R: 序列字段，包含了序列、自动增进整数，只对被选择的数据库作用。

如果对应类型是日期或时间，那你可以使用 UserDate() 函数来设定输出的日期格式。这个函数会转换 PHP SQL 日期字串格式为使用者定义的格式。 另一个使用MetaType()的时机是在进行SQL新增或更新指令时，数据格式验证用。

范例 3: 新增

新增一笔记录到订单数据表，里面包含了日期和字串，为了能被数据库正常存取，字串必需校正，以避免部份标记字元。例如：有单引号的字串，John's。

<?
include('ADOdb.inc.php');       # load code common to ADOdb
$conn = &ADONewConnection('access');    # create a connection

$conn->PConnect('northwind');   # connect to MS-Access, northwind dsn
$shipto = $conn->qstr("John's Old Shoppe");

$sql = "insert into orders (customerID,EmployeeID,OrderDate,ShipName) ";
$sql .= "values ('ANATR',2,".$conn->DBDate(time()).",$shipto)";

if ($conn->Execute($sql) === false) {
        print 'error inserting: '.$conn->ErrorMsg().'<BR>';
}
?>

在这个范例中，我们看见了ADODB更进一步的日期及标点符号的处理方式。Unix 日期时间标示(长整数)被DBDate()格式化成Access可以接受的格式，而带了缩写符号的 John's Old Shoppe 则被 qstr() 函数处理成 John''s Old Shoppe 字串，以被数据库合法存取。

观察 Execute 指令的错误处理。如果 Execute() 执行有错误发生时，会传回 False 值。而最后的错误信息可以由 ErrorMsg() 来显示。

附记：php_track_errors旗标可以被启动，以便将错误信息保存起来。

范例 4: 除错 

<?
include('ADOdb.inc.php');       # load code common to ADOdb
$conn = &ADONewConnection('access');    # create a connection
$conn->PConnect('northwind');   # connect to MS-Access, northwind dsn
$shipto = $conn->qstr("John's Old Shoppe");
$sql = "insert into orders (customerID,EmployeeID,OrderDate,ShipName) ";
$sql .= "values ('ANATR',2,".$conn->FormatDate(time()).",$shipto)";
$conn->debug = true;
if ($conn->Execute($sql) === false) print 'error inserting';
?>

在上面的例子中，我们藉由设定 debug=true 来启动除错模式。这将会在执行指令时会先将SQL指令显示，并且会显示所有的错误信息，而不需要去调用 ErrorMsg() 。显示数据集的部份，可以参考 rs2html() 范例。

其它的请参考自定错误处理的说明。

范例 5: MySQL及选单

连接到MySQL数据库agora ，并且从SQL命令中建立一个 <select> 选单，<option>的标题是第一个字段，返回值是第二个字段。

<?
include('ADOdb.inc.php'); # load code common to ADOdb
$conn = &ADONewConnection('mysql');  # create a connection
$conn->PConnect('localhost','userid','','agora');# connect to MySQL, agora db
$sql = 'select CustomerName, CustomerID from customers';
$rs = $conn->Execute($sql);
print $rs->GetMenu('GetCust','Mary Rosli');
?>

Here we define a menu named GetCust, with the menu option 'Mary Rosli' selected. See GetMenu(). We also have functions that return the recordset as an array: GetArray(), and as an associative array with the key being the first column: GetAssoc().

这里，我们定义了一个名为GetCust的选单，预设值是'Mary Rosli'。相关说明请参考 GetMenu() 。我们也将数据集以阵列返回的方式写在 GetArray()方法里。而另外返回关联式阵列的方法则使用 GetAssoc() ,其中第一个字段是这个字段的键值。

在 1.50 版以后的 ADODB 里，是使用公共变量 $ADODB_FETCH_MODE 来设定返回的阵列是以编号或是关连式字串做索引。

范例 6: 一次连接两个数据库 

<?
include('ADOdb.inc.php');     # 载入 ADOdb
$conn1 = &ADONewConnection('mysql');  # 建立一个 mysql 连接
$conn2 = &ADONewConnection('oracle');  # 建立一个 oracle 连接

$conn1->PConnect($server, $userid, $password, $database);
$conn2->PConnect(false, $ora_userid, $ora_pwd, $tnsname);

$conn1->Execute('insert ...');
$conn2->Execute('update ...');
?>

范例 7: 产生 Update 及 Insert 的SQL指令

ADODB 1.31版起，新增了两个数据集函数：GetUpdateSQL()及GetInsertSQL()。这允许你在执行了像"SELECT * FROM table query WHERE..."这样的查询函数后，建立一个 $rs->fields复本，改变这些字段，然后自动产生出更新或是新增的SQL指令。

以下我们展示如何运用这些函数，我们将存取一个数据表，带有下列字段：(ID,FirstName,LastName,Created)。在这些函数被执行前，你需要藉由一个对数据表的查询指令(select)来初始化一个数据集。

<?
#==============================================
# GetUpdateSQL() 及 GetInsertSQL() 范例码
#==============================================
include('ADOdb.inc.php');
include('tohtml.inc.php');

#==========================
# 以下的程序码测试新增状态

$sql = "SELECT * FROM ADOXYZ WHERE id = -1";
# 从数据库中查询出一个空的数据集

$conn = &ADONewConnection("mysql"); # 建立一个连接
$conn->debug=1;
$conn->PConnect("localhost", "admin", "", "test"); # 连接到 MySQL, 数据库名称为 test
$rs = $conn->Execute($sql); # 执行查询，并取得一个空的数据集

$record = array(); # 初始化一个阵列，以便存放记录数据供新增用

# 设定记录中的字段值
$record["firstname"] = "Bob";
$record["lastname"] = "Smith";
$record["created"] = time();

# 传入空的数据集及字段数据阵列到GetInsertSQL函数中，以执行功能
# 这个函数将会依传入的数据，返回一个全格式的 INSERT SQL指令

$insertSQL = $conn->GetInsertSQL($rs, $record);

$conn->Execute($insertSQL); # 将记录挿入数据库中

#==========================
# 以下的程序码测试更新状态

$sql = "SELECT * FROM ADOXYZ WHERE id = 1";
# 选择一笔记录以便更新

$rs = $conn->Execute($sql); # 执行这个查询，并取得一个存在的记录来更新

$record = array(); # 初始化一个阵列，以存放要更新的数据

# 设定字段里的值
$record["firstname"] = "Caroline";
$record["lastname"] = "Smith"; # 更新 Caroline的姓由 Miranda 变成 Smith

# 传入这个只有单一记录的数据集以及含有数据的阵列到 GetUpdateSQL函数里
# 函数将会返回一个具有正确 WHERE 条件的 UPDATE(更新) SQL 指令
$updateSQL = $conn->GetUpdateSQL($rs, $record);

$conn->Execute($updateSQL); # 更新数据库中的记录
$conn->Close();
?>

范例 8: 使用上一笔及下一笔实作卷动

我们使用HTTP取得 $next_page 变量，以追踪要跳去那一页并且保存目前页码在 session 变量 $curr_page 里。

我们调用连接物件的 PageExecute()函收去取得我们要的数据集，然后我们使用数据集的 AtFirstPage() 及 AtLastPage() 函数去决定是否显示下一页和上一页按钮。 

<?php
include_once('ADOdb.inc.php');
include_once('tohtml.inc.php');
session_register('curr_page');

$db = NewADOConnection('mysql');
$db->Connect('localhost','root','','xphplens');
$num_of_rows_per_page = 10;
$sql = 'select * from products';

if (isset($HTTP_GET_VARS['next_page']))
        $curr_page = $HTTP_GET_VARS['next_page'];
if (empty($curr_page)) $curr_page = 1; ## at first page

$rs = $db->PageExecute($sql, $num_of_rows_per_page, $curr_page);
if (!$rs) die('Query Failed');

if (!$rs->EOF && (!$rs->AtFirstPage() || !$rs->AtLastPage())) {
        if (!$rs->AtFirstPage()) {
?>
<a href="<?php echo $PHPSELF,'?next_page=',$rs->AbsolutePage() - 1 ?>">Previous page</a>
<?php
        }
        if (!$rs->AtLastPage()) {
?>
<a href="<?php echo $PHPSELF,'?next_page=',$rs->AbsolutePage() + 1 ?>">Next page</a>
<?php
        }
        rs2html($rs);
}
?>

以上的程序码可以在 testpaging.php 范例里找到。

使用自定错误处理及 PEAR_Error

在之前的版本，你可以使用像 $con->debug=true ; 这样的设定来进行除错。但在 1.50 版后，我们提供了另一种方法来处理错误状态。我们让工程师可以使用 ADODB 的自订错误处理程序功能。

ADODB 提供了两种自订处理方式，你可以配合你的的需要而修订。第一个方法放在 ADOdb-errorhandler.inc.php 文件里。这让你可以使用标准的 PHP 函数 err_reporting 去控制要显示怎样的错误信息及 trigger_error 去调用 PHP 预设的错误处理程序。

引入了上述文件后(ADOdb-errorhandler.inc.php)，当发生了下列的错误后，将会使得 trigger_error($errorstring,E_USER_ERROR)被调用。

  1. Connect() 或 PConnect() 执行失败时。

  2. 执行 SQL 指令的函数失败时，如 Execute() 或 SelectLimin() 。

  3. GenID() 进入了无限回圈时。

这里的 $errorstring 变量是由 ADODB 所产生的。而且会包含了有用的除错信息，类似于随后会建立的 error.log 数据。所以，为了要能正确提供除错信息，你要在建立 ADOConnection 物件前，就把 ADOdb-errorhandler.inc.php 引入到程序码中。

If you define error_reporting(0), no errors will be shown. If you set error_reporting(E_ALL), all errors will be displayed on the screen.

如果你设定了 error_reporting(0) 的话，将不会有任何错误被显示。如果你设定了 error_reporting(E_ALL)，那将会显示所有的错误信息。

以下是一个简单的范例： 

<?php
error_reporting(E_ALL); # 显示所有的错误信息
include('ADOdb-errorhandler.inc.php');
include('ADOdb.inc.php');
include('tohtml.inc.php');
$c = NewADOConnection('mysql');
$c->PConnect('localhost','root','','northwind');
$rs=$c->Execute('select * from productsz'); #不正确的数据表 productsz');
if ($rs) $rs2html($rs);
?>

如果你要把错误信息记录下来，你可以定义两个选择性常数 ADODB_ERROR_LOG_TYPE, ADODB_ERROR_LOG_DEST。有关于 ADODB_ERROR_LOG_TYPE 的值，你可以去参考 PHP 使用手册中有关于 error_log 的说明。在以下的范例中，我使将它设为 3，意思是指将信息记录到常数 ADODB_ERROR_LOG_DEST 所设定的文件中。

<?php
error_reporting(0); # 不显示任何的错误信息
define('ADODB_ERROR_LOG_TYPE',3);
define('ADODB_ERROR_LOG_DEST','C:/errors.log');
include('ADOdb-errorhandler.inc.php');
include('ADOdb.inc.php');
include('tohtml.inc.php');

$c = NewADOConnection('mysql');
$c->PConnect('localhost','root','','northwind');
$rs=$c->Execute('select * from productsz'); ## 不正确的数据表 productsz
if ($rs) $rs2html($rs);
?>

以下则是写在 error.log 档的错误信息：

(2001-10-28 14:20:38) mysql error: [1146: Table 'northwind.productsz' doesn't exist] in
 EXECUTE("select * from productsz")

第二种错误处理方法是 ADOdb-errorpear.inc.php 。使用这种方式，在错误发生时会产生 PEAR_Error 衍生物件，而最后产生的 PEAR_Error 物件可以被 ADODB_Pear_Errir() 函数取回。

<?php
include('ADOdb-errorpear.inc.php');
include('ADOdb.inc.php');
include('tohtml.inc.php');
$c = NewADOConnection('mysql');
$c->PConnect('localhost','root','','northwind');
$rs=$c->Execute('select * from productsz'); #不正确的数据表 productsz');
if ($rs) $rs2html($rs);
else {
        $e = ADODB_Pear_Error();
        echo '<p>',$e->message(),'</p>';
}
?>

在引入 ADOdb-errorpear.inc.php 档之前，藉由定义 ADODB_PEAR_ERROR_CLASS 常数，你可以使用一个 PEAR_Error 衍生类别。为了方便除错，你可以在 PHP 程序码的最前面定义预设的错误理方式为 PEAR_ERROR_DIE，这将会使得程序一出错，马上就输出错误信息，并且停止执行。

include('PEAR.php');
PEAR::setErrorHandling('PEAR_ERROR_DIE');

注意，当错误产生时，ADODB并没有明确的返回一个 PEAR_Error 物件给你。你必需要去调用 ADODB_Pear_Error() 函数去取回最后的错误内容。或者，你可以使用 PEAR_ERROR_DIE 这个技巧。

数据集快取

现在，ADODB使用 CacheExecute(),CachePageExecute()及CacheSelectLimit()函数来支持数据集快取。用法类似于没有快取的函数，除了要加上一个新的参数 $secs2cache。

以下是一个范例 : 

include('ADOdb.inc.php'); # 载入ADODB
$ADODB_CACHE_DIR = '/usr/ADODB_cache';
$conn = &ADONewConnection('mysql');  # 建立一个连接
$conn->PConnect('localhost','userid','','agora');# 连接到 MySQL, agora 数据库
$sql = 'select CustomerName, CustomerID from customers';
$rs = $conn->CacheExecute(15,$sql);

第一个参数是设定查询的快取秒数。随后调用的查询将会使用存放在由 $ADODB_CACHE_DIR 变量指定的快取数据。要强迫查讯执行，并且更新快取记录，使用 CacheExecute() 函数，并且将第一个参数设为 0 。或者，使用 CacheFlush($sql) 也行。

基于安全的考量，如果你要使用 $ADODB_CACHE_DIR，我们建议你将在 php.ini 里的 register_globals 设成 off。

在 ADODB 1.80版以后，在 CacheSelectLimit() 及 CacheExecute() 中，参数 secs2cache 是选择性的。如果你不填上去，系统将会使用 $connection->cacheSecs 属性的值，它的预设值是 60 分钟。 

       $conn->Connect(...);
        $conn->cacheSecs = 3600*24; // 快取24小时
        $rs = $conn->CacheExecute('select * from table');

参考手册

以[]包起来的参数为选用参数，可有可无。

共用变量

$ADODB_COUNTRECS

当本变量($ADODB_COUNTRECS)被设为 true 时，如果数据库驱动程序介面(API)不支持返回被 SELECT 指令所选取的数据笔数，那么 RecordCount() 函数将会自动模拟，并返回正确的数据笔数，预设值即为 true。模拟方式是建立一个内存暂存区来放置这些数据，因此当取回的数据笔数很大时，会占用很大量的内存。当设定本变量值为 false 时，会有最好的效能。本变量在每次执行查讯时都会自动检查，所以你可以依实际需要在每次查询前进行设定。

$ADODB_CACHE_DIR

如果你使用了数据集快取功能，那么那些快取数据都会被置放到这个变量所指定的目录里。所以当你要使用诸如 CacheExecute() 函数前，你应该要先设定好本变量。期于安全的考量，如果你要使用 $ADODB_CACHE_DIR，我们建议你将在 php.ini 里的 register_globals 设成 off。

$ADODB_FETCH_MODE

这个共用变量决定了数据集以那种方式将数据传给阵列。数据集在被建立时(如 Execute()或SelectLimit())会把本变量($ADODB_FETCH_MODE)的值保存下来，而随后本变量($ADODB_FETCH_MODE)的任何改变都不会影响到现存的数据集，只有在以后数据集被建立起来时才会改变。

以下为为已定义的常数：

define('ADODB_FETCH_DEFAULT',0);
define('ADODB_FETCH_NUM',1);
define('ADODB_FETCH_ASSOC',2);
define('ADODB_FETCH_BOTH',3);

以下为一个使用的例子： 

       $ADODB_FETCH_MODE = ADODB_FETCH_NUM;
        $rs1 = $db->Execute('select * from table');
        $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC;
        $rs2 = $db->Execute('select * from table');
        print_r($rs1->fields); # 显示 array([0]=>'v0',[1] =>'v1')
        print_r($rs2->fields); # 显示 array(['col1']=>'v0',['col2'] =>'v1')

在本范例中，如你所见两个数据集在被Execute()建立时，会依据 $ADODB_FERCH_MODE 的值来决定保存及使用的存取模式。

如果没有任何的模式被设定，预设值则是 ADODB_FETCH_DEFAULT。呈现的模式则依据数据库驱动程序而有所不同。为了可携性，我们建议你固定为 ADODB_FETCH_NUM 及 ADODB_FETCH_ASSOC，因为有许多驱动程序并不支持 ADODB_FETCH_BOTH 。

ADOConnection 

提供连接数据库，执行SQL指令以及一组准格式化的SQL相关函数等功能的物件。

ADOConnection 属性

databaseType: 要连接的数据库系统名称，如 odbc,mssql,mysql┅等。详细内容请参考上表。

dataProvider: 下层的数据库结结机制，除了使用 odbc 或 ado 外，一般正常会设为 native。

host: 数据库主机名称，可用IP或来源名称(DSN)进行连接。如203.74.225.22 , dbs1.nukepro.com , "localhost" , "odbc_dsn1"

database: 数据库或连接名称，如果使用了 ado，则会控制 ado 数据提供驱动程序(ado data provider)。

user: 登入时的 ID，密码则基于安全考量没有保留。

raiseErrorFn: 允许你定义一个错误处理函数，请参考 ADOdb-errorhandler.inc.php 的范例.

debug: 被设定为 true 时，会显示除错信息。

concat_operator: 连接运算元，一般会设为 '+' 或 '||'。这个运算元是为了在 SQL 里连接字串的。会在 Concat 函数中被用到。

fmtDate: 日期格式，在DBDate函数中会使用到，做为送日期数据到数据库的依据。在Access格式为'#Y-m-d#'，在MySQL格式为"\Y-m-d\"。

fmtTimeStamp: 时间格式，在 DBTimeStamp 函数中要送时间数据到数据库时会使用到。

true: 数据中真值的表现方式，如在Foxpro用'T'，MS SQL用'1'。

false: 数据中假值的表现方式，如在Foxpro用'F'，MS SQL用'0'。

replaceQuote: 这个字串用来处理逸出符号。例如在 Microsoft SQL 里的双引号，MySQL里的反斜线符号。主要使用于 qstr 。

autoCommit: 设定是否启动自动交易模式，预设值为 true。

charSet: 设定使用的字元集，目前只有 interbase 支持。

metaTablesSQL: 使用SQL指令，以返回一份可用的数据表清单。例如在 MySQL 里的 SHOW TABLES。

genID: 如果数据库有支持的话，这里会存放由GetID()所取得的最后值。

cacheSecs: 快取数据集的秒数。用于当使用者利用 CacheExecute() 或 CacheSeletLimit() 函数，又没有设定 $secs2cache 参数时的预设值。

sysDate: 利用数据库函数去取得目前的日期和时间。会使用到原生的日期时间标记格式。

ADOConnection 主要函数

ADOConnection( )

建构函数，请不要直接调用，使用 ADONewConnection() 来代替。

Connect($host,[$user],[$password],[$database])

对服务器或数据来源 $host 非持续性连接，使用者认证代码为 $user ，密码为 $password ,如果服务器支持多数据库，则指定连接到数据库$database。

连接成功返回 true ， 失败则返回 false 。

注意：如果你使用的是 Microsoft ADO，而非 OLEDB，你可以设定 $database 参数为你正在使用的 OLEDB 数据供应器。

PostgreSQL：另一种选择性的连接方法是将标准的PostgreSQL连接字串放在 $host 参数里，那么其它的参数都会被呼略。

对于 Oracle 及 Oci8，有两个方法可以连接。第一，使用你定义的区域 tnsnames.ora 里的 TNS 名称，将这个名称放在 $database 参数里，然后将 $host 设为 false。另一种方法，设定 $host 为服务器，而 $database 则设成数据库SID ，这将会不透过 tnsnames.ora 连接。

范例： 

 $conn->Connect(false, 'scott', 'tiger', 'name_in_tnsnames'); # 使用 tnsnames.ora
 $conn->Connect('server:1521', 'scott', 'tiger', 'OracleSID'); # 不使用 tnsnames.ora

还有许多的数据库连接范例在网站 php.weblogs.com/ADOdb 以及在本版所附的 testdatabase.inc.php 文件里。

PConnect($host,[$user],[$password],[$database])

对服务器或数据来源 $host 持续性连接，使用者认证代码为 $user ，密码为 $password ,如果服务器支持多数据库，则指定连接到数据库$database。

连接成功返回 true ， 失败则返回 false 。其它数据请参考 Connect()。

Execute($sql,$inputarr=false)

执行 SQL 指令 $sql ，如果成功，就返回一个对应的 ADORecordSet 物件。要注意的是这个指令如果执行成功时，一定会返回一个数据集，即使是执行 insert 或 update 指令也一样。

返回对应的 ADORecordSet 物件。例如，如果连接的是 mysql ，那么 ADORecordSet_mysql 将会被返回。当SQL指令

分享到：
| PHP中的代码安全和SQL Injection防范
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

Magicbox
Global site tag (gtag.js) - Google Analytics