PDO全攻略

我们为什么要使用PDO进行PHP程序开发

PDO扩展为PHP定义了一个访问数据库的轻量的，持久的接口。实现了PDO接口的每一种数据库驱动都能以正则扩展的形式把他们各自的特色表现出来。注意；利用PDO扩展本身并不能实现任何数据库函数。你必须使用一个特定的数据库PDO驱动去访问数据库。
PDO提供了一个数据访问抽象层，这就意味着，不管你使用的是哪种数据库，你都可以用同样的函数去进行查询的获取数据。PDO并不提供数据提取，它不会重写SQL语句，或者模仿这些功能。你需要使用一个成熟的提取层，如果你需要的话。

怎么样，是不是看了译文就有一种恍然大悟的感觉了？
没有？
那说的再详细点。
我们为什么要使用PDO？
1、更换数据库时取得极大便利
在PHP4/3时代，PHP要利用php_mysql.dll、php_pgsql.dll、php_mssql.dll、 php_sqlite.dll等等扩展来连接MySQL、PostgreSQL、MS SQL Server、SQLite，这其实也没什么。也就是在配置时多添句话就行了。
可怕的是，这些扩展和各自对应的数据库打交道时，他们各自的函数有很多是不一样的。
比如：
PHP利用libmysql.dll和MYSQL打交道时，如果要从数据表中提取数据作为关联数组，用的是mysql_fetch_accoc，而如果要从postgre数据库取得同样的结果，你就不得不用pg_fetch_assoc。
很简单的例子说明了很重要的问题，假如你要更换数据库类型，比如从MYSQL更换成POSTGRE，你就不得把你所有和数据库有关的程序都改一遍。这时候，你应该会明白，为什么我不用PDO？？
2、极大提高程序运行效率
针对上面的情况，也许你会说，我可以使用ADODB(LITE)，PEAR::db来实现对不同类型数据库函数的封装啊。这样子，即使我更换数据库，也不需要修改程序。
答：php代码的效率怎么能够和直接用C/C++写的扩展效率比较呢？根本不是一个数量级的。
OK，从现在开始用PDO进行你的开发吧。

安装

PDO扩展为PHP访问数据库定义了一个轻量级的、一致性的接口，它提供了一个数据访问 抽象层，这样，无论你使用什么数据库，你都可以通过一致的函数执行查询和获取数据。注意，你并不能使用PDO扩展本身执行任何数据库操作，你必须使用一个database-specific PDO driver （针对特定数据库的PDO驱动）访问数据库服务器。

PDO并不 提供数据库 抽象，它并不会重写SQL或提供数据库本身缺失的功能，如果你需要这种功能，你需要使用一个更加成熟的抽象层。

PDO随PHP5.1发行，在PHP5.0的PECL扩展中也可以使用。PDO需要PHP5核心OO特性的支持，所以它无法运行于之前的PHP版本。

 

在Unix环境下PHP5.1以上版本中：

1. 如果你正在使用PHP5.1版本，PDO和PDO SQLITE已经包含在了此发行版中；当你运行configure时它将自动启用。推荐你将PDO作为共享扩展构建，这样可以使你获得通过PECL升级的 好处。推荐的构建支持PDO的PHP的configure line应该也要启用zlib。你也应该启用你选择的数据库的PDO驱动 ；关于这个的更多信息请查看database-specific PDO drivers ，但要注意如果你将PDO作为一个共享扩展构建，你必须也要将PDO驱动构建为共享扩展。SQLite扩展依赖于PDO，所以如果PDO作为共享扩展构建，SQLite也应当这样构建
   ./configure --with-zlib --enable-pdo=shared --with-pdo-sqlite=shared --with-sqlite=shared    
2. 将 PDO安装为一个共享模块后，你必须编辑php.ini文件使得在PHP运行时自动载入PDO扩展。你同样需要启用那儿的特定数据库 驱动；确保他们列出在 pdo.so  行之后，因为PDO必须在特定数据库驱动载入之前初始化。如果你是以静态方式构建的PDO和特定数据库驱动扩展，你可以跳过这一步。
   

   extension=pdo.so

    
   
3. 让PDO作为一个共享的模块将使你可以在新版PDO发布时运行 pecl upgrade pdo  命令升级，而不用强制你重新构建整个PHP。注意如果你是这样做的，你也需要同时升级你的特定数据库驱动。

