just do it

php 数据库扩展PDO 简单使用

PDO(PHP Data Object) 是PHP 5新出来的东西,将来PHP 6只默认使用PDO来处理数据库,将把所有的数据库扩展移到了PECL,默认就是没有php_mysql.dll之类的了。
【PDO是啥】

PDO是PHP 5新加入的一个重大功能,因为在PHP 5以前的php4/php3都是一堆的数据库扩展来跟各个数据库的连接和处理,什么php_mysql.dll、php_pgsql.dll、php_mssql.dll、php_sqlite.dll等等扩展来连接MySQL、PostgreSQL、MS SQL Server、SQLite,同样的,我们必须借助 ADOdb、PEAR::DB、PHPlib::DB之类的数据库抽象类来帮助我们,无比烦琐和低效,毕竟,php代码的效率怎么能够我们直接用C/C++写的扩展斜率高呢?所以嘛,PDO的出现是必然的,大家要平静学习的心态去接受使用,也许你会发现能够减少你不少功夫哦。

 

【安装PDO】

我是在Windows XP SP2 上面,所以嘛,整个过程都是在Windows行进行的啦,至于Linux/FreeBSD 等平台,请自行查找资料设置安装。
我的是PHP 5.1.4,已经自带有了php_pdo.dll的扩展,不过需要稍微设置一下才能使用。

打开 c:\windows\php.ini ,那是我的PHP配置文件,找到下面这行:
extension_dir
这个就是我们扩展存在的目录,我的PHP 5扩展是在:C:\php5\ext,那么我就把这行改成:

extension_dir = “C:/php5/ext”

然后再往php.ini下面找到:

;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;

下面有一堆类似 ;extension=php_mbstring.dll 的东西,这里就是PHP扩展加载的配置了,我们再最后面添加上我们PDO的扩展:

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

各种PDO的驱动,能给加上的全给加上,不过后面的php_pdo_oci8.dll,因为我没有安装Oralce数据库,所以没有这个,就使用分号注释掉它。然后重启我们的Web服务器, IIS/Apache,我的是IIS,嘿嘿,表鄙视我,在Windows上,简单嘛。
重启后,在我们Web服务器的文档目录下写一个phpinfo.php的文件,加上这些:

<?
phpinfo();
?>

然后打开我们可爱的浏览器:IE/FireFox,我的是FireFox 2.0,刚下载的,很爽,不怕流氓软件,哈哈。
在浏览器里面输入:http://localhost/phpinfo.php,如果你的这个页面路径不一致,请自行输入。
输出的内容中,如果你能够顺利的看到:

《php 数据库扩展PDO 简单使用》PDO
《php 数据库扩展PDO 简单使用》PDO support enabled
《php 数据库扩展PDO 简单使用》PDO drivers  mysql, pgsql, sqlite, mssql, odbc, firebird

后面有各种驱动的说明,
PDO_Firebird,pdo_mssql,pdo_mysql,PDO_ODBC,pdo_pgsql,pdo_sqlite

 

那么,恭喜你安装成功了,否则请仔细检查上面的步骤。

 

【牛刀小小试验】

我用的是MySQL 4.0.26,但是我个人推荐大家使用 MySQL 4.1.x 或者 MySQL 5.0.x,因为那些版本有很多有趣的东西值得去学习。我们这里PDO需要连接的就是我的MySQL 4.0啦,如果你没有安装MySQL,请自行安装。我们建立好了MySQL,并且在test库里添加了表foo,包括 id,name,gender,time等四个字段。

我们开始构造第一个PDO应用,建立一个pdo.php文件在Web文档目录下:

 

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》$dsn = “mysql:host=localhost;dbname=test”;
《php 数据库扩展PDO 简单使用》$db = new PDO($dsn, ‘root’, ”);
《php 数据库扩展PDO 简单使用》$count = $db->exec(“INSERT INTO foo SET name = ‘heiyeluren’,gender=’男’,time=NOW()”);
《php 数据库扩展PDO 简单使用》echo $count;
《php 数据库扩展PDO 简单使用》$db = null;
《php 数据库扩展PDO 简单使用》?>

 

 

不明白啥意思,俺们来慢慢讲讲。这行:
$dsn = “mysql:host=localhost;dbname=test”;
就是构造我们的DSN(数据源),看看里面的信息包括:数据库类型是mysql,主机地址是localhost,数据库名称是test,就这么几个信息。不同数据库的数据源构造方式是不一样的。

