PHP 5 数据对象 (PDO) 抽象层与 Oracle
一名新 php 数据对象 (pdo) 数据抽象层的原始开发人员为您简要介绍该抽象层,重点讲述与 oracle 一起运行的情况。
需要 php:5.0
需要其他:oracle 8 或更高版本客户端库
下载用于 oracle 的 pdo (windows):php_pdo.dll, php_pdo_oci.dll
下载用于 oracle 的 pdo (unix):pdo, pdo_oci
pdo 简介
php 主要是由志愿者完成的项目;尽管有少数一些固定的“核心”开发人员,但是我们没有一个人在全职受薪的开发 php。除此之外,我们分别位于世界不同地方,您可以想象长期开发的协调工作是何等困难。因此,php 主要是基于突发奇想的个人短期需求来发展的,其原因也多种多样,有的是试验,有的则是因为“明天有活要交”。尽管这样通常每一步都会改善 php,但从长远来看则是缺乏完整性 - 数据库扩展就是一个重要的例子。
在各种不同的数据扩展(oci、mysql、postgresql、mssql 等)之间根本没有真正的一致性,甚至在某些情况下,在这些扩展内部也没有真正的一致性。几乎所有这些扩展都在使用与基础数据库 api 紧密相连的不同代码完成着相同种类的任务。而且因为我们(php 核心开发人员和扩展开发人员)的人手非常有限,因此这就造成了代码更加难以维护,从而为 php 带来了很大的问题。
由于 php 越来越受欢迎并不断成功,因此主要 php 数据库扩展的维护者们参加了在德国举行的 linuxtag 2003 大会,在会上我们交换了对 php 前景的看法。在讨论 php 发展的随机性时,我们确定了在 php 中进行数据库访问的一些目标:
·提供一种轻型、清晰、方便的 api
·统一各种不同 rdbms 库的共有特性,但不排除更高级的特性。
·通过 php 脚本提供可选的较大程度的抽象/兼容性。
我们之所以提出了这种 php 数据对象 (pdo) 的概念,是因为我们希望通过采用 zend engine 2(php 5 的核心)先进的面向对象特性获得该 api 的一些更优秀的性能。
php 中的数据抽象层概念一点都算不上新;在 google 中查询“php database abstraction”会找到大约 83,200 个匹配项。它几乎是许多 php 开发人员梦寐以求的,而其产生则部分归因于我们不完整的 api。如果您曾经尝试过使用第三方抽象层来完成任何真正重要的工作,通常会发现这些抽象层对于手头的工作来说设计的功能过于强大了 - 或者表现为在使用前需要进行大量学习,或者表现为接口速度缓慢,参数需要经过多层脚本函数调用才能到达数据库自有的 api;通常是存在上述两种表象。
为什么这些抽象层会存在这种问题?这些抽象层总是在试图完成太多的任务,甚至可能是不可能的任务。我们决定以实用为目标,仅将一些最常见的数据库 api 特性作为我们的基础,并使得 pdo 驱动程序能够将它们特定于产品的特性暴露为常规扩展函数。
为什么使用 pdo?
听过有关数据库抽象扩展谣传的大多数人会立刻对 pdo 的扩展方面产生疑惑 - 我们是否要分析 sql,将其转换为相应的后端方言呢?我们如何处理特性 x 或特性 y,等等。因此,当您听说我们在 pdo 中根本不用为此而担忧时可能会大吃一惊;我们不希望使所有内容都完全统一,因为要使得这种统一成为可能,只能是将自己限制在最低的通用标准。
如果 pdo 不是一个整体的抽象层,那还有什么别的原因值得您考虑使用它吗?
·性能。pdo 从一开始就吸取了现有数据库扩展成功和失败的经验教训。因为 pdo 的代码是全新的,所以我们有机会重新开始设计性能,以利用 php 5 的最新特性。
·能力。pdo 旨在将常见的数据库功能作为基础提供,同时提供对于 rdbms 独特功能的方便访问。
·简单。pdo 旨在使您能够轻松使用数据库。api 不会强行介入您的代码,同时会清楚地表明每个函数调用的过程。
·运行时可扩展。pdo 扩展是模块化的,使您能够在运行时为您的数据库后端加载驱动程序,而不必重新编译或重新安装整个 php 程序。例如,pdo_oci 扩展会替代 pdo 扩展实现 oracle 数据库 api。还有一些用于 mysql、postgresql、odbc 和 firebird 的驱动程序,更多的驱动程序尚在开发。
您可能想了解 pdo 与其他常用的抽象层的对比情况,例如 pear db 或 adodb。无论在 api 方面还是在性能方面,pdo 都比其他常见抽象层要轻型,但是涉及到在各个数据库后端之间提供统一性方面,则不如那些抽象层,例如用于处理大量可移植性问题的 pear mdb 2 抽象层。
在哪里可以获得 pdo?
pdo 是通过 pecl(发音为“pee-kle”,欧洲语言风格),即 php 扩展库提供的。如果您在运行 linux 计算机,请按照下面的说明进行设置;稍后是在 windows 上安装的详细信息。
请注意,pdo 及其驱动程序当前处于“alpha”状态;这就意味着我们会合理保证没有重大缺陷,但是该程序包功能并不完善 - 我们还要添加很多功能。虽然我们鼓励您测试该程序包,但是实在不推荐在现阶段将其用于生产。
unix/linux 安装
如果您以前尚未尝试过 php 5,则请花一点时间来通读一下“新闻”和各种声明。在 unix 计算机上,您可能要安装或升级 libxml2;如果没有 libxml2,“pear”程序包管理工具就无法运行,您安装 pdo 时就会遇到很多困难。获取 php 5,并将其编译和安装。确保指定的前缀不是 /usr/local/,这样它就不会与 php 4 安装发生冲突了:
% ./configure --prefix=/usr/local/php5 --with-zlib [此处指定其他选项]
% make install
现在您就可以使用“pear”工具获取并安装 pdo 以及用于 pdo 的 oracle 驱动程序了。因为 pdo 当前标记为 alpha,所以默认情况下 pear 工具不会下载该程序包。在该程序包名称后面添加后缀“-alpha”,通知该 pear 工具可以安装 alpha 版本:
% path="/usr/local/php5/bin:$path"
% pear install pdo-alpha
您需要告知 php 从专用于 php 5 的 php.ini 文件加载 pdo 驱动程序。如果您使用的前缀与我使用的一样,php 则会在 /usr/local/php5/lib/php.ini 中查找 php.ini 文件。向该文件中添加以下行:
extension=pdo.so
现在您需要获取数据库特定的驱动程序;对于 oracle,此特定程序称为 pdo_oci。在 shell 中,键入:
% pear install pdo_oci-alpha
此驱动程序也需要从 php.ini 文件加载;将下行添加到前面添加的那行之后:
extension=pdo_oci.so
现在检查一下,确保它能够运行:
% php -m
在模块列表中,您应该会看到 pdo 和 pdo_oci。
防火墙碍事了?
如果您位于防火墙的后面,则在使用 pear 安装程序获取程序包时可能会遇到一些问题。如果发生这种情况,则可以按照下列说明手动下载并安装这些程序包:
% wget http://pecl.php.net/get/pdo
% pear install pdo-0.1.1.tgz
[ 将 extension=pdo.so 添加到 php.ini ]
% wget http://pecl.php.net/get/pdo_oci
% pear install pdo_oci-0.1.tgz
[ 将 extension=pdo_oci.so 添加到 php.ini ]
在上述两种情况下,都需要首先调用“pear install”(后跟下载的真正程序包);上述示例中的版本号在本文编写之时是最新的,但随着开发的继续进行会发生变化。
windows 安装
如果您正在运行 windows,则请按照下列说明执行:
·从 http://www.php.net/downloads.php#v5 获取 php 5,将其解压缩到 c:\php5。
·从 http://snaps.php.net/win32/pecl_5_0/php_pdo.dll 和http://snaps.php.net/win32/pecl_5_0/php_pdo_oci.dll 分别获取 pdo 和 pdo_oci,将其放入 c:\php5\ext。或者,您可以从 php 5 下载页上列出的“用于 php 5.0.0 的 pecl 模块集合”zip 文件中找到所有这些 pdo 驱动程序,以及所有 pecl 程序包的所有 windows 版本。
·编辑 c:\php5\php.ini 文件,并添加下列内容:
extension=php_pdo.dll
extension=php_pdo_oci.dll
编辑 php.ini 文件时,有一点很重要,即要在任何其他 pdo 驱动程序之前先加载 pdo 扩展,否则就不能正确初始化(在这种情况下会出错)。
如果在 windows 目录中有一个 php 4 的全局 php.ini 文件,则可能会遇到问题。最好的解决方法是,移动该 php.ini 文件,使其与 php 4 sapi 位于相同的文件夹中,以隔离 php 4 安装;例如,将其移动到与 php4apache.dll 相同的文件夹中。请注意,php 5 程序中并非所有文档都是最新的;推荐的安装过程如上面所述 - 如 install.txt 文件所声明的,请勿将任何 dll 复制到 windows 文件夹或 system 文件夹中 - 任何内容都是自包含的。如果您运行的是 apache,并且遇到无法加载 dll 的错误,则检查一下是否将 c:\php5 添加到了 path 中。另外,还要注意 php 5 的 cgi 版本现在的名称为 php-cgi.exe。
连接 pdo
首先创建 pdo 类的一个实例,将其用作数据库句柄。使用哪个基础驱动程序并不重要;您总要使用 pdo 类名。构造函数的第一个参数为数据源名称 (dsn),第二个参数为用户名,第三个参数为该用户名的口令。dsn 的 pdo 命名惯例为 pdo 驱动程序的名称,后面一个冒号,再后面是可选的驱动程序特定的信息。在我们的示例中,会加载 oci 驱动程序但不指定任何其他信息;这样会使用默认的数据库。对于其他驱动程序,如 odbc 驱动程序,第一个冒号后面的所有内容都将被用作 odbc dsn。mysql 驱动程序会同样以不同的方式解释它的 dsn。
如果无法加载该驱动程序,或者发生了连接失败,则会抛出一个 pdoexception,以便您可以决定如何最好地处理该故障。
<?php
try {
$dbh = new pdo("oci:", "scott", "tiger");
} catch (pdoexception $e) {
echo "failed to obtain database handle " .$e->getmessage();
}
?>
在连接字符串中,您可以指定两个可选参数;第一个是数据库名称,第二个是字符集;这些参数与可选的第三个和第四个参数相对应,后两个参数您可能在 oci8 扩展函数 ociconnect() 或 ociplogon() 中使用过。要使用特定的字符集连接一个特定的数据库,则可以执行下列操作:
<?php
try {
$dbh = new pdo("oci:dbname=accounts;charset=utf-8", "scott", "tiger");
} catch (pdoexception $e) {
echo "failed to obtain database handle " .$e->getmessage();
}
?>
省略 try..catch 控制结构并无裨益。如果在应用程序的较高级别没有定义异常处理,则在无法建立数据库连接的情况下,该脚本会终止。
连接管理
目前,pdo 完全没有执行自己的任何连接管理,因此每个“新 pdo”调用都会建立一个新的数据库连接。该连接在 $dbh 变量越界时,或者当您为其指定 null 值时会被释放。
<?php
try {
$dbh = new pdo("oci:dbname=accounts;charset=utf-8", "scott", "tiger");
} catch (pdoexception $e) {
echo "failed to obtain database handle " .$e->getmessage();
exit;
}
// 在此处对数据库执行一些操作
// ...
// 现在完成,释放该连接
$dbh = null;
?>
计划在不久的将来为 pdo 增加连接缓存功能;就当前的 oci8 扩展而言,会重用与现有服务器的连接,并且在这些连接中,还会重用闲置的登录。当在缓存连接模式中运行时,如上面的代码段所示释放 $dbh 时会将该登录标记为可由其他连接重用。
如果您使用 odbc 驱动程序访问 oracle,则可能会很高兴地注意到,默认情况下 pdo_odbc 驱动程序支持 odbc 连接池。
使用 pdo
了解一个编程 api 的最好方式就是使用它,因此我们来看一下附带的这个演示,以了解如何进行批次更新(代码如下)。
<?php
// create a pdo database handle object
// the 'oci:' string specifies that the oci driver should be used
// you could use 'oci:dbname=name' to specify the database name.
// the second and third parameters are the username and password respectively
$dbh = new pdo('oci:', 'scott', 'tiger');
// create a test table to hold the data from credits.csv
$dbh->exec("
create table credits (
extension varchar(255),
name varchar(255)
)");
// start a transaction
$dbh->begintransaction();
// prepare to insert a large quantitiy of data
$stmt = $dbh->prepare("insert into credits (extension, name) values (:extension, :name)");
// bind the inputs to php variables; specify that the data will be strings
// with a maximum length of 64 characters
$stmt->bindparam(':extension', $extension, pdo_param_str, 64);
$stmt->bindparam(':name', $name, pdo_param_str, 64);
// open the .csv file for import
$fp = fopen('credits.csv', 'r');
while (!feof($fp)) {
list($extension, $name) = fgetcsv($fp, 1024);
$stmt->execute();
}
fclose($fp);
// commit the changes
$dbh->commit();
?>
既然我们已经成功连接到了 oracle,那么现在就可以创建一个表来保存一些数据了。对于此示例,我们使用一些 php 扩展及其作者,并将这些内容输入一个数据库中。数据库句柄对象的 exec() 方法可用来发出不会返回结果集的快速一次性查询,因此我们在这里使用该方法来发出 create table 查询。
为了使得示例更自然,我从 php 源代码中抽取了扩展及其作者的信息,并将其存储到了一个 csv 文件中(请参见“相关附件:credits.csv”)。这就代表一个常见情形:从 csv 文件批次导入数据。在我们的示例中,我们充分利用了 oracle 的预处理语句和绑定参数,以获得一个高效的数据导入脚本。在讲述该示例之前,有必要了解一下 pdo 处理事务的方式。
pdo 中的事务处理
oracle 具有一个敏感的默认操作模式:当您进行连接时,将会位于一个隐式事务处理中,在提交事务之前其中的更改不会完全生效。除了事务处理的标准优点(原子性、一致性、隔离性、可持久性 - acid)之外,数据库服务器在执行每次更新之后还不需要重新构建索引和其他内部结构;它可以延迟到提交之后进行。这样会加速代码的执行。oracle 这点确实很好。
但不幸的是,并非每个数据库供应商都支持事务处理,并且因为 pdo 旨在以一种相对可移植的方式支持这些事务处理,所以它默认情况下以自动提交模式运行。启用自动提交模式后,数据库驱动程序会隐式提交每个成功的更新。当您调用 $dbh->begintransaction() 时,就会请求关闭自动提交,直到调用 $dbh->commit() 或者 $dbh->rollback() 才会重新启用,具体取决于您的代码是怎样编写的。如果基础驱动程序不支持事务处理,则会抛出一个 pdoexception。
如果发生了问题并且 php 出错,您的脚本将退出并且事务处于待批状态;或者您关闭数据库句柄时,pdo 会自动针对任何待批的事务调用 $dbh->rollback()。此行为会减少向数据库中提交可能未定义或者已损坏数据的可能性,这是用于处理已放弃事务的标准语义。
预处理语句、存储过程
pdo 支持使用 oracle 样式命名的占位符语法将变量帮定到 sql 中的预处理语句(与 oci8 扩展中的 ocibindbyname() 类似)。pdo 还为其他数据库(如 odbc)提供了命名占位符模拟,甚至可以为生来就不支持该概念的数据库(如 mysql)模拟预处理语句和绑定参数。这是 php 向前迈进的积极一步,因为这样可以使开发人员能够用 php 编写“企业级”的数据库应用程序,而不必特别关注数据库平台的能力。
使用 pdo 预处理语句非常简单,调用数据库句柄的 prepare() 方法即可。它会返回一个语句句柄对象,然后您可以使用该对象来绑定参数和执行语句。在此示例中,我们将要定义两个命名占位符,“:extension”和“:name”,这两个占位符分别与 .csv 文件中的 php 扩展名称和其中一个作者的姓名相对应。
$stmt = $dbh->prepare("insert into credits (extension, name) values (:extension, :name)");
预处理了语句之后,我们使用 bindparam() 方法来将这些命名参数分别与 php 变量名称“$extension”和“$name”相关联(这与 ocibindbyname() 类似)。我们还会通知 oracle,这些数据将要格式化为字符串,最大长度为 64 个字符。
$stmt->bindparam(':extension', $extension, pdo_param_str, 64);
$stmt->bindparam(':name', $name, pdo_param_str, 64);
我们现在即准备好插入数据了 - 我们只需要打开该 csv 文件,并从中获取数据即可。通过使用 fopen() 和 fgetcsv() 函数可以相当简单地完成此操作。然后,我们可以使用 php list() 构造函数直接将 csv 的列指定给变量“$extension”和“$name”。因为这些变量已经绑定到了语句中,所以我们现在要做的只是调用该语句对象的 execute() 方法使其执行插入。这种方式既方便又快捷 - 在事务处理时每个迭代循环只有两行。到达文件尾时,我们就可以立即使用数据库句柄的 commit() 方法来提交这些更改了。
如果您只是要传递输入参数,并且有许多这样的参数要传递,那么您会觉得下面所示的快捷方式语法非常有帮助;此语法使您能够省去对 $stmt->bindparam() 的调用。
$stmt = $dbh->prepare("insert into credits (extension, name) values (:extension, :name)");
$stmt->execute(array(':extension' => $extension, ':name' => $name));
您还可以使用 bindparam 来为存储过程设置输入/输出参数;语法是完全相同的,只是查询有所不同。下面的代码演示如何调用一个名为“sp_add_item”的存储过程;其目的是要针对输入设置 $item_name,然后该存储过程将在返回时更新 $error_code。
$stmt = $dbh->prepare("begin sp_add_item(:item_name, :error_code); end");
$stmt->bindparam(':item_name', $item_name, pdo_param_str, 12);
$stmt->bindparam(':error_code', $error_code, pdo_param_str, 12);
$stmt->execute();
抓取数据
使用 pdo 抓取数据与进行插入或更新相似,只是您执行完查询之后,将要重复调用 fetch() 方法来获取结果集的下一行。进行获取的最简单情况如下所示,值得注意的一点是,您还可以将参数绑定到查询,以控制如 where 子句这样的内容;执行此操作的语法与我们已经看到的 bindparam() 代码完全相同。
$stmt = $dbh->prepare("select extension, name from credits");
if ($stmt->execute()) {
while ($row = stmt->fetch()) {
print_r($row);
}
}
pdo 支持一些不同的抓取策略,这些策略在方便性和性能方面有所差别;通过将下列选项之一指定为 fetch() 方法的参数,您可以更改其返回值以适应您的语法:
·pdo_fetch_num - 每个行抓取返回一个按照列位置索引的数组,并且以 0 为基数(第一列是第 0 个元素)。
while ($row = $stmt->fetch(pdo_fetch_num)) {
printf("extension %s, by %s<br>", $row[0], $row[1]);
}
·pdo_fetch_assoc - 每个行抓取根据行集中的列名,返回一个按列名索引的数组。
while ($row = $stmt->fetch(pdo_fetch_assoc)) {
echo "extension $row[extension] by $row[name]<br>";
}
·pdo_fetch_both - 每个行抓取返回一个既按照列位置又按照列名索引的数组。也就是上述两种情况的直接组合。如果没有指定抓取模式,则该模式为默认模式。
·pdo_fetch_obj - 每个行抓取返回一个匿名对象,其属性名与列名对应。
while ($row = $stmt->fetch(pdo_fetch_assoc)) {
echo "extension {$row->extension} by {$row->name}<br>";
}
·pdo_fetch_lazy - 每个行抓取返回一个引用语句对象的重载对象。这“看起来”好像是 pdo_fetch_obj 和 pdo_fetch_both 的组合,只是只有当您在脚本中访问 php 变量时才创建这些变量。
·pdo_fetch_bound - 抓取每行,返回 true。在使用绑定输出列时这种方式非常有用,它可以避免创建不需要的任何数组或对象。(请参见下面的示例)。
无论您使用哪种抓取策略,当没有其他行可抓取时,fetch() 方法将会返回 false。
现在我要讲述一些技巧,如果您需要最后再调整一下脚本性能的话,这些技巧可能会对您有所帮助。但先给你一个忠告:要像躲避瘟疫一样避免不成熟的优化。您应该总是首选最清晰、可维护性最好的解决方案。请记住,在一个典型的 web 应用程序中,您不能衡量各种抓取模式间的区别,除非脚本要处理很多行。我再重复一遍:抓取模式间的性能区别非常小 - 请使用最适合您代码的模式。
请记住,使用 pdo_fetch_num 的花销最小,因为访问列数据只是一个简单的数值查询。pdo_fetch_obj 使您能够使用 oo 语法将数据集的列作为对象的属性来访问,但是每个属性访问都涉及一个附加的散列查询,使得使用它的花销基本上与 pdo_fetch_assoc 相同。每个这样的模式都会复制整行,从而占用稍多的内存。
很多数据库驱动程序都会代表您预先抓取并缓存一定数量的行。php 每次访问其中一个这样行中的列时,它都需要将其复制到自己的专用内存区域中。如果您的查询涉及很多行,而只需要基于某种复杂的逻辑访问给定行的特定列,则您会发现 pdo_fetch_lazy 是一种避免使用很多内存的有用方法,因为它只有在您访问给定列时才复制该列。使用此方式时要注意,从某个给定语句为每个 fetch() 抓取的“惰性对象”是每次迭代时使用的同一对象(以减少每次创建/销毁它的开销)。这就暗示着您不能只是简单地存储该对象用于以后的比较,因为它仍然会引用该语句的当前行 - 您需要手动复制所需要的部分。
最后一种模式为 pdo_fetch_bound,该模式会告知 pdo 您已经将所有列绑定到了 php 变量,并且除了要它在到达行集的末尾时通知您外不需要它执行别的任何操作。绑定输出列在概念上与绑定输入参数相似,只是绑定输出列可以用于所有数据库驱动程序。您可以将 php 变量绑定到命名列,pdo 将在每次调用 execute() 时对其进行更新。此技术可用来剃去结果集中每列、每行的一些虚拟机器操作码(这种代码速度比原生码要慢)。这种技术的缺点在于,可能会使您的代码难以跟踪(也称为 wtf 系数较高),您使用变量名称时需要倍加小心。下面的代码说明了绑定输出列的使用。请注意,您不必指定 pdo_fetch_bound 即可使用 $stmt->bindcolumn();pdo_fetch_bound 只是一个对于您了解只能使用绑定值的情况的一种优化。
$stmt = $dbh->prepare("select extension, name from credits");
if ($stmt->execute()) {
$stmt->bindcolumn('extension', $extension);
$stmt->bindcolumn('name', $name);
while ($stmt->fetch(pdo_fetch_bound)) {
echo "extension:$extension, author:$name\n";
}
}
可移植性
区分大小写的列
pdo 旨在令使用可移植 sql 的脚本运行良好、可移植。本文中提及的所有查询(调用存储过程除外)在使用任何 pdo 驱动程序时其运行性能应该相同 - 包括所有绑定输入变量和绑定输出列。
但有一个转换问题 - 当您使用 pdo_fetch_assoc 抓取数据时,不同的驱动程序会以不同的方式返回列名 - 某些会将列名转化为大写,某些转换为小写,某些则会使其呈查询中指定的样式。这对于 php 脚本来说是一个潜在的问题,因为数组键区分大小写。pdo 提供了一个兼容性属性来帮助规范脚本的结果。下面的小代码段是上面 pdo_fetch_bound 示例的可移植版本,因为 setattribute() 方法调用会指导 pdo 将抓取返回的列名全部转换为大写:
$dbh = new pdo('oci:', 'scott', 'tiger');
$dbh->setattribute(pdo_attr_case, pdo_case_upper);
stmt = $dbh->prepare("select extension, name from credits");
if ($stmt->execute()) {
$stmt->bindcolumn('extension', $extension);
$stmt->bindcolumn('name', $name);
while ($stmt->fetch(pdo_fetch_bound)) {
echo "extension:$extension, author:$name\n";
}
}
除了 pdo_case_upper 之外,还有 pdo_case_lower(它会将列名转换为小写)和 pdo_case_natural(它是默认选项:使列保持数据库驱动程序返回的形式)。
错误和错误处理
可移植脚本的另一个难题是处理从各种数据库处理程序返回的各种不同的错误消息;某些数据库对于程序化处理错误的支持能力很差,而其他一些数据库则具有非常丰富的错误代码。只要可行,pdo 将为您的脚本提供一个统一的错误代码,从而使您不必为应对可移植性的这个方面所累。当然,pdo 还会为驱动程序提供原生错误代码和错误消息,以防您需要用它来进行诊断,或者错误代码映射不完整。
另一个困扰 php 数据库扩展的一致性问题是错误处理策略的一致性:某些扩展会返回的错误代码需要您手动抓取错误字符串,而其他一些扩展则只是发出 php 警告。pdo 允许您从下列三种不同的错误处理策略中选择一种:
·pdo_errmode_silent
这是默认模式;它只是使用语句和数据库句柄对象的 errorcode() 和 errorinfo() 方法为您设置要检查的错误代码。
if (!$dbh->exec($sql)) {
echo $dbh->errorcode() ."<br>";
$info = $dbh->errorinfo();
// $info[0] == $dbh->errorcode() 统一的错误代码
// $info[1] 是驱动程序特定的错误代码
// $info[2] 是驱动程序特定的错误字符串
}
·
pdo_errmode_warning
除了设置错误代码之外,pdo 还会发出 php 警告,您可以使用常规的 php 错误处理程序捕获该警告,并集中应用您准备好用于应用程序的任何错误处理/记录策略,或者只是使该错误显示在浏览器中(在内部测试过程中非常有用)。
·
pdo_errmode_exception
除了设置错误代码之外,pdo 还会抛出一个 pdoexception,并将其属性设置为包含该错误代码和信息。然后,您可以在代码的较高级别捕获该异常,使用全局异常处理程序捕获该异常,或者不对其进行处理而终止脚本(此时将回滚任何未决的事务)。
try {
$dbh->exec($sql);
} catch (pdoexception $e) {
// 显示警告消息
print $e->getmessage();
$info = $e->errorinfo;
// $info[0] == $e->code; unified error code
// $info[1] 是驱动程序特定的错误代码
// $info[2] 是驱动程序特定的错误字符串
}
请注意,与警告或异常相比,静默模式针对运行时错误使用的资源最少,但是为了获得该速度,您牺牲了一些简单性,而变得有一点复杂。
统一错误代码表当前包括下列常量: pdo_err_none、pdo_err_cant_map、pdo_err_syntax、pdo_err_constraint、pdo_err_not_found、pdo_err_already_exists、pdo_err_not_implemented、pdo_err_mismatch、pdo_err_truncated、pdo_err_disconnected。
这些常量所代表的意思字面即可推知,但是 pdo_err_cant_map 代码除外;这是一个 pdo 特定的代码,也就是说它无法将驱动程序特定的代码映射到统一的错误代码,因此您应该查询 errorinfo() 方法返回的驱动程序特定代码来获得更多信息。
数据类型
pdo 在某种程度上类型不可知,因此它喜欢将数据表示为字符串,而不是将其转换为整数或双精度类型。此时您可能对此有些迷惑,但是原因非常简单:字符串类型是最精确的类型,在 php 中具有最广泛的应用范围;过早地将数据转换为整数或者双精度类型可能会导致截断或舍入错误。通过将数据以字符串抽出,pdo 为您提供了一些脚本控制,您可以使用普通的 php 类型转换工具(如数学运算过程中的转换和隐式)来控制如何进行转换以及何时进行转换。
null
如果结果集中的某列包含一个 null 值,pdo 则会将其映射为 php null 值。oracle 在将数据返回 pdo 时会将空字符串转换为 null,但是 php 支持的任何其他数据库都不会这样处理,从而导致了可移植性问题。pdo 提供了一个驱动程序级属性 pdo_attr_oracle_nulls,该属性会为其他数据驱动程序模拟此行为:
$dbh = new pdo('oci:', 'scott', 'tiger');
$dbh->setattribute(pdo_attr_oracle_nulls, true);
// 现在从此 $dbh 打开的任何语句中的
// 空字符串都将被转换为 null
pod 的现状和未来
pdo 现在仍相当不成熟,但是会快速成熟起来。在编写本文之时,我在本文中提到的任何内容都能够通过 pdo_oci 驱动程序适用于 oracle 8 或更高版本(在 oracle 8.0 和 9.2 上测试过)。
已经计划增加以下主要特性,在不久将可以使用:
1.使用 php 流的 lob 支持。 使用绑定参数,您能够将任何流资源(如文件、套接字、http 资源、压缩/筛选的流)作为输入或输出参数传递到在 lob 上运行的查询中。与之相似,类型为 lob 的输出参数将表现为 php 流,因此您可以使用 fread()、fwrite()、fseek() 和其他流函数来访问这些参数。此时,在 pdo 中根本没有 lob 支持。
2.持久性连接和缓存的预处理语句。 持久性连接使您能够避免在每个页面命中时打开和关闭数据库服务器连接。缓存的预处理语句又前进了一步,它使您能够持久保持查询的预处理版本以及数据库句柄。
3.游标。 目前,pdo 只提供前向只读游标,但是将来会提供可滚动游标(需要基础驱动程序支持)、ref-cursor、使用游标进行定位更新,以及可更新滚动游标。
我们希望在 php 5.1 中默认启用 php 扩展(距此目标尚远),但是在此之前,我们希望能让 pdo 在 php 5.0 发布时稳定运行,但是我们日常工作中的压力稍稍拖延了这些工作。同时,通过 pecl 发布 pdo 使我们能够在收到问题报告时做出回应,并根据不同于 php 5.0 发布时间表的时间表发布修复版本,因此您在 php 5.1 发布前即可使用 pdo。
我们需要您的反馈
如果您试用了 pdo,并且发现了问题,请务必使用我们的错误跟踪软件将其报告给我们。如果您使用的是 oracle 驱动程序,则请使用此页:
http://pecl.php.net/bugs/report.php?package=pdo_oci
如果您使用的是其他驱动程序,则请用其名称替换该 url 中 pdo_oci。
如果您使用 pdo 时遇到问题,或者针对某些特性存在疑问,或者具有特性请求,请联系 pecl-dev@lists.php.net。如果您愿意,当然还可以直接联系我 (wez@php.net),但是请注意,我每天都会收到大量有关 php 的电子邮件;您可能会发现如果首先与前面的邮件列表联系会更快得到答复。
-----------
关于作者
wez furlong 是 brain room ltd. 的技术总监,他在该公司不但使用 php 用于 web 开发,还将其用作 linux 和 windows 应用程序和系统的嵌入式脚本引擎。wez 是 php 的核心开发人员,经常向 sqlite、com/.net、activephp、mailparse 和 streams api 等投稿,他是 pecl 即 php 扩展社区库的“头儿”。他的咨询公司的网页为 http://www.thebrainroom.net。