在Windows环境下PHP5.1以上版本中：

1. PDO和主要数据库的驱动同PHP一起作为扩展发布，要激活它们只需简单的编辑php.ini文件：
   

   extension=php_pdo.dll 

    
   
2. 然后，选择针对特定数据库的DLL文件使用 dl() 在运行时加载，或者在php.ini文件中 php_pdo.dll 行后启用它们，如：
   

   extension=php_pdo.dll
   extension=php_pdo_firebird.dll
   extension=php_pdo_informix.dll
   extension=php_pdo_mssql.dll
   extension=php_pdo_mysql.dll
   extension=php_pdo_oci.dll
   extension=php_pdo_oci8.dll
   extension=php_pdo_odbc.dll
   extension=php_pdo_pgsql.dll
   extension=php_pdo_sqlite.dll

    
   这些DLL文件应当存在于系统的 extension_dir 目录里。注意 PDO_INFORMIX 只能作为一个PECL扩展使用。

修改php.ini后重启http服务器。

OK，PDO安装完毕。

PDO中包含三个预定义的类

PDO中包含三个预定义的类，它们分别是 PDO 、PDOStatement  和 PDOException ，下面将分别简单介绍一下。后面的系列相关文章会使用若干示例介绍这几个类的使用。

一、PDO
代表一个PHP和数据库之间的连接。

方法：

1. PDO - 构造器，构建一个新的PDO对象
2. beginTransaction - 开始事务
3. commit - 提交事务
4. errorCode - 从数据库返回一个错误代号，如果有的话
5. errorInfo - 从数据库返回一个含有错误信息的数组，如果有的话
6. exec - 执行一条SQL语句并返回影响的行数
7. getAttribute - 返回一个数据库连接属性
8. lastInsertId - 返回最新插入到数据库的行（的ID）
9. prepare - 为执行准备一条SQL语句，返回语句执行后的联合结果集(PDOStatement)
10. query - 执行一条SQL语句并返回一个结果集
11. quote - 返回添加了引号的字符串，以使其可用于SQL语句中
12. rollBack - 回滚一个事务
13. setAttribute - 设置一个数据库连接属性

/* 通过 ODBC 驱动建立数据库连接 */   
$dsn  =  'mysql:dbname=testdb;host=127.0.0.1' ;  
$user  =  'dbuser' ;  
$password  =  'dbpass' ;  
try {  
  $dbh  =  new  PDO( $dsn ,  $user ,  $password );  
} catch (PDOException $e ) {  
  echo   'Connection failed: '  .  $e ->getMessage();  
}  
/* 事务处理开始，关闭自动提交事务(autocommit) */   
$dbh ->beginTransaction();  
/* 更改数据库结构 */   
$sth  =  $dbh -> exec ( "DROP TABLE fruit" );  
/* 提交事务 */   
$dbh ->commit();  
/* Database connection is now back in autocommit mode */ 

 

二、PDOStatement
代表一条预处理语句以及语句执行后的联合结果集（associated result set）。

方法：

1. bindColumn - 绑定一个PHP变量到结果集中的输出列
2. bindParam - 绑定一个PHP变量到一个预处理语句中的参数
3. bindValue - 绑定一个值到与处理语句中的参数
4. closeCursor - 关闭游标，使语句可以再次执行
5. columnCount - 返回结果集中的列的数量
6. errorCode - 从语句中返回一个错误代号，如果有的话
7. errorInfo - 从语句中返回一个包含错误信息的数组，如果有的话
8. execute - 执行一条预处理语句
9. fetch - 从结果集中取出一行
10. fetchAll - 从结构集中取出一个包含了所有行的数组
11. fetchColumn - 返回结果集中某一列中的数据
12. getAttribute - 返回一个 PDOStatement 属性
13. getColumnMeta - 返回结果集中某一列的结构(metadata?)
14. nextRowset - 返回下一结果集
15. rowCount - 返回SQL语句执行后影响的行数
16. setAttribute - 设置一个PDOStatement属性
17. setFetchMode - 为 PDOStatement 设定获取数据的方式

三、PDOException
返回PDO触发的错误。你不能从你的代码中抛出一个PDOException异常。

