php中使用adodb类来处理所有类型数据库的代码
时间：2006-10-23 来源：w3g8
PHP中 ADOdb 类库介绍(一)
前言
为什么要使用数据库类库?
初学者 (甚至一些非初学者)常常犯的错误，就是在开发应用程序的时候，缺乏对未来的考虑。假如有一天，你的程序需要使用其它的数据库，难道你还需要重新写一篇针对于这个版本数据库的程序吗？这不是不可能发生的，尤其是当目前的数据库可能不适合你当前的需要的时候。 但是当你做这一切的时候 ,你会发现绝非你想像的那样容易：每一个 DBMS 有不同的函数。举例来说：在 Mysql 中连接数据库的函数为 mysql_connect(),而在MSSQL却是 mssql_connect()。重新查看你所有的代码，然后修改所有操作数据库的函数和查询语法，这绝不是一项简单的工作。程序会经常的被捆绑到了错误的数据库上，以至无法在运行时达到最优性能。数据库类库就是这样产生的。它允许你通过同样的代码来操作不同的数据库。一个设计良好的数据库类库可以完美的改变这一切。它允许你通过极小的修改，就能转接到其他数据库：无论你要连接什么数据库管理系统，只要使用同一个的函数，和不同的参数。举例来说, 在 ADOdb 中,只需简单地将 $db = NewADOConnection('access ') 修改为$db = NewADOConnection('mysql'),这样，你就轻松的把你的程序从 Access 数据库转移到了 Mysql 数据库中。现在网络上已经有了很多这样的数据库类库，比如Pear，PHPlib，我也已经在工作中使用它们了，也许你也曾经用过。但本文仅将重点放在我所特别关注的 ADOdb。本文我只简要地作一个介绍，使你能够马上运用它来开发你的下一个项目。以后的文章中我们将会循序渐进的对它进入更深入的了解。
目前，ADOdb 支持的数据库包括 MySQL, PostgreSQL，Interbase，Firebird，Informix，Oracle，MS SQL 7，Foxpro，Access，ADO，Sybase，FrontBase，DB2 和 generic ODBC。
ADOdb 的安装
安装 ADOdb 是一件极期容易的事，相信聪明的你一定不会感到吃力。
首先, 确定你正在运行的 PHP 是 4.0.4 版或更新版。 如果不是，我强列建议你升级!
从 PHP Everywhere 站点下载 .zip 或 .tgz 文件，解压缩到你所选的路径下。
这个路径不应在网页目录（WWWTREE,译者注：如果你的网页是在/www/下，那么，这个目录就不应为/www/here）下！虽然ADOdb的包含文件已经使用了 .inc.php 的扩展名 ，使得服务器即使是在最糟糕的配置下，也不会将这些.inc文件通过明文方式在浏览器中显示出来，但是我们向来不提倡将库函数文件放在网页目录下的行为。然后把下载下来的文件运行：tar -zxvf adodb350.tgz 解压，在Windows下你可以使用一个你喜欢的解压软件来操作，这样，你会得到一个 adodb 的目录其下包括了许多子目录。
测试你的安装
好了，让我们来测试一下你的安装吧。 通过在脚本中添加下列三行代码来测试你的安装是否成功。注意要把代码中的参数修改成你自己的。
include("$adodb_path/adodb.inc.php"); // includes the adodb library
$db = NewADOConnection('$database_type'); // A new connection
$db->Connect("$host", "$user", "$password", "$database_name");
现在你已经拥有一个数据库连接对象 $db 了。 你也可以使用 ADONewConnection 来替换 NewADOConnection —— 这两个是同一函数的不同的名字。 连接的数据库变量 $database_type 需要针对你的实际情况改成你所需要的。可以使用以下列表中的一个(括号内的为描述部分，不要在代码中使用)：
如果你的链接代码出现了错误的提示，那么你首先要检查的地方就是在路径或连接的变量上。在你责备 ADOdb 之前，请确定你是已经正确的使用那些变量。(很多朋友常花太多时间去修正这些显而易见的错误。) 如果连接没有任何错误提示，那么我们现在已经可以在我们的项目中来使用 ADodb 了。
通过你的脚本连接到数据库
把上边的代码加入到你的代码前，让我们先退一步。我们最好能把上边的代码用我们自己的方法来封装起来。这样可以使你的程序变得更灵活、更具移植性。如果你直接把上面的代码插入到你的项目的每个文件中，如果将来项目的路径改变了，将会很容易产生错误，如果你的密码改变了，你可能需要对你所有的脚本进行修改，这样将会影响我们使用库函数的初衷。并且，因为你的密码信息是在WEBTREE下的，这将产生隐患。我推荐将密码信息放在一个独立的包含文件中，比如在 ADOdb 安装目录下的某个地方。如果你要在其他服务器上运行你的程序时，你就不能保证目录结构会是相同的，所以，你要确保这个路径是正确的。我建议使用PHP 的自动包含功能来自动地包含这个文件。
include("$adodb_path/db_values.inc.php");
include("$adodb_path/adodb.inc.php");
$db = NewADOConnection('$database_type');
$db->Connect("$host", "$user", "$password", "employees");
如果你也想要使用持久连接, 不是每次创造一个新的连接(这使许多WEB应用程序得到了加速，但是要注意有些数据库是不支持的)。可以使用 PConnect 替换掉 Connect。
文件 db_values.inc.php 是我们的数据库信息文件，内容为(你需要把下面代码中的变量改成你自己的):
你可以在 php.ini 配置中设定自动包含我们的配置文件，具体操作可以修改 PHP.ini 的下述行：
; Automatically add files before or after any PHP document.
auto_prepend_file = /usr/local/build/apache/www/tool_lib/defaults.inc
auto_append_file =
文件 defaults.inc 包含了 $adbdb_path 的值：
还有其他方式来实现它，但是我发现这种方法在移植时，可以相对地减少复杂度。
从一个数据库中进行选择(SELECT)操作
当同时使用开发良好的库函数，和PHP自身提供的函数时，可以有多种方法来访问数据库。用什么方法，完全取决于你自己的喜好。
这里是一个简单的例子:
$sql = "SELECT surname, age FROM employees";
$rs = &$db->Execute($sql);
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
else {
while (!$rs->EOF) {
print $rs->fields[0].' '.$rs->fields[1].'
';
// fields[0] is surname, fields[1] is age
$rs->MoveNext(); // Moves to the next row
}
}
在上例中,$rs->fields 是一个包含返回值的数组。数组索引被赋予了初始的数字，你也可以按下面的方法来指定其索引:
$sql = "SELECT surname, age FROM employees";
$db->SetFetchMode(ADODB_FETCH_ASSOC); // Return associative array
$rs = &$db->Execute($sql);
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
else {
while (!$rs->EOF) {
print $rs->fields['surname']." ".$rs->fields['age']."
";
$rs->MoveNext(); // Moves to the next row
} // end while
} // end else
对结果浏览的另一个可选的方法是将每条记录作为一个对象返回。 ADOdb 有一个 FetchNextObject() 的函数来实现这一功能,指针会自动地移到下一条记录。
$sql = "SELECT surname, age FROM employees";
$db->SetFetchMode(ADODB_FETCH_ASSOC); // Return associative array
$rs = &$db->Execute($sql);
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
// loop through results
while ($row = $rs->FetchNextObject()) {
// The field names need to be uppercase
print $row->SURNAME." ".$row->AGE."
";
}
插入、更新记录
基本的 INSERT 操作方便、快捷, 拥有与SELECT一样的语法。
$sql = "INSERT INTO employees (surname, age) values ('Clegg','43')";
if (!($db->Execute($sql))) {
print 'Error inserting: '.$db->ErrorMsg().'
';
}
库函数真正的优点，在于它允许你通过相同的语法将记录放入不同的数据库之内，这在以前是绝对不可能的。通常有两种发生的情形。
第一种,引号。所有的引号需要用脱字符(即`符号,键位在Tab键的上边)代替，否则会引起语法错误。但是一些数据库使用一个单引号,另外一些则使用两个单引号。所以，你应当使用 ADOdb 中的 qstr() 而不是 PHP 中的 addslashes()。这样，返回值就将与你所使用的数据库相吻合了。
第二种,日期。许多数据库接受跟他们的日期类型不一致的、不兼容的格式。 ADOdb 有一个 DBDate() 函数,可以将 Unix 的 timestamp, 或 ISO(Y-m-d) 格式转换成任意格式，以此来满足你的数据库的需求。 见下例：
$employee_surname = $db->qstr("d'Angelo");
$arrival_time = $db->DBDate(time());
// The above two functions also add the enclosing quotes, so, $arrival_time, not '$arrival_time'
$sql = "INSERT INTO employee_arrival (arrival_time,surname) values ($arrival_time,$employee_surname)";
if (!($db->Execute($sql))) {
print 'Error inserting: '.$db->ErrorMsg().'
';
}
你可以以完全相同的方式更新数据库,举例来说：
$sql = "UPDATE employees SET age='44' WHERE id='121')";
if (!($db->Execute($sql))) {
print 'Error updating: '.$db->ErrorMsg().'
';
}
以上仅仅是 Adodb 的一些基本操作 —— 下次我们将会关注一些 ADOdb 提供的比较深层次的东西。 如果我已经使你胃口大开，而且你已经不能再等待， 我建议你去PHP Everywhere看一下,这个站点是ADOdb的专业站点，里面有很多有用的帮助信息。
PHP中 ADOdb 类库介绍(二)
对查询进行缓存
上个月，我们简单地了解了ADOdb中,如何进行SELECT、INSERT和UPDATE的操作。如果你在ADOdb上是个新手，我建议先读一下
上个月的那篇文章
。 ADOdb 还有很多更高级的特征，这个月，我们就一起来关注其中的部分内容。
数据库时常会成为应用程序效率低下的祸首。尽量减少对数据库的查询，是提高执行效率的方法之一。这，通常可以通过对整页内容进行缓存（有很多种方法来实现。比如，PEAR->Cache）,或者，如果你需要做一张动态页面，并且只想让查询指令被缓存，那么，你可以使用ADOdb,简单地将查询指令缓存起来。在你视图通过缓存来提高你的应用程序的糟糕性能之前，我建议你先试图去优化你的查询指令。有时候，一些简单的索引可以改变一切——有太多的所谓的专业的解决方案，都在使用糟糕的索引。在本文中，你能找到很多这样的实例。现在，让我们来看看ADOdb是如何使你能够对数据库的查询结果进行缓存的。在这个实例中,ADOdb把我们的最后的一次查询的结果保存在/var/tmp/adodb_cache这个缓存文件中，并保留10分钟。
include("$adodb_path/db_values.inc.php");
include("$adodb_path/adodb.inc.php");
$db = NewADOConnection('$database_type');
$db->Connect("$host", "$user", "$password", "employees");
$ADODB_CACHE_DIR = "/var/tmp/adodb_cache"; //Directory to store cached files
$sql = "SELECT surname, age FROM employees";
$rs = &$db->CacheExecute(600,$sql); // Executes, and caches the results for 600 seconds
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
else {
while (!$rs->EOF) {
print $rs->fields[0].' '.$rs->fields[1].'
';
// fields[0] is surname, fields[1] is age
$rs->MoveNext(); // Moves to the next row
} // end while
} // end else
CacheExecute() 函数有两个参数: 第一个参数是缓存文件将被保留的时间,以秒计时；第二个参数是 SQL 声明。 第一个参数是可选择的 (一些开发者或许会认为它应当成为第二个参数) ，如果你没有限定时间，那么，默认值是 3600 秒,也就是1个小时。缓存文件被命名为 adodb_*.cache，你可以在文件系统中安全地将他们删除。你应该定期清楚过期的缓存文件（用UNIX的“crontab万年历”，或者WINDOWS的“计划任务”。译者注：万年历不知有没有译错，我没有UNIX。）。要注意的是，要使用缓存方法，你需要将PHP的参数magic_quotes_runtime设为off(译者注：在php.ini中，将值设为0)。你可以根据需要，在运行时修改它的值：
set_magic_quotes_runtime(0)；
只需将上述代码放到你调用数据库的指令之前就可以了。你可以在任何时候，通过调用CacheFlush()；来清除缓存。处于对安全的考虑，ADOdb 也建议将PHP的参数register_globals 设为0(在PHP最新版中，这是默认值) 。
更多关于查询结果的信息
开发者通常会对他们的要得到的结果产生一些质疑,最通常的问题是：有多少个记录？ADOdb能够很容易地通过RecordCount()来回答这个问题。 RowCount()是同义函数。
$sql = "SELECT surname, age FROM employees";
$rs = &$db->CacheExecute(600,$sql); // Executes, and caches the results for 600 seconds
print $rs->RecordCount() . " rows returned]"; // Display number of rows returned
或许第二个问题会产生在需量列表上：被返回字段数量是多少？不用担心，ADOdb有FieldCount()。
$sql = "SELECT surname, age FROM employees";
$rs = &$db->CacheExecute(600,$sql); // Executes, and caches the results for 600 seconds
print $rs->FieldCount() . " columns returned]"; // Display number of rows returned
限制结果
上次我们讨论了如何通过使用一个数据库库函数使你的应用程序更简洁，更易于移植。在从MySQL转移到 Informix中 , 我经历了一次痛苦的移植过程。一切都归咎于非ANSII标准的LIMIT子句( 举例来说， 在MySQL中允许下列指令：SELECT name FROM employee LIMIT 15),它是一个非常有用的功能，可在Informix中却不被支持。（在Informix中，相同功能的书写应该是：SELECT FIRST 15 name FROM employee in Informix。）它似乎对你敲响了警钟，要你停止在你的查询中使用非标准SQL的指令，而去认真地学习标准的SQL。幸运的是，ADOdb有一个处理LIMIT的方法：SelectLimit()。
$sql = "SELECT surname, age FROM employees";
$rs = &$db->SelectLimit($sql, 10, 100); // Select 10 rows, starting at row 100
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
else {
while (!$rs->EOF) {
print $rs->fields[0].' '.$rs->fields[1].'
';
// fields[0] is surname, fields[1] is age
$rs->MoveNext(); // Moves to the next row
} // end while
} // end else
SelectLimit()将SQL声明作为第一参数,第二个是返回的列的数量，最后一个参数是偏移量(返回的第一行)。注意这跟MySQL的指令中LIMIT子句的参数顺序相反。SelectLimit()对于将搜索结果部分地显示在页面上，是十分有用的，通过Previous和Next按钮，可以浏览所有的结果。
不止一次地，我看到的代码将来自数据库的所有查询结果，都用PHP作过滤处理——杀鸡用牛刀! 你完全可以使用 CacheSelectLimit()函数来贮藏这种类型的结果。
处理事务
处理事务是许多应用程序的一个重要的特征。(对于初学者来说，处理事务是你可以提交一打查询操作的过程，而这些查询是都成功了，还是有部分失败了，都需要考虑进去。
经典范例是银行处理。钱从你的帐户转出，然后转入到其他某个人的帐户中。只要其中任意一项失败，那么，这整个过程都必须被认定为失败。不然，钱被划出，而没有进对方的帐户；或者，钱没有划出，对方帐户无端多了一笔小费。)
处理事务可以在代码级上进行机警地管理控制。 常数错误检查被用来判断是否要COMMIT（事务的所有各项都正确，执行正确，结束事务）还是ROLLBACK（事务中有错误，所有改动需要恢复原来状况）。ADOdb 有一些能使处理操作正确进行的有用的函数。下例在某个职员的结余加10，并在另一个上减10,整个过程有两个查询，作为一个完整的事务。
$sql1 = "UPDATE employees SET balance=balance-10 WHERE id=15";
$sql2 = "UPDATE employees SET balance=balance+10 WHERE id=22";
$db->StartTrans();
$db->Execute($sql);
$db->Execute($sql2);
$db->CompleteTrans();
当你浏览老的代码时，可能会看到一个比较老的方法来实现这一切。使用 BeginTrans()、CommitTrans()和RollbackTrans（）函数时，需要你自己来处理错误。StartTrans（）和 CompleteTrans（）将会自动地处理错误,并适当地进行COMMIT或ROLLBACK。当需要的时候，你可以通过FailTrans()来强制执行ROLLBACK。
当然你可能需要知道处理是失败了还是成功了。ADOdb 提供了 HasFailedTrans() 来实现这个功能。 如果出错（或者，你可以将这种情况称作FailTrans()），返回TRUE；如果成功，返回FALSE。
$sql1 = "UPDATE employees SET balance=balance-10 WHERE id=15";
$sql2 = "UPDATE employees SET balance=balance+10 WHERE id=22";
$db->StartTrans();
$db->Execute($sql);
$db->Execute($sql2);
$db->CompleteTrans();
if ($db->HasFailedTrans()) {
// Something went wrong
}
值得注意的是，你的数据库需要支持这些事务函数。 (大多数的数据库是支持的，不过，MySQL InnoDB表支持,可 MySQL MyISAM 表不支持。)
我希望我所做的一切能让你对数据库库函数能有极大的兴趣。还有大量有趣的函数可以用来从数据库表中自动生成HTML，并且同一结果有不同的方法来实现。你可以
在此
找到完整的手册。
祝你好运！
ADODB快速手册
1、简要说明
ADODB是PHP中的一个通用的数据库操作库，ADODB目前支持MySQL、PostgreSQL、Oracle、Interbase、Microsoft SQL Server、Access、FoxPro、Sybase、ODBC及ADO，你可以从
http://php.weblogs.com/adodb
下载 ADODB。
2、安装
下载 tgz或 zip解压即可。
3、使用
使用前包含进 adodb.inc.php即可
include("$adodb_path/adodb.inc.php"); // includes the adodb library
4、函数
全局函数几乎只有一个
NewADOConnection('DataBaseType');
作用：生成一个ADOdb对象。
可以的值为： (不包括括号里的内容)
access (Microsoft Access/Jet)
ado (Generic ADO, the base for all the other ADO drivers)
ado_access (Microsoft Access/Jet using ADO)
ado_mssql (Microsoft SQL Server using ADO)
db2 (DB2)
vfp (Microsoft Visual FoxPro)
fbsql (FrontBase)
ibase (Interbase 6 or before)
firebird (Firebird)
informix72 (Informix databases before Informix 7.3)
informix (Informix)
maxsql (MySQL with transaction support)
mssql (Microsoft SQL Server 7)
mssqlpo (Portable mssql driver)
mysql (MySQL without transaction support)
mysqlt (MySQL with transaction support, identical to maxmysql)
oci8 (Oracle 8/9)
oci805 (Oracle 8.0.5)
oci8po (Oracle 8/9 portable driver)
odbc (Generic ODBC, the base for all the other ODBC drivers)
odbc_mssql (MSSQL via ODBC)
odbc_oracle (Oracle via ODBC)
oracle (Oracle 7)
postgres (PostgreSQL)
postgres64 (PostgreSQL 6.4)
postgres7 (PostgreSQL 7, currently identical to postgres )
sqlanywhere (Sybase SQL Anywhere)
sybase (Sybase)
rs2html 把 RecordSet 对象转成html输出
要包含 include('tohtml.inc.php');
5、对象
PHP ADODB与MS ADO 对象结构相似，
主要用到两个对象 (ADOConnection 对象与 RecordSet 对象)
ADOConnection负责数据库的连接，发送 sql 命令等；RecordSet主要是得到查询出来的记录集
6、ADOConnection 对象说明
1、建立
ADODB是用 NewADOConnection() 函数来新建一个 ADODB连接对象，如：
$db = NewADOConnection('$database_type'); // A new connection
$database_type 是数据库格式，可能值看上面 第4小节。
2、连接数据库
用ADOConnection 的 Connect 方法，格式如下：
Connect("主机名","用户名","用户密码","数据库名");
返回值，连接成功返回一个 ADOConnection对象，错误返回 FALSE，可以用 ADOConnection的 ErrorMsg()函数得到错误说明.
$db->Connect("$host", "$user", "$password", "$database_name");
3、执行SQL指令
用Execute函数执行 SQL 命令 如：
$result = $db->Execute("SELECT * FROM employees");
if ($result === false) die("failed");
执行成功返回一个 Recordset 对象，否则返回 FALSE
4、Affected_Rows()函数
Affected_Rows()函数返回最后一个 sql 命令所影响到的记录行数。
5、日期格式
由于 ADODB需要支持不同的数据库系统，而这些不同的数据库可能用不同的方式来表示日期\时间格式。ADODB用 DBDate()函数来转换不同数据库之间的格式。
6、字符串格式
不同的数据库可以用不对的字符串表示格式，如'单括号的表示方法。例：
$ID = 3
$TheDate=mktime(0,0,0,8,31,2001) /* 31st August 2001 */
$Note= sugar why don't we call it off
$sql = "INSERT INTO table (id, thedate,note) values ("
. $ID . ','
. $db->DBDate($TheDate) .','
. $db->qstr($Note).")";
$db->Execute($sql);
7、Select指令的Limit及Top支持
$connection->SelectLimit($sql,$nrows,$offset);
注意：第二个参数是需要返回的行数，第三个参数才是从第几行开始。
返回值：成功返回一个Recordset 对象，失败返回 FALSE; 对于分页时相当有用。
8、Cache缓存
CacheExecute 与 CacheSelectLimit 函数。
第一个参数为超时时间，秒数。
ADODB允许你在你的档案系统中暂存recordset的数据，并且在$connection->CacheExecute($secs2cache,$sql)及 $connection->CacheSelectLimit($secs2cache,$sql,$nrows,$offset)等设定的时间间隔到达之后，才真正去做数据库的查询以节省时间。
可以用 $ADODB_CACHE_DIR 来指定 Cache 目录，好象要用绝对路径。但超时过后，PHP不能自动删除cache，要人工手动删除。
9、事务
StartTrans() 开始事务
CompleteTrans() 结束事务 ADODB 自动处理事务的提交与回滚
HasFailedTrans() 事务是否成功 TRUE 成功，FALSE为失败
大多数数据库直持事务，但MySQL InnoDB表支持事务，而MyISAM表不支持。
10、SetFetchMode
设置 Recordset 对象的记录集索引方式。如：
$db->SetFetchMode(ADODB_FETCH_ASSOC); // Return associative array
ADODB_FETCH_NUM; 以数字方式索引
12、GetInsertSQL , GetUpdateSQL
生成一个 Insert SQL ， 有两个参数，第一个是一个 RecordSet 第二个是一个数组。 例如：
$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();
13、PageExecute 分页查询
如：PageExecute($sql, $num_of_rows_per_page, $curr_page);
可能用到的属性 AtFirstPage() , AtLastPage()，AbsolutePage()
7、Recordset 对象
1、Move($Pos)
卷动目前的数据列，ADODB支持整个数据库往前卷动，有一些数据库并不支持往后的卷动，这倒不会是个问题，因为你能够用暂存纪录到快取来仿真往后卷动。
2、RecordCount() 或 RowCount()
传回SQL指令存取到的纪录笔数，有些数据库会因为不支持而传回-1
3、EOF
是否为记录尾
4、fields
用以获取记录集的值，用法，$rs->fields[编号或字段名]，如果$db->SetFetchMode(ADODB_FETCH_ASSOC); 则可以用字段名直接访问。
5、MoveNext()
记录指针下移一个。
6、MoveFirst
记录指针移动在开头。
7、FetchNextObject()
得到一个行对象，且指针自动下移。如：
$row = $rs->FetchNextObject();
echo($row->UserName . $row->Age );
8、Insert_ID
得到记录集最后一次插入的值。
9、MetaTypes
得到字段的类型。如：
$fld = $recordSet->FetchField(1);
$type = $recordSet->MetaType($fld->type);
if ( $type == 'D' || $type == 'T') {.....};
可能的值与意义：
C: character 栏位，应该使用 标记来取值。
X: 文字栏位(Text) , 长文字栏位，使用 标记来显示资料。
B: Blob 栏位或者大型的二位元物件(像程式,图档等)。
D: 日期栏位
T: 时间栏位
L: 逻辑栏位(真假值)或位元栏位
N: 数字栏位，包含自动进位、编号、整数、浮点数、实数等。
R: 序列栏位，包含了序列、自动增进整数，只对被选择的资料库作用。
10、FetchField
得到一个字段对象 如：
$field = $rs->FetchField();
field对象有三个属性 name 、type 、length 分别的意义为(名称、类型、长度，长度可能传回-1)
而 type 可以通过 MetaTypes 转换成字符格式，如：
$fld = $recordSet->FetchField(1);
$type = $recordSet->MetaType($fld->type);
if ( $type == 'D' || $type == 'T') {.....};
11 UserDate
http://adodb.sourceforge.net/
前言
为什么要使用数据库类库?
初学者 (甚至一些非初学者)常常犯的错误，就是在开发应用程序的时候，缺乏对未来的考虑。假如有一天，你的程序需要使用其它的数据库，难道你还需要重新写一篇针对于这个版本数据库的程序吗？这不是不可能发生的，尤其是当目前的数据库可能不适合你当前的需要的时候。 但是当你做这一切的时候 ,你会发现绝非你想像的那样容易：每一个 DBMS 有不同的函数。举例来说：在 Mysql 中连接数据库的函数为 mysql_connect(),而在MSSQL却是 mssql_connect()。重新查看你所有的代码，然后修改所有操作数据库的函数和查询语法，这绝不是一项简单的工作。程序会经常的被捆绑到了错误的数据库上，以至无法在运行时达到最优性能。数据库类库就是这样产生的。它允许你通过同样的代码来操作不同的数据库。一个设计良好的数据库类库可以完美的改变这一切。它允许你通过极小的修改，就能转接到其他数据库：无论你要连接什么数据库管理系统，只要使用同一个的函数，和不同的参数。举例来说, 在 ADOdb 中,只需简单地将 $db = NewADOConnection('access ') 修改为$db = NewADOConnection('mysql'),这样，你就轻松的把你的程序从 Access 数据库转移到了 Mysql 数据库中。现在网络上已经有了很多这样的数据库类库，比如Pear，PHPlib，我也已经在工作中使用它们了，也许你也曾经用过。但本文仅将重点放在我所特别关注的 ADOdb。本文我只简要地作一个介绍，使你能够马上运用它来开发你的下一个项目。以后的文章中我们将会循序渐进的对它进入更深入的了解。
目前，ADOdb 支持的数据库包括 MySQL, PostgreSQL，Interbase，Firebird，Informix，Oracle，MS SQL 7，Foxpro，Access，ADO，Sybase，FrontBase，DB2 和 generic ODBC。
ADOdb 的安装
安装 ADOdb 是一件极期容易的事，相信聪明的你一定不会感到吃力。
首先, 确定你正在运行的 PHP 是 4.0.4 版或更新版。 如果不是，我强列建议你升级!
从 PHP Everywhere 站点下载 .zip 或 .tgz 文件，解压缩到你所选的路径下。
这个路径不应在网页目录（WWWTREE,译者注：如果你的网页是在/www/下，那么，这个目录就不应为/www/here）下！虽然ADOdb的包含文件已经使用了 .inc.php 的扩展名 ，使得服务器即使是在最糟糕的配置下，也不会将这些.inc文件通过明文方式在浏览器中显示出来，但是我们向来不提倡将库函数文件放在网页目录下的行为。然后把下载下来的文件运行：tar -zxvf adodb350.tgz 解压，在Windows下你可以使用一个你喜欢的解压软件来操作，这样，你会得到一个 adodb 的目录其下包括了许多子目录。
测试你的安装
好了，让我们来测试一下你的安装吧。 通过在脚本中添加下列三行代码来测试你的安装是否成功。注意要把代码中的参数修改成你自己的。
include("$adodb_path/adodb.inc.php"); // includes the adodb library
$db = NewADOConnection('$database_type'); // A new connection
$db->Connect("$host", "$user", "$password", "$database_name");
现在你已经拥有一个数据库连接对象 $db 了。 你也可以使用 ADONewConnection 来替换 NewADOConnection —— 这两个是同一函数的不同的名字。 连接的数据库变量 $database_type 需要针对你的实际情况改成你所需要的。可以使用以下列表中的一个(括号内的为描述部分，不要在代码中使用)：
- access (Microsoft Access/Jet)
- ado (Generic ADO, the base for all the other ADO drivers)
- ado_access (Microsoft Access/Jet using ADO)
- ado_mssql (Microsoft SQL Server using ADO)
- db2 (DB2)
- vfp (Microsoft Visual FoxPro)
- fbsql (FrontBase)
- ibase (Interbase 6 or before)
- firebird (Firebird)
- informix72 (Informix databases before Informix 7.3)
- informix (Informix)
- maxsql (MySQL with transaction support)
- mssql (Microsoft SQL Server 7)
- mssqlpo (Portable mssql driver)
- mysql (MySQL without transaction support)
- mysqlt (MySQL with transaction support, identical to maxmysql)
- oci8 (Oracle 8/9)
- oci805 (Oracle 8.0.5)
- oci8po (Oracle 8/9 portable driver)
- odbc (Generic ODBC, the base for all the other ODBC drivers)
- odbc_mssql (MSSQL via ODBC)
- odbc_oracle (Oracle via ODBC)
- oracle (Oracle 7)
- postgres (PostgreSQL)
- postgres64 (PostgreSQL 6.4)
- postgres7 (PostgreSQL 7, currently identical to postgres )
- sqlanywhere (Sybase SQL Anywhere)
- sybase (Sybase)
如果你的链接代码出现了错误的提示，那么你首先要检查的地方就是在路径或连接的变量上。在你责备 ADOdb 之前，请确定你是已经正确的使用那些变量。(很多朋友常花太多时间去修正这些显而易见的错误。) 如果连接没有任何错误提示，那么我们现在已经可以在我们的项目中来使用 ADodb 了。
通过你的脚本连接到数据库
把上边的代码加入到你的代码前，让我们先退一步。我们最好能把上边的代码用我们自己的方法来封装起来。这样可以使你的程序变得更灵活、更具移植性。如果你直接把上面的代码插入到你的项目的每个文件中，如果将来项目的路径改变了，将会很容易产生错误，如果你的密码改变了，你可能需要对你所有的脚本进行修改，这样将会影响我们使用库函数的初衷。并且，因为你的密码信息是在WEBTREE下的，这将产生隐患。我推荐将密码信息放在一个独立的包含文件中，比如在 ADOdb 安装目录下的某个地方。如果你要在其他服务器上运行你的程序时，你就不能保证目录结构会是相同的，所以，你要确保这个路径是正确的。我建议使用PHP 的自动包含功能来自动地包含这个文件。
include("$adodb_path/db_values.inc.php");
include("$adodb_path/adodb.inc.php");
$db = NewADOConnection('$database_type');
$db->Connect("$host", "$user", "$password", "employees");
如果你也想要使用持久连接, 不是每次创造一个新的连接(这使许多WEB应用程序得到了加速，但是要注意有些数据库是不支持的)。可以使用 PConnect 替换掉 Connect。
文件 db_values.inc.php 是我们的数据库信息文件，内容为(你需要把下面代码中的变量改成你自己的):
你可以在 php.ini 配置中设定自动包含我们的配置文件，具体操作可以修改 PHP.ini 的下述行：
; Automatically add files before or after any PHP document.
auto_prepend_file = /usr/local/build/apache/www/tool_lib/defaults.inc
auto_append_file =
文件 defaults.inc 包含了 $adbdb_path 的值：
还有其他方式来实现它，但是我发现这种方法在移植时，可以相对地减少复杂度。
从一个数据库中进行选择(SELECT)操作
当同时使用开发良好的库函数，和PHP自身提供的函数时，可以有多种方法来访问数据库。用什么方法，完全取决于你自己的喜好。
这里是一个简单的例子:
$sql = "SELECT surname, age FROM employees";
$rs = &$db->Execute($sql);
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
else {
while (!$rs->EOF) {
print $rs->fields[0].' '.$rs->fields[1].'
';
// fields[0] is surname, fields[1] is age
$rs->MoveNext(); // Moves to the next row
}
}
在上例中,$rs->fields 是一个包含返回值的数组。数组索引被赋予了初始的数字，你也可以按下面的方法来指定其索引:
$sql = "SELECT surname, age FROM employees";
$db->SetFetchMode(ADODB_FETCH_ASSOC); // Return associative array
$rs = &$db->Execute($sql);
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
else {
while (!$rs->EOF) {
print $rs->fields['surname']." ".$rs->fields['age']."
";
$rs->MoveNext(); // Moves to the next row
} // end while
} // end else
对结果浏览的另一个可选的方法是将每条记录作为一个对象返回。 ADOdb 有一个 FetchNextObject() 的函数来实现这一功能,指针会自动地移到下一条记录。
$sql = "SELECT surname, age FROM employees";
$db->SetFetchMode(ADODB_FETCH_ASSOC); // Return associative array
$rs = &$db->Execute($sql);
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
// loop through results
while ($row = $rs->FetchNextObject()) {
// The field names need to be uppercase
print $row->SURNAME." ".$row->AGE."
";
}
插入、更新记录
基本的 INSERT 操作方便、快捷, 拥有与SELECT一样的语法。
$sql = "INSERT INTO employees (surname, age) values ('Clegg','43')";
if (!($db->Execute($sql))) {
print 'Error inserting: '.$db->ErrorMsg().'
';
}
库函数真正的优点，在于它允许你通过相同的语法将记录放入不同的数据库之内，这在以前是绝对不可能的。通常有两种发生的情形。
第一种,引号。所有的引号需要用脱字符(即`符号,键位在Tab键的上边)代替，否则会引起语法错误。但是一些数据库使用一个单引号,另外一些则使用两个单引号。所以，你应当使用 ADOdb 中的 qstr() 而不是 PHP 中的 addslashes()。这样，返回值就将与你所使用的数据库相吻合了。
第二种,日期。许多数据库接受跟他们的日期类型不一致的、不兼容的格式。 ADOdb 有一个 DBDate() 函数,可以将 Unix 的 timestamp, 或 ISO(Y-m-d) 格式转换成任意格式，以此来满足你的数据库的需求。 见下例：
$employee_surname = $db->qstr("d'Angelo");
$arrival_time = $db->DBDate(time());
// The above two functions also add the enclosing quotes, so, $arrival_time, not '$arrival_time'
$sql = "INSERT INTO employee_arrival (arrival_time,surname) values ($arrival_time,$employee_surname)";
if (!($db->Execute($sql))) {
print 'Error inserting: '.$db->ErrorMsg().'
';
}
你可以以完全相同的方式更新数据库,举例来说：
$sql = "UPDATE employees SET age='44' WHERE id='121')";
if (!($db->Execute($sql))) {
print 'Error updating: '.$db->ErrorMsg().'
';
}
以上仅仅是 Adodb 的一些基本操作 —— 下次我们将会关注一些 ADOdb 提供的比较深层次的东西。 如果我已经使你胃口大开，而且你已经不能再等待， 我建议你去PHP Everywhere看一下,这个站点是ADOdb的专业站点，里面有很多有用的帮助信息。
PHP中 ADOdb 类库介绍(二)
对查询进行缓存
上个月，我们简单地了解了ADOdb中,如何进行SELECT、INSERT和UPDATE的操作。如果你在ADOdb上是个新手，我建议先读一下
上个月的那篇文章
。 ADOdb 还有很多更高级的特征，这个月，我们就一起来关注其中的部分内容。
数据库时常会成为应用程序效率低下的祸首。尽量减少对数据库的查询，是提高执行效率的方法之一。这，通常可以通过对整页内容进行缓存（有很多种方法来实现。比如，PEAR->Cache）,或者，如果你需要做一张动态页面，并且只想让查询指令被缓存，那么，你可以使用ADOdb,简单地将查询指令缓存起来。在你视图通过缓存来提高你的应用程序的糟糕性能之前，我建议你先试图去优化你的查询指令。有时候，一些简单的索引可以改变一切——有太多的所谓的专业的解决方案，都在使用糟糕的索引。在本文中，你能找到很多这样的实例。现在，让我们来看看ADOdb是如何使你能够对数据库的查询结果进行缓存的。在这个实例中,ADOdb把我们的最后的一次查询的结果保存在/var/tmp/adodb_cache这个缓存文件中，并保留10分钟。
include("$adodb_path/db_values.inc.php");
include("$adodb_path/adodb.inc.php");
$db = NewADOConnection('$database_type');
$db->Connect("$host", "$user", "$password", "employees");
$ADODB_CACHE_DIR = "/var/tmp/adodb_cache"; //Directory to store cached files
$sql = "SELECT surname, age FROM employees";
$rs = &$db->CacheExecute(600,$sql); // Executes, and caches the results for 600 seconds
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
else {
while (!$rs->EOF) {
print $rs->fields[0].' '.$rs->fields[1].'
';
// fields[0] is surname, fields[1] is age
$rs->MoveNext(); // Moves to the next row
} // end while
} // end else
CacheExecute() 函数有两个参数: 第一个参数是缓存文件将被保留的时间,以秒计时；第二个参数是 SQL 声明。 第一个参数是可选择的 (一些开发者或许会认为它应当成为第二个参数) ，如果你没有限定时间，那么，默认值是 3600 秒,也就是1个小时。缓存文件被命名为 adodb_*.cache，你可以在文件系统中安全地将他们删除。你应该定期清楚过期的缓存文件（用UNIX的“crontab万年历”，或者WINDOWS的“计划任务”。译者注：万年历不知有没有译错，我没有UNIX。）。要注意的是，要使用缓存方法，你需要将PHP的参数magic_quotes_runtime设为off(译者注：在php.ini中，将值设为0)。你可以根据需要，在运行时修改它的值：
set_magic_quotes_runtime(0)；
只需将上述代码放到你调用数据库的指令之前就可以了。你可以在任何时候，通过调用CacheFlush()；来清除缓存。处于对安全的考虑，ADOdb 也建议将PHP的参数register_globals 设为0(在PHP最新版中，这是默认值) 。
更多关于查询结果的信息
开发者通常会对他们的要得到的结果产生一些质疑,最通常的问题是：有多少个记录？ADOdb能够很容易地通过RecordCount()来回答这个问题。 RowCount()是同义函数。
$sql = "SELECT surname, age FROM employees";
$rs = &$db->CacheExecute(600,$sql); // Executes, and caches the results for 600 seconds
print $rs->RecordCount() . " rows returned]"; // Display number of rows returned
或许第二个问题会产生在需量列表上：被返回字段数量是多少？不用担心，ADOdb有FieldCount()。
$sql = "SELECT surname, age FROM employees";
$rs = &$db->CacheExecute(600,$sql); // Executes, and caches the results for 600 seconds
print $rs->FieldCount() . " columns returned]"; // Display number of rows returned
限制结果
上次我们讨论了如何通过使用一个数据库库函数使你的应用程序更简洁，更易于移植。在从MySQL转移到 Informix中 , 我经历了一次痛苦的移植过程。一切都归咎于非ANSII标准的LIMIT子句( 举例来说， 在MySQL中允许下列指令：SELECT name FROM employee LIMIT 15),它是一个非常有用的功能，可在Informix中却不被支持。（在Informix中，相同功能的书写应该是：SELECT FIRST 15 name FROM employee in Informix。）它似乎对你敲响了警钟，要你停止在你的查询中使用非标准SQL的指令，而去认真地学习标准的SQL。幸运的是，ADOdb有一个处理LIMIT的方法：SelectLimit()。
$sql = "SELECT surname, age FROM employees";
$rs = &$db->SelectLimit($sql, 10, 100); // Select 10 rows, starting at row 100
if (!$rs) {
print $db->ErrorMsg(); // Displays the error message if no results could be returned
}
else {
while (!$rs->EOF) {
print $rs->fields[0].' '.$rs->fields[1].'
';
// fields[0] is surname, fields[1] is age
$rs->MoveNext(); // Moves to the next row
} // end while
} // end else
SelectLimit()将SQL声明作为第一参数,第二个是返回的列的数量，最后一个参数是偏移量(返回的第一行)。注意这跟MySQL的指令中LIMIT子句的参数顺序相反。SelectLimit()对于将搜索结果部分地显示在页面上，是十分有用的，通过Previous和Next按钮，可以浏览所有的结果。
不止一次地，我看到的代码将来自数据库的所有查询结果，都用PHP作过滤处理——杀鸡用牛刀! 你完全可以使用 CacheSelectLimit()函数来贮藏这种类型的结果。
处理事务
处理事务是许多应用程序的一个重要的特征。(对于初学者来说，处理事务是你可以提交一打查询操作的过程，而这些查询是都成功了，还是有部分失败了，都需要考虑进去。
经典范例是银行处理。钱从你的帐户转出，然后转入到其他某个人的帐户中。只要其中任意一项失败，那么，这整个过程都必须被认定为失败。不然，钱被划出，而没有进对方的帐户；或者，钱没有划出，对方帐户无端多了一笔小费。)
处理事务可以在代码级上进行机警地管理控制。 常数错误检查被用来判断是否要COMMIT（事务的所有各项都正确，执行正确，结束事务）还是ROLLBACK（事务中有错误，所有改动需要恢复原来状况）。ADOdb 有一些能使处理操作正确进行的有用的函数。下例在某个职员的结余加10，并在另一个上减10,整个过程有两个查询，作为一个完整的事务。
$sql1 = "UPDATE employees SET balance=balance-10 WHERE id=15";
$sql2 = "UPDATE employees SET balance=balance+10 WHERE id=22";
$db->StartTrans();
$db->Execute($sql);
$db->Execute($sql2);
$db->CompleteTrans();
当你浏览老的代码时，可能会看到一个比较老的方法来实现这一切。使用 BeginTrans()、CommitTrans()和RollbackTrans（）函数时，需要你自己来处理错误。StartTrans（）和 CompleteTrans（）将会自动地处理错误,并适当地进行COMMIT或ROLLBACK。当需要的时候，你可以通过FailTrans()来强制执行ROLLBACK。
当然你可能需要知道处理是失败了还是成功了。ADOdb 提供了 HasFailedTrans() 来实现这个功能。 如果出错（或者，你可以将这种情况称作FailTrans()），返回TRUE；如果成功，返回FALSE。
$sql1 = "UPDATE employees SET balance=balance-10 WHERE id=15";
$sql2 = "UPDATE employees SET balance=balance+10 WHERE id=22";
$db->StartTrans();
$db->Execute($sql);
$db->Execute($sql2);
$db->CompleteTrans();
if ($db->HasFailedTrans()) {
// Something went wrong
}
值得注意的是，你的数据库需要支持这些事务函数。 (大多数的数据库是支持的，不过，MySQL InnoDB表支持,可 MySQL MyISAM 表不支持。)
我希望我所做的一切能让你对数据库库函数能有极大的兴趣。还有大量有趣的函数可以用来从数据库表中自动生成HTML，并且同一结果有不同的方法来实现。你可以
在此
找到完整的手册。
祝你好运！
ADODB快速手册
1、简要说明
ADODB是PHP中的一个通用的数据库操作库，ADODB目前支持MySQL、PostgreSQL、Oracle、Interbase、Microsoft SQL Server、Access、FoxPro、Sybase、ODBC及ADO，你可以从
http://php.weblogs.com/adodb
下载 ADODB。
2、安装
下载 tgz或 zip解压即可。
3、使用
使用前包含进 adodb.inc.php即可
include("$adodb_path/adodb.inc.php"); // includes the adodb library
4、函数
全局函数几乎只有一个
NewADOConnection('DataBaseType');
作用：生成一个ADOdb对象。
可以的值为： (不包括括号里的内容)
access (Microsoft Access/Jet)
ado (Generic ADO, the base for all the other ADO drivers)
ado_access (Microsoft Access/Jet using ADO)
ado_mssql (Microsoft SQL Server using ADO)
db2 (DB2)
vfp (Microsoft Visual FoxPro)
fbsql (FrontBase)
ibase (Interbase 6 or before)
firebird (Firebird)
informix72 (Informix databases before Informix 7.3)
informix (Informix)
maxsql (MySQL with transaction support)
mssql (Microsoft SQL Server 7)
mssqlpo (Portable mssql driver)
mysql (MySQL without transaction support)
mysqlt (MySQL with transaction support, identical to maxmysql)
oci8 (Oracle 8/9)
oci805 (Oracle 8.0.5)
oci8po (Oracle 8/9 portable driver)
odbc (Generic ODBC, the base for all the other ODBC drivers)
odbc_mssql (MSSQL via ODBC)
odbc_oracle (Oracle via ODBC)
oracle (Oracle 7)
postgres (PostgreSQL)
postgres64 (PostgreSQL 6.4)
postgres7 (PostgreSQL 7, currently identical to postgres )
sqlanywhere (Sybase SQL Anywhere)
sybase (Sybase)
rs2html 把 RecordSet 对象转成html输出
要包含 include('tohtml.inc.php');
5、对象
PHP ADODB与MS ADO 对象结构相似，
主要用到两个对象 (ADOConnection 对象与 RecordSet 对象)
ADOConnection负责数据库的连接，发送 sql 命令等；RecordSet主要是得到查询出来的记录集
6、ADOConnection 对象说明
1、建立
ADODB是用 NewADOConnection() 函数来新建一个 ADODB连接对象，如：
$db = NewADOConnection('$database_type'); // A new connection
$database_type 是数据库格式，可能值看上面 第4小节。
2、连接数据库
用ADOConnection 的 Connect 方法，格式如下：
Connect("主机名","用户名","用户密码","数据库名");
返回值，连接成功返回一个 ADOConnection对象，错误返回 FALSE，可以用 ADOConnection的 ErrorMsg()函数得到错误说明.
$db->Connect("$host", "$user", "$password", "$database_name");
3、执行SQL指令
用Execute函数执行 SQL 命令 如：
$result = $db->Execute("SELECT * FROM employees");
if ($result === false) die("failed");
执行成功返回一个 Recordset 对象，否则返回 FALSE
4、Affected_Rows()函数
Affected_Rows()函数返回最后一个 sql 命令所影响到的记录行数。
5、日期格式
由于 ADODB需要支持不同的数据库系统，而这些不同的数据库可能用不同的方式来表示日期\时间格式。ADODB用 DBDate()函数来转换不同数据库之间的格式。
6、字符串格式
不同的数据库可以用不对的字符串表示格式，如'单括号的表示方法。例：
$ID = 3
$TheDate=mktime(0,0,0,8,31,2001) /* 31st August 2001 */
$Note= sugar why don't we call it off
$sql = "INSERT INTO table (id, thedate,note) values ("
. $ID . ','
. $db->DBDate($TheDate) .','
. $db->qstr($Note).")";
$db->Execute($sql);
7、Select指令的Limit及Top支持
$connection->SelectLimit($sql,$nrows,$offset);
注意：第二个参数是需要返回的行数，第三个参数才是从第几行开始。
返回值：成功返回一个Recordset 对象，失败返回 FALSE; 对于分页时相当有用。
8、Cache缓存
CacheExecute 与 CacheSelectLimit 函数。
第一个参数为超时时间，秒数。
ADODB允许你在你的档案系统中暂存recordset的数据，并且在$connection->CacheExecute($secs2cache,$sql)及 $connection->CacheSelectLimit($secs2cache,$sql,$nrows,$offset)等设定的时间间隔到达之后，才真正去做数据库的查询以节省时间。
可以用 $ADODB_CACHE_DIR 来指定 Cache 目录，好象要用绝对路径。但超时过后，PHP不能自动删除cache，要人工手动删除。
9、事务
StartTrans() 开始事务
CompleteTrans() 结束事务 ADODB 自动处理事务的提交与回滚
HasFailedTrans() 事务是否成功 TRUE 成功，FALSE为失败
大多数数据库直持事务，但MySQL InnoDB表支持事务，而MyISAM表不支持。
10、SetFetchMode
设置 Recordset 对象的记录集索引方式。如：
$db->SetFetchMode(ADODB_FETCH_ASSOC); // Return associative array
ADODB_FETCH_NUM; 以数字方式索引
12、GetInsertSQL , GetUpdateSQL
生成一个 Insert SQL ， 有两个参数，第一个是一个 RecordSet 第二个是一个数组。 例如：
$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();
13、PageExecute 分页查询
如：PageExecute($sql, $num_of_rows_per_page, $curr_page);
可能用到的属性 AtFirstPage() , AtLastPage()，AbsolutePage()
7、Recordset 对象
1、Move($Pos)
卷动目前的数据列，ADODB支持整个数据库往前卷动，有一些数据库并不支持往后的卷动，这倒不会是个问题，因为你能够用暂存纪录到快取来仿真往后卷动。
2、RecordCount() 或 RowCount()
传回SQL指令存取到的纪录笔数，有些数据库会因为不支持而传回-1
3、EOF
是否为记录尾
4、fields
用以获取记录集的值，用法，$rs->fields[编号或字段名]，如果$db->SetFetchMode(ADODB_FETCH_ASSOC); 则可以用字段名直接访问。
5、MoveNext()
记录指针下移一个。
6、MoveFirst
记录指针移动在开头。
7、FetchNextObject()
得到一个行对象，且指针自动下移。如：
$row = $rs->FetchNextObject();
echo($row->UserName . $row->Age );
8、Insert_ID
得到记录集最后一次插入的值。
9、MetaTypes
得到字段的类型。如：
$fld = $recordSet->FetchField(1);
$type = $recordSet->MetaType($fld->type);
if ( $type == 'D' || $type == 'T') {.....};
可能的值与意义：
C: character 栏位，应该使用 标记来取值。
X: 文字栏位(Text) , 长文字栏位，使用 标记来显示资料。
B: Blob 栏位或者大型的二位元物件(像程式,图档等)。
D: 日期栏位
T: 时间栏位
L: 逻辑栏位(真假值)或位元栏位
N: 数字栏位，包含自动进位、编号、整数、浮点数、实数等。
R: 序列栏位，包含了序列、自动增进整数，只对被选择的资料库作用。
10、FetchField
得到一个字段对象 如：
$field = $rs->FetchField();
field对象有三个属性 name 、type 、length 分别的意义为(名称、类型、长度，长度可能传回-1)
而 type 可以通过 MetaTypes 转换成字符格式，如：
$fld = $recordSet->FetchField(1);
$type = $recordSet->MetaType($fld->type);
if ( $type == 'D' || $type == 'T') {.....};
11 UserDate
http://adodb.sourceforge.net/
相关阅读 更多 +
