ADODB中文手册(简体中文)

英文原版位置：http://phplens.com/lens/adodb/tute.htm   ADODB入门手册：从MySQL向ADODB转移 You say eether and I say eyether, You say neether and I say nyther; Eether, eyether, neether, nyther - Let's call the whole thing off ! You like potato and I like po-tah-to, You like tomato and I like to-mah-to; Potato, po-tah-to, tomato, to-mah-to - Let's call the whole thing off !   我喜欢听这首歌，尤其是由Louis Armstrong 和 Ella 演唱的二重唱版本。这首歌完整地表达了即使是相爱的两个男女，他们彼此适应同样是多么地艰难。这是一个妥协和寻找共通之道的过程。这篇文章的意义也正在于此。   PHP能用最少的功夫和最多的乐趣来创建动态网站。为了创建这样的网站，我们需要使用数据库检索登录信息，在网页上显示动态新闻，存储论坛稿件。就以使用最通用的MySQL数据库来说，你们公司已经完成了如此神奇的工作，让你们的网站比你们所能想象的还有出名。接着你们也发现MySQL无法应付实际的工作量，是该更换数据库的时候了。   不幸的是，在PHP中不同数据库的存取有微小的不同。连接MySQL,你要使用mysql_connect()函数，当你决定升级到Oracle或Microsoft SQL Server时，你必须分别使用ocilogon()函数或mssql_connect()函数来连接。更糟糕的是不同连接所使用的参数也都不一样，有的数据库说po-tato(马铃薯的发音），别的数据库有说pota-to（马铃薯的一种发音）。喔...天啊。   我们不要放弃   当你需要确保你的程序的可移植性时，一个叫做ADODB的数据库封装程序库出现了。它提供给你一个通用的API来跟所有被支持的数据库沟通，因此你无须放弃！   ADODB是Active Data Objects DataBase 的缩写（很抱歉！玩电脑的有时候不是很有原创性）。ADODB当前支持的数据库有MySQL, PostgreSQL, Oracle, Interbase, Microsoft SQL Server, Access, FoxPro, Sybase, ODBC 和 ADO. 你可以从 http://php.weblogs.com/adodb下载ADODB。   MySQL的例子   PHP中最通用的数据库是MySQL，所以我想你应该熟悉以下的程序代码。它连接到localhost的MySQL服务器，，数据库名为mydb,并且执行一条SQL的Select语句。查询结果被一列列打印出来。   $db = mysql_connect("localhost", "root", "password"); mysql_select_db("mydb",$db); $result = mysql_query("SELECT * FROM employees",$db); if ($result === false) die("failed"); while ($fields = mysql_fetch_row($result)) { for ($i=0, $max=sizeof($fields); $i < $max; $i++) { print $fields[$i].' '; } print "<br>\n"; }   以上代码用颜色标记分段，第一段是连接部分，第二段是执行SQL语句，最后一段是显示字段。while循环扫描结果中的每一列，而for循环扫描每列的所有字段。   接下来是用ADODB写的等价代码。    include("adodb.inc.php"); $db = NewADOConnection('mysql'); $db->Connect("localhost", "root", "password", "mydb"); $result = $db->Execute("SELECT * FROM employees"); if ($result === false) die("failed");  while (!$result->EOF) { for ($i=0, $max=$result->FieldCount(); $i < $max; $i++)    print $result->fields[$i].' '; $result->MoveNext(); print "
\n"; }   现在改成指向Oracle数据库，程序代码只要修改第二行成NewADOConnection('oracle')即可。让我们看一下完整的程序代码...   连接数据库   include("adodb.inc.php"); $db = NewADOConnection('mysql'); $db->Connect("localhost", "root", "password", "mydb");   这里的连接代码比起原来MySQL的连接代码高级一些，因为我们正是需要更高级些的。在ADODB中，我们使用面向对象的方法来管理多种数据库的复杂性。我们用不同的类来处理不同的数据库。如果你还不熟悉面向对象编程，没关系--所有复杂的事情都被隐藏在NewADOConnection() 函数里。   为了节省内存，我们仅仅载入与你所连接的数据库相关的PHP程序代码。我们通过调用NewADOConnection(databasedriver)来完成这件事。合法的数据库驱动程序包括mysql, mssql, oracle, oci8, postgres, sybase, vfp, access, ibase  和许多其他驱动程序。   接着我们通过调用NewADOConnectiion()来从连接类中创建一个新的实例。最后我们使用$db->Connect()来连接数据库。   执行SQL语句   $result = $db->Execute("SELECT * FROM employees"); if ($result === false) die("failed"); 直接传送SQL语句到服务器。Execute() 函数执行成功将返回一个recordset对象。你应该像我们上面那样检查$result.   一个困扰初学者的问题是，在ADODB中有两种类型的对象，连接对象和recordset对象。我们何时用这些对象呢？   连接对象($db)负责连接数据库，化你的SQL查询。而recordset对象($result)负责检索数据并将数据库执行结果格式化成文本或数组。   我唯一需要增加的事情是，ADODB提供了许多有用的函数来让INSERT和UPDATE语句更容易些，这点我们在稍后的章节中会提到。   检索数据   while (!$result->EOF) {    for ($i=0, $max=$result->FieldCount(); $i < $max; $i++)    print $result->fields[$i].' ';    $result->MoveNext();    print "
\n"; } 前面取得数据的范例很像读文件。对于每一行，我们首先检查它是否到了文件结尾（EOF）。如果没有到达文件尾，就扫描该行的每个字段。然后移动到下一行，重复以上动作。$result->fields[]数组是有PHP数据库扩展生成的。有些数据库扩展不以字段名索引数组。要强制以名称索引该数组，使用 $ADODB_FETCH_MODE 这个全局变量。  $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') 正如你在上面例子中所看到的，两个recordset存储使用不同的取用模式，它们是基于$ADODB_FETCH_MODE的不同设置，在recordset被Execute()创建之前。ADOConnection连接到数据库的对象，执行SQL语句并且有一组工具函数来格式化SQL语句，比如关联与日期格式的语句。 其他有用的函数 $recordset->Move($pos)滚动到指定行。ADODB支持所有数据库的前滚。一些数据库不支持向后滚动记录。这倒不是个问题，因为你能用缓存记录来模拟向后滚动。 $recordset->RecordCount() 返回SQL语句执行结果的记录条数。有些数据库因为不支持而返回-1. $recordset->GetArray()以数组形式返回结果。 rs2html($recordset)是一个基于$recordset生成HTML表格的函数。 下例中以粗体显示相关用法： include('adodb.inc.php'); include('tohtml.inc.php'); /* includes the rs2html function */ $conn = &ADONewConnection('mysql'); $conn->PConnect('localhost','userid','password','database'); $rs = $conn->Execute('select * from table'); rs2html($rs); /* recordset to html table */ 还有许多有用的函数列在文档中，可从这个网站查得http://php.weblogs.com/adodb_manual. 高级题材 插入与更新 假设你想插入下列数据到数据库中 ID = 3 TheDate=mktime(0,0,0,8,31,2001) /* 31st August 2001 */ Note= sugar why don't we call it off 当你改用别的数据库，可能就不会成功插入数据。 第一个问题是，每个数据库各自有不同的默认日期格式。MySQL使用YYYY-MM-DD格式，而其他数据库则有不同的默认格式。ADODB提供DBDate() 函数来转换不同数据之间的日期默认格式。 下一个问题是单引号(don't)的表示法，在MySQL中，我们使用don\'t的形式，但是在其他数据库如Sybase, Access, Microsoft SQL Server，我们使用don''t的形式。qstr() 函数可以解决此问题。 我们如何使用这些函数呢？就像这样： $sql = "INSERT INTO table (id, thedate,note) values (" . $ID . ',' . $db->DBDate($TheDate) .',' . $db->qstr($Note).")"; $db->Execute($sql); ADODB还支持$connection->Affected_Rows()函数，它返回最近一次执行delete或update语句受影响的行数。及$recordset->Insert_ID() 函数，它返回最后因insert语句执行而自动生成的编号。预先提醒大家，并不是所有数据库都支持这两个函数。 MetaTypes 你能够得到更多关于字段的信息，通过调用recordset的方法FetchField($fieldoffset)。该函数返回一个包含三个属性（name,type,max_length）的对象。 举例说明： $recordset = $conn->Execute("select adate from table"); $f0 = $recordset->FetchField(0); 结果$f0->name的内容是‘adata’，$f0->type 将是‘date’。如果max_length不知道，其内容将会是-1。处理不同数据库的一个问题是，每个数据库对于相同的类型有不同的名字。比如timestamp类型在某些数据库称为datetime,而在另一个数据库中则称为time.所以ADODB提供MetaType($type,$max_length)函数来标准下列的类型。C: character and varchar types X: text or long character (eg. more than 255 bytes wide). B: blob or binary image D: date T: timestamp L: logical (boolean) I: integer N: numeric (float, double, money) 在前面的例子中， $recordset = $conn->Execute("select adate from table"); $f0 = $recordset->FetchField(0); $type = $recordset->MetaType($f0->type, $f0->max_length); print $type; /* should print 'D' */ select语句的limit和top支持 ADODB哟一个叫做 $connection->SelectLimit($sql,$nrows,$offset) 的函数，它允许你去检索recordset的一个子集。这是采用Microsoft产品中的selct top用法，以及PostgreSQL和MySQL中的select...limit用法。即使原来数据库并没有提供此用法，本函数也模拟提供该使用方式。 缓存支持 ADODB允许你在你的文件系统中缓存recordset数据，仅仅在$connection->CacheExecute($secs2cache,$sql) 和 $connection->CacheSelectLimit($secs2cache,$sql,$nrows,$offset). 设定的时间到达之后，才真正重新去查询数据库以节省时间。 PHP4 Session 支持 ADODB也支持PHP4 session handler,你可以存放你的session变量在数据库中，更多相关信息请访问http://php.weblogs.com/adodb-sessions 鼓励商业使用 假如你计划写商用的PHP应用软件来销售，我可以使用ADODB.我们依据GPL来发行ADODB.这意味着你可以合法地在商用软件中引用，并保有你程序的所有权。强烈鼓励ADODB的商业应用。我们内部也正基于此理由而在使用它。 结论 你看完了这篇文章。作为感谢，这里提供Let's call the whole thing off 的完整歌词。  Refrain You say eether and I say eyether, You say neether and I say nyther; Eether, eyether, neether, nyther - Let's call the whole thing off ! You like potato and I like po-tah-to, You like tomato and I like to-mah-to; Potato, po-tah-to, tomato, to-mah-to - Let's call the whole thing off ! But oh, if we call the whole thing off, then we must part. And oh, if we ever part, then that might break my heart. So, if you like pajamas and I like pa-jah-mas, I'll wear pajamas and give up pa-jah-mas. For we know we Need each other, so we Better call the calling off off. Let's call the whole thing off ! Second Refrain You say laughter and I say lawfter, You say after and I say awfter; Laughter, lawfter, after, awfter - Let's call the whole thing off ! You like vanilla and I like vanella, You, sa's'parilla and I sa's'parella; Vanilla, vanella, choc'late, strawb'ry - Let's call the whole thing off ! But oh, if we call the whole thing off, then we must part. And oh, if we ever part, then that might break my heart. So, if you go for oysters and I go for ersters, I'll order oysters and cancel the ersters. For we know we Need each other, so we Better call the calling off off. Let's call the whole thing off ! Song and lyrics by George and Ira Gershwin, introduced by Fred Astaire and Ginger Rogers in the film "Shall We Dance?" 感谢;翻译这篇文档参考了对应的繁体版。所以对它的作者表示感谢。繁体版你可以在这里看到http://www.ifin.net.tw/adodb/adodb_tutorial.htm 附记：我比较笨，花了我一天的空闲时间。但总算完成了。呵呵。第一次试着翻译文档，错误在所难免。请见谅。 并且希望它能起到抛砖引玉的作用。因为我相信只有聪明的你，我们大家都贡献自己的力量，我国的软件业才能得到更大的发展，我们才不会被外国人瞧不起。