<?php  
try {  
  $dbh  =  new  PDO( 'mysql:host=localhost;dbname=test' ,  $user ,  $pass );  
  foreach  ( $dbh ->query( 'SELECT * from FOO' )  as   $row ) {  
    print_r($row );  
  }  
  $dbh  = null;  
} catch (PDOException $e ) {  
  print "Error!: "  .  $e ->getMessage() .  "<br/>" ;  
  die ();  
}  
?>

 

错误处理

为适合你的应用开发，PDO 提供了3中不同的错误处理策略。

1. PDO::ERRMODE_SILENT

   这是默认使用的模式。PDO会在statement和database对象上设定简单的错误代号，你可以使用PDO->errorCode() 和 PDO->errorInfo() 方法检查错误；如果错误是在对statement对象进行调用时导致的，你就可以在那个对象上使用 PDOStatement->errorCode() 或 PDOStatement->errorInfo() 方法取得错误信息。而如果错误是在对database对象调用时导致的，你就应该在这个database对象上调用那两个方法。

    

2. PDO::ERRMODE_WARNING

    作为设置错误代号的附加，PDO将会发出一个传统的E_WARNING信息。这种设置在除错和调试时是很有用的，如果你只是想看看发生了什么问题而不想中断程序的流程的话。

3. PDO::ERRMODE_EXCEPTION

   作 为设置错误代号的附件，PDO会抛出一个PDOException异常并设置它的属性来反映错误代号和错误信息。这中设置在除错时也是很有用的， 因为他会有效的“放大（blow up）”脚本中的出错点，非常快速的指向一个你代码中可能出错区域。（记住：如果异常导致脚本中断，事务处理回自动回滚。）

   异常模式也是非常有用的，因为你可以使用比以前那种使用传统的PHP风格的错误处理结构更清晰的结构处理错误，比使用安静模式使用更少的代码及嵌套，也能够更加明确地检查每个数据库访问的返回值。

   关于PHP中异常的更多信息请看Exceptions章节

PDO 使用基于SQL-92 SQLSTATE 的错误代号字符串；特定的PDO驱动应当将自己本身的代号对应到适当的SQLSTATE代号上。PDO->errorCode() 方法只返回单一的SQLSTATE代号。如果你需要关于一个错误的更加有针对性的信息，PDO也提供了一个PDO->errorInfo() 方法，它可以返回一个包含了SQLSTATE代号，特定数据库驱动的错误代号和特定数据库驱动的错误说明字符串。

事务

现在你已经通过PDO建立了连接，在部署查询之前你必须搞明白PDO是怎样管理事务的。如果你以前从未遇到过事务处理，（现在简单介绍一下：）它们提供了4个主要的特性：原子性 ，一致性 ，独立性 和持久性 （Atomicity, Consistency, Isolation and Durability，ACID）通俗一点讲，一个事务中所有的工作在提交时，即使它是分阶段执行的，也要保证安全地应用于数据库，不被其他的连接干扰。 事务工作也可以在请求发生错误时轻松地自动取消。

事务的典型运用就是通过把批量的改变“保存起来”然后立即执行。这样就会有彻底地提高更新效率的好处。换句话说，事务可以使你的脚本更快速同时可能更健壮（要实现这个优点你仍然需要正确的使用它们）。

 

不 幸运的是，并不是每个数据库都支持事务，因此PDO需要在建立连接时运行在被认为是“自动提交”的模式下。自动提交模式意味着你执行的每个查询都 有它自己隐含的事务处理，无论数据库支持事务还是因数据库不支持而不存在事务。如果你需要一个事务，你必须使用 PDO->beginTransaction() 方法创建一个。如果底层驱动不支持事务处理，一个PDOException就会被抛出（与你的异常处理设置无关，因为这总是一个严重的错误状态）。在一个 事物中，你可以使用 PDO->commit() 或 PDO->rollBack() 结束它，这取决于事务中代码运行是否成功。

当脚本结束时或一个连接要关闭时，如果你还有一个未处理完的事务，PDO将会自动将其回滚。这是对于脚本意外终止的情况来说是一个安全的方案——如果你没有明确地提交事务，它将会假设发生了一些错误，为了你数据的安全，所以就执行回滚了。

