PHP 中 PDO 数据库抽象层函数库详解

Question

PDO 是一个数据库访问抽象层，作用是统一各种数据库的访问接口，与 MySQL 和 MySQL 的函数库相比，PDO 让跨数据库的使用更具有亲和力，与 ADODB 和 MDB2 相比，PDO 更加高效。

目前而言，实现数据库抽象层任重而道远，使用 PDO 这样的数据库访问抽象层是一个不错的选择。

PDO 中包含三个预定义的类，它们分别是 PDO、PDOStatement 和 PDOException。

PDO 类

• PDO->beginTransaction() — 标明回滚起始点
• PDO->commit() — 标明回滚结束点，并执行SQL
• PDO->__construct() — 建立一个PDO链接数据库的实例
• PDO->errorCode() — 获取错误码
• PDO->errorInfo() — 获取错误的信息
• PDO->exec() — 处理一条SQL语句，并返回所影响的条目数
• PDO->getAttribute() — 获取一个“数据库连接对象”的属性
• PDO->getAvailableDrivers() — 获取有效的PDO驱动器名称
• PDO->lastInsertId() — 获取写入的最后一条数据的主键值
• PDO->prepare() — 生成一个“查询对象”
• PDO->query() — 处理一条SQL语句，并返回一个“PDOStatement”
• PDO->quote() — 为某个SQL中的字符串添加引号
• PDO->rollBack() — 执行回滚
• PDO->setAttribute() — 为一个“数据库连接对象”设定属性

PDOStatement 类

• PDOStatement->bindColumn() — 绑定列一个PHP变量
• PDOStatement->bindParam() — 绑定参数指定的变量名
• PDOStatement->bindValue() — 绑定一个值参数
• PDOStatement->closeCursor() — 关闭游标，使要执行的语句一次。
• PDOStatement->columnCount() — 返回结果集的列数
• PDOStatement->errorCode() — 取SQLSTATE与过去的操作语句句柄
• PDOStatement->errorInfo() — 取扩展错误信息与过去的操作语句句柄
• PDOStatement->execute() — 执行一个准备好的声明
• PDOStatement->fetch() — 读取下一行的结果集
• PDOStatement->fetchAll() — 返回一个数组，包含所有的结果集行
• PDOStatement->fetchColumn() — 返回一列从下一行的结果集
• PDOStatement->fetchObject() — 读取下一行并将它作为一个对象。
• PDOStatement->getAttribute() — 检索表属性
• PDOStatement->getColumnMeta() — 返回元数据中某一列的结果集
• PDOStatement->nextRowset() — 进展在多行集的行集的下一个语句句柄
• PDOStatement->rowCount() —返回受影响的行数由过去的SQL语句
• PDOStatement->setAttribute() — 设定一个声明属性
• PDOStatement->setFetchMode() — 设置默认读取模式这一说法

PDOException 类

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

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

PDO 使用基于 SQL-92 SQLSTATE 的错误代号字符串，特定的 PDO 驱动应当将自己本身的代号对应到适当的 SQLSTATE 代号上。

PDO->errorCode() 方法只返回单一的 SQLSTATE 代号。如果你需要关于一个错误的更加有针对性的信息，PDO 也提供了一个 PDO->errorInfo() 方法， 它可以返回一个包含了SQLSTATE 代号，特定数据库驱动的错误代号和特定数据库驱动的错误说明字符串。

// 修改默认的错误显示级别
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);

4、属性列表：

PDO::PARAM_BOOL：表示一个布尔类型
PDO::PARAM_NULL：表示一个SQL中的NULL类型
PDO::PARAM_INT：表示一个SQL中的INTEGER类型
PDO::PARAM_STR：表示一个SQL中的SQL CHAR，VARCHAR类型
PDO::PARAM_LOB：表示一个SQL中的large object类型
PDO::PARAM_STMT：表示一个SQL中的recordset类型，还没有被支持
PDO::PARAM_INPUT_OUTPUT：指定该参数是一个INOUT参数的存储过程。你必须按位或该值与一个明确的PDO：：param_ *数据类型。
PDO::FETCH_LAZY：将每一行结果作为一个对象返回
PDO::FETCH_ASSOC：仅仅返回以键值作为下标的查询的结果集，名称相同的数据只返回一个
PDO::FETCH_NAMED：仅仅返回以键值作为下标的查询的结果集，名称相同的数据以数组形式返回
PDO::FETCH_NUM：仅仅返回以数字作为下标的查询的结果集
PDO::FETCH_BOTH：同时返回以键值和数字作为下标的查询的结果集
PDO::FETCH_OBJ：以对象的形式返回结果集
PDO::FETCH_BOUND：将PDOStatement::bindParam()和PDOStatement::bindColumn()所绑定的值作为变量名赋值后返回
PDO::FETCH_COLUMN：表示仅仅返回结果集中的某一列
PDO::FETCH_CLASS：表示以类的形式返回结果集
PDO::FETCH_INTO：表示将数据合并入一个存在的类中进行返回
PDO::FETCH_FUNC
PDO::FETCH_GROUP
PDO::FETCH_UNIQUE
PDO::FETCH_KEY_PAIR：以首个键值下表，后面数字下表的形式返回结果集
PDO::FETCH_CLASSTYPE
PDO::FETCH_SERIALIZE：表示将数据合并入一个存在的类中并序列化返回
PDO::FETCH_PROPS_LATE