$db = new PDO($dsn, ‘root’, ”);
初始化一个PDO对象,构造函数的参数第一个就是我们的数据源,第二个是连接数据库服务器的用户,第三个参数是密码。我们不能保证连接成功,后面我们会讲到异常情况,这里我们姑且认为它是连接成功的。

$count = $db->exec(“INSERT INTO foo SET name = ‘heiyeluren’,gender=’男’,time=NOW()”);
echo $count;
调用我们连接成功的PDO对象来执行一个查询,这个查询是一个插入一条记录的操作,使用PDO::exec() 方法会返回一个影响记录的结果,所以我们输出这个结果。最后还是需要结束对象资源:
$db = null;

默认这个不是长连接,如果需要数据库长连接,需要最后加一个参数:array(PDO::ATTR_PERSISTENT => true) 变成这样:
$db = new PDO($dsn, ‘root’, ”, array(PDO::ATTR_PERSISTENT => true));

一次操作就这么简单,也许跟以前的没有太大区别,跟ADOdb倒是有几分相似。

 

【继续了解】

如果我们想提取数据的话,那么就应该使用数据获取功能。(下面用到的$db都是上面已经连接好的对象)

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》foreach($db->query(“SELECT * FROM foo”)){
《php 数据库扩展PDO 简单使用》    print_r($row);
《php 数据库扩展PDO 简单使用》}
《php 数据库扩展PDO 简单使用》?>

我们也可以使用这种获取方式:

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》$rs = $db->query(“SELECT * FROM foo”);
《php 数据库扩展PDO 简单使用》while($row = $rs->fetch()){
《php 数据库扩展PDO 简单使用》    print_r($row);
《php 数据库扩展PDO 简单使用》}
《php 数据库扩展PDO 简单使用》?>

如果想一次把数据都获取到数组里可以这样:

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》$rs = $db->query(“SELECT * FROM foo”);
《php 数据库扩展PDO 简单使用》$result_arr = $rs->fetchAll();
《php 数据库扩展PDO 简单使用》print_r($result_arr);
《php 数据库扩展PDO 简单使用》?>

 

输出:

 

《php 数据库扩展PDO 简单使用》Array
《php 数据库扩展PDO 简单使用》(
《php 数据库扩展PDO 简单使用》    [0] => Array
《php 数据库扩展PDO 简单使用》        (
《php 数据库扩展PDO 简单使用》            [id] => 1
《php 数据库扩展PDO 简单使用》            [0] => 1
《php 数据库扩展PDO 简单使用》            [name] => heiyeluren
《php 数据库扩展PDO 简单使用》            [1] => heiyeluren
《php 数据库扩展PDO 简单使用》            [gender] => 男
《php 数据库扩展PDO 简单使用》            [2] => 男
《php 数据库扩展PDO 简单使用》            [time] => 2006-10-28 23:14:23
《php 数据库扩展PDO 简单使用》            [3] => 2006-10-28 23:14:23
《php 数据库扩展PDO 简单使用》        )
《php 数据库扩展PDO 简单使用》}

我们看里面的记录,数字索引和关联索引都有,浪费资源,我们只需要关联索引的:

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》$db->setAttribute(PDO::ATTR_CASE, PDO::CASE_UPPER);
《php 数据库扩展PDO 简单使用》$rs = $db->query(“SELECT * FROM foo”);
《php 数据库扩展PDO 简单使用》$rs->setFetchMode(PDO::FETCH_ASSOC);
《php 数据库扩展PDO 简单使用》$result_arr = $rs->fetchAll();
《php 数据库扩展PDO 简单使用》print_r($result_arr);
《php 数据库扩展PDO 简单使用》?>

看上面的代码,setAttribute() 方法是设置部分属性,主要属性有:PDO::ATTR_CASE、PDO::ATTR_ERRMODE等等,我们这里需要设置的是PDO::ATTR_CASE,就是我们使用关联索引获取数据集的时候,关联索引是大写还是小写,有几个选择:

PDO::CASE_LOWER — 强制列名是小写
PDO::CASE_NATURAL — 列名按照原始的方式
PDO::CASE_UPPER — 强制列名为大写

 

我们使用setFetchMode方法来设置获取结果集的返回值的类型,同样类型还有:

PDO::FETCH_ASSOC — 关联数组形式
PDO::FETCH_NUM — 数字索引数组形式
PDO::FETCH_BOTH — 两者数组形式都有,这是缺省的
PDO::FETCH_OBJ — 按照对象的形式,类似于以前的 mysql_fetch_object()

当然,一般情况下我们是使用PDO::FETCH_ASSOC,具体使用什么,按照你自己的需要,其他获取类型参考手册。
除了上面这种获取数据的方式,还有这种:

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》$rs = $db->prepare(“SELECT * FROM foo”);
《php 数据库扩展PDO 简单使用》$rs->execute();
《php 数据库扩展PDO 简单使用》while($row = $rs->fetch()){
《php 数据库扩展PDO 简单使用》    print_r($row);
《php 数据库扩展PDO 简单使用》}
《php 数据库扩展PDO 简单使用》?>

其实差不多啦。如果你想获取指定记录里一个字段结果的话,可以使用 PDOStatement::fetchColumn():

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》$rs = $db->query(“SELECT COUNT(*) FROM foo”);
《php 数据库扩展PDO 简单使用》$col = $rs->fetchColumn();
《php 数据库扩展PDO 简单使用》echo $col;
《php 数据库扩展PDO 简单使用》?>

使用fetchColumn()来进行count统计或者某些只需要单字段的记录很好操作。

 

PDO中没有类似于mysql_num_rows这样的函数用于计算返回结果集的数目,不过在SQL语句中使用 count(*)。
然后通过PDO获取其行数。考虑到效率可以先fetchAll(),然后直接用PHP的函数count()来计算查询结果集转换为数组后的单元数,
在大多数应用中(尤其是使用模板引擎时),fetchAll 方法简单且高效。
简单的总结一下上面的操作:

查询操作主要是PDO::query()、PDO::exec()、PDO::prepare()。PDO::query()主要是用于有记录结果返回的操作,特别是SELECT操作,PDO::exec()主要是针对没有结果集合返回的操作,比如INSERT、UPDATE、DELETE等操作,它返回的结果是当前操作影响的列数。PDO::prepare()主要是预处理操作,需要通过$rs->execute()来执行预处理里面的SQL语句,这个方法可以绑定参数,功能比较强大,不是本文能够简单说明白的,大家可以参考手册和其他文档。

获取结果集操作主要是:PDOStatement::fetchColumn()、PDOStatement::fetch()、PDOStatement::fetchALL()。PDOStatement::fetchColumn() 是获取结果指定第一条记录的某个字段,缺省是第一个字段。PDOStatement::fetch() 是用来获取一条记录,PDOStatement::fetchAll()是获取所有记录集到一个中,获取结果可以通过PDOStatement::setFetchMode来设置需要结果集合的类型。

另外有两个周边的操作,一个是PDO::lastInsertId()和PDOStatement::rowCount()。PDO::lastInsertId()是返回上次插入操作,主键列类型是自增的最后的自增ID。PDOStatement::rowCount()主要是用于PDO::query()和PDO::prepare()进行DELETE、INSERT、UPDATE操作影响的结果集,对PDO::exec()方法和SELECT操作无效。

 

【错误处理】

如果程序中碰到错误咋办?我们这里描述PDO类的错误信息和异常处理。

1. 面向对象的方式

先看看如果连接错误等的处理,使用面向对象的方式来处理:

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》try {
《php 数据库扩展PDO 简单使用》   $db = new PDO(‘mysql:host=localhost;dbname=test’, $user, $pass);
《php 数据库扩展PDO 简单使用》   $db = null;
《php 数据库扩展PDO 简单使用》} catch (PDOException $e) {
《php 数据库扩展PDO 简单使用》   print “Error: ” . $e->getMessage() . “<br/>”;
《php 数据库扩展PDO 简单使用》   die();
《php 数据库扩展PDO 简单使用》}
《php 数据库扩展PDO 简单使用》?>

 

 