警告
自动回滚仅发生于你通过 PDO->beginTransaction() 建立的事务。如果你用手动方式执行了一个开始事务的查询，PDO就无法知道它的情况，这样在倒霉的事情发生时它将无法回滚。

  在下面的例子中，让我们假设我们正在创建一个新员工的一系列资 料，他被指定了一个 23 的ID，同时作为他的基本数据，我们也需要记录他的薪水。执行两个分开的更新操作非常简单，但通过使 用 PDO->beginTransaction() 和 PDO->commit() 围绕后调用，我们就可以保证在两个操作完成之前任何 人都无法看到这些改变。如果发生了什么错误，catch块就会将从事务开始后执行的所有改变回滚，然后打印一条错误信息。

try {
  $dbh  =  new  PDO( 'odbc:SAMPLE' ,  'db2inst1' ,  'ibmdb2' ,
  array (PDO::ATTR_PERSISTENT => true));
  echo   "Connected\n" ;
  $dbh ->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
  $dbh ->beginTransaction();
  $dbh -> exec ( "insert into staff (id, first, last) values(23, 'Joe', 'Bloggs')" );
  $dbh -> exec ("insert into salarychange (id, amount, changedate)
    values (23, 50000, NOW())");
  $dbh ->commit();
} catch (Exception  $e ) {
  $dbh ->rollBack();
  echo   "Failed: "  .  $e ->getMessage();
}

 

数据库连接

事务中执行的更新数并不受限；你可以执行复杂查询获取数据，如果可能的话也可以用获取的数据构建更多的更新和查询；当事务处于激活状态时，你将被保证在你 （操作数据库的）工作中没有人可以执行其他的改变。事实上，这也不是100%正确，但如果你从未听说过事务处理，这已经是一个足够好的介绍了。

连接是通过实例化PDO基类建立的。对建立连接来说，你使用哪个数据库驱动并没有关系，你只管用PDO这个类名就行了。PDO类的构造器接受一个可以指定数据源（DNS）的参数和可选的数据库用户名、密码参数。

例1：连接到MySQL：

1. $dbh  =  new  PDO( 'mysql:host=localhost;dbname=test' ,  $user ,  $pass );

如果发生了错误，一个PDOException异常对象将被抛出。如果你想处理这个错误，你应该捕获这个异常，或者你也可以选择将它交给一个通过set_exception_handler()设置的应用程序全局异常处理器。

例2：连接错误处理

try {
  $dbh  =  new  PDO( 'mysql:host=localhost;dbname=test' ,  $user ,  $pass );
  foreach  ( $dbh ->query( 'SELECT * from FOO' )  as   $row ) {
    print_r( $row );
  }
  $dbh  = null;
} catch (PDOException  $e ) {
  print  "Error!: "  .  $e ->getMessage() .  "" ;
  die ();
} 

警告：
如果你的应用程序没有捕获从PDO构造器中抛出的异 常，Zend引擎就会做出响应终端脚本的执行并显示一条跟踪信息。这条跟踪信息有可能会暴露完整的数据库连接信息，包括用户名和密码。捕获这个异常是你的 职责，无论是明确捕获（通过一个catch语句）还是通过set_exception_handler()隐含捕获。

成 功建立数据库连接之后，一个PDO类的实例就返回到了你的脚本中。连接在PDO对象的生存期内会一直保持活动状态。要关闭这个连接，你需要通过删 除所有指向它的引用来销毁这个对象。你可以通过向指向这个对象的变量赋一个NULL值做到这一点。如果你没有明确地这样做，PHP会在脚本结束时自动关闭 这个连接。

//关闭连接：
$dbh  =  new  PDO( 'mysql:host=localhost;dbname=test' ,  $user ,  $pass );
// use the connection here
// do something.
// and now we're done; close it
$dbh  = null;

 

许 多Web应用会因为使用了向数据库的持久连接而得到优化。持久连接不会在脚本结束时关闭，相反它会被缓存起 来并在另一个脚本通过同样的标识请求一个连接时得以重新利用。持久连接的缓存可以使你避免在脚本每次需要与数据库对话时都要部署一个新的连接的资源消耗， 让你的Web应用更加快速。

 

//持久连接
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass,
 array(    PDO::ATTR_PERSISTENT => true;));