5、Available since PHP 5.2.0

PDO::ATTR_AUTOCOMMIT：在设置成true的时候，PDO会自动尝试停止接受委托，开始执行
PDO::ATTR_PREFETCH：设置应用程序提前获取的数据大小，并非所有的数据库哦度支持
PDO::ATTR_TIMEOUT：设置连接数据库超时的值
PDO::ATTR_ERRMODE：设置Error处理的模式
PDO::ATTR_SERVER_VERSION：只读属性，表示PDO连接的服务器端数据库版本
PDO::ATTR_CLIENT_VERSION：只读属性，表示PDO连接的客户端PDO驱动版本
PDO::ATTR_SERVER_INFO：只读属性，表示PDO连接的服务器的meta信息
PDO::ATTR_CONNECTION_STATUS
PDO::ATTR_CASE：通过PDO::CASE_*中的内容对列的形式进行操作
PDO::ATTR_CURSOR_NAME：获取或者设定指针的名称
PDO::ATTR_CURSOR：设置指针的类型，PDO现在支持PDO::CURSOR_FWDONLY和PDO::CURSOR_FWDONLY
PDO::ATTR_DRIVER_NAME：返回使用的PDO驱动的名称
PDO::ATTR_ORACLE_NULLS：将返回的空字符串转换为SQL的NULL
PDO::ATTR_PERSISTENT：获取一个存在的连接
PDO::ATTR_STATEMENT_CLASS
PDO::ATTR_FETCH_CATALOG_NAMES：在返回的结果集中，使用自定义目录名称来代替字段名。
PDO::ATTR_FETCH_TABLE_NAMES：在返回的结果集中，使用自定义表格名称来代替字段名。
PDO::ATTR_STRINGIFY_FETCHES
PDO::ATTR_MAX_COLUMN_LEN
PDO::ATTR_DEFAULT_FETCH_MODE

6、Available since PHP 5.2.0

PDO::ATTR_EMULATE_PREPARES

7、Available since PHP 5.1.3.

PDO::ERRMODE_SILENT：发生错误时不汇报任何的错误信息，是默认值
PDO::ERRMODE_WARNING：发生错误时发出一条php的E_WARNING的信息
PDO::ERRMODE_EXCEPTION：发生错误时抛出一个PDOException
PDO::CASE_NATURAL：回复列的默认显示格式
PDO::CASE_LOWER：强制列的名字小写
PDO::CASE_UPPER：强制列的名字大写
PDO::NULL_NATURAL
PDO::NULL_EMPTY_STRING
PDO::NULL_TO_STRING
PDO::FETCH_ORI_NEXT：获取结果集中的下一行数据，仅在有指针功能时有效
PDO::FETCH_ORI_PRIOR：获取结果集中的上一行数据，仅在有指针功能时有效
PDO::FETCH_ORI_FIRST：获取结果集中的第一行数据，仅在有指针功能时有效
PDO::FETCH_ORI_LAST：获取结果集中的最后一行数据，仅在有指针功能时有效
PDO::FETCH_ORI_ABS：获取结果集中的某一行数据，仅在有指针功能时有效
PDO::FETCH_ORI_REL：获取结果集中当前行后某行的数据，仅在有指针功能时有效
PDO::CURSOR_FWDONLY：建立一个只能向后的指针操作对象
PDO::CURSOR_SCROLL：建立一个指针操作对象，传递PDO::FETCH_ORI_*中的内容来控制结果集
PDO::ERR_NONE (string)：设定没有错误时候的错误信息
PDO::PARAM_EVT_ALLOC：Allocation event
PDO::PARAM_EVT_FREE：Deallocation event
PDO::PARAM_EVT_EXEC_PRE：事件触发语句执行前的准备。
PDO::PARAM_EVT_EXEC_POST：事件触发语句执行后续的制备。
PDO::PARAM_EVT_FETCH_PRE：事件触发从一个ResultSet取结果之前。
PDO::PARAM_EVT_FETCH_POST：事件触发从ResultSet结果随后取。
PDO::PARAM_EVT_NORMALIZE：触发在绑定参数登记允许驾驶员规范参数名称的事件。