这里利用我们PHP 5面向对象的异常处理特征,如果里面有异常的话就初始化调用PDOException来初始化一个异常类。
PDOException异常类的属性结构:

 

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》class PDOException extends Exception
《php 数据库扩展PDO 简单使用》{
《php 数据库扩展PDO 简单使用》    public $errorInfo = null;  // 错误信息,可以调用 PDO::errorInfo() 或 PDOStatement::errorInfo()来访问
《php 数据库扩展PDO 简单使用》    protected $message;    // 异常信息,可以试用 Exception::getMessage() 来访问
《php 数据库扩展PDO 简单使用》    protected $code;             // SQL状态错误代码,可以使用 Exception::getCode() 来访问
《php 数据库扩展PDO 简单使用》}
《php 数据库扩展PDO 简单使用》?>

 

 

这个异常处理类是集成PHP 5内置的异常处理类,我们简单的看一下PHP 5内置的异常处理类结构:

《php 数据库扩展PDO 简单使用》<?php
《php 数据库扩展PDO 简单使用》class Exception
《php 数据库扩展PDO 简单使用》{
《php 数据库扩展PDO 简单使用》    // 属性
《php 数据库扩展PDO 简单使用》    protected $message = ‘Unknown exception’;   // 异常信息
《php 数据库扩展PDO 简单使用》    protected $code = 0;                        // 用户自定义异常代码
《php 数据库扩展PDO 简单使用》    protected $file;                            // 发生异常的文件名
《php 数据库扩展PDO 简单使用》    protected $line;                            // 发生异常的代码行号
《php 数据库扩展PDO 简单使用》
《php 数据库扩展PDO 简单使用》    // 方法
《php 数据库扩展PDO 简单使用》    final function getMessage();                // 返回异常信息
《php 数据库扩展PDO 简单使用》    final function getCode();                   // 返回异常代码
《php 数据库扩展PDO 简单使用》    final function getFile();                   // 返回发生异常的文件名
《php 数据库扩展PDO 简单使用》    final function getLine();                   // 返回发生异常的代码行号
《php 数据库扩展PDO 简单使用》    final function getTrace();                  // backtrace() 数组
《php 数据库扩展PDO 简单使用》    final function getTraceAsString();          // 已格成化成字符串的 getTrace() 信息
《php 数据库扩展PDO 简单使用》}
《php 数据库扩展PDO 简单使用》?>
《php 数据库扩展PDO 简单使用》

 

 

相应的,在代码中可以合适的调用 getFile() 和 getLine() 来进行错误定位,更方便的进行调试。
2. 使用面向过程的方法
先看代码:

《php 数据库扩展PDO 简单使用》<?
《php 数据库扩展PDO 简单使用》$db = new PDO(‘mysql:host=localhost;dbname=test’, $user, $pass);
《php 数据库扩展PDO 简单使用》$rs = $db->query(“SELECT aa,bb,cc FROM foo”);
《php 数据库扩展PDO 简单使用》if ($db->errorCode() != ‘00000’){
《php 数据库扩展PDO 简单使用》    print_r($db->errorInfo());
《php 数据库扩展PDO 简单使用》    exit;
《php 数据库扩展PDO 简单使用》}
《php 数据库扩展PDO 简单使用》$arr = $rs->fetchAll();
《php 数据库扩展PDO 简单使用》print_r($arr);
《php 数据库扩展PDO 简单使用》$db = null;
《php 数据库扩展PDO 简单使用》?>

PDO和PDOStatement对象有errorCode() 和 errorInfo() 方法,如果没有任何错误, errorCode() 返回的是: 00000 ,否则就会返回一些错误代码。errorInfo() 返回的一个数组,包括PHP定义的错误代码和MySQL的错误代码和错误信息,数组结构如下:

《php 数据库扩展PDO 简单使用》Array
《php 数据库扩展PDO 简单使用》(
《php 数据库扩展PDO 简单使用》    [0] => 42S22
《php 数据库扩展PDO 简单使用》    [1] => 1054
《php 数据库扩展PDO 简单使用》    [2] => Unknown column ‘aaa’ in ‘field list’
《php 数据库扩展PDO 简单使用》)

 

每次执行查询以后,errorCode() 的结果都是最新的,所以我们可以很容易自己控制错误信息显示。

 

【简单总结】

从上面的使用看出,PDO功能确实强大,另外还有一些内容没有讲到,比如绑定参数、预处理、存储过程、事务处理等等功能。另外还有不同数据扩 DSN的构造,Oracle数据库自己很多特殊的东西,都需要深入去学习理解,这篇文章就只是简单的描述了一些入门知识,算是对PDO一个简单的了解吧。

【待续。。。】

点赞