首页 > 代码库 > PHP PDO函数库具体解释
PHP PDO函数库具体解释
文章来源:PHP开发学习门户
地址:http://www.phpthinking.com/archives/565
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() — Bind a column to a PHP variable
PDOStatement->bindParam() — Binds a parameter to the specified variable name
PDOStatement->bindValue() — Binds a value to a parameter
PDOStatement->closeCursor() — Closes the cursor, enabling the statement to be executed again.
PDOStatement->columnCount() — Returns the number of columns in the result set
PDOStatement->errorCode() — Fetch the SQLSTATE associated with the last operation on the statement handle
PDOStatement->errorInfo() — Fetch extended error information associated with the last operation on the statement handle
PDOStatement->execute() — Executes a prepared statement
PDOStatement->fetch() — Fetches the next row from a result set
PDOStatement->fetchAll() — Returns an array containing all of the result set rows
PDOStatement->fetchColumn() — Returns a single column from the next row of a result set
PDOStatement->fetchObject() — Fetches the next row and returns it as an object.
PDOStatement->getAttribute() — Retrieve a statement attribute
PDOStatement->getColumnMeta() — Returns metadata for a column in a result set
PDOStatement->nextRowset() — Advances to the next rowset in a multi-rowset statement handle
PDOStatement->rowCount() — Returns the number of rows affected by the last SQL statement
PDOStatement->setAttribute() — Set a statement attribute
PDOStatement->setFetchMode() — Set the default fetch mode for this statement
PDO是一个“数据库訪问抽象层”,作用是统一各种数据库的訪问接口,与mysql和mysqli的函数库相比,PDO让跨数据库的使用更具有亲和 力;与ADODB和MDB2相比,PDO更高效。眼下而言,实现“数据库抽象层”任重而道远,使用PDO这种“数据库訪问抽象层”是一个不错的选择。
PDO中包括三个提前定义的类
PDO中包括三个提前定义的类,它们各自是 PDO、PDOStatement 和 PDOException。
一、PDO
PDO->beginTransaction() — 标明回滚起始点
PDO->commit() — 标明回滚结束点,并运行SQL
PDO->rollBack() — 运行回滚
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->setAttribute() — 为一个“数据库连接对象”设定属性
具体解释1) PDO中的数据库连接
$dsn = ‘mysql:dbname=ent;host=127.0.0.1′;
$user = ‘root’;
$password = ‘123456′;
try {
$dbh = new PDO($dsn, $user, $password, array(PDO::ATTR_PERSISTENT => true));
$dbh->query(‘set names utf8;’);
foreach ($dbh->query(‘SELECT * from tpm_juese’) as $row) {
print_r($row);
}
} catch (PDOException $e) {
echo ‘Connection failed: ‘ . $e->getMessage();
}
很多Web应用会由于使用了向数据库的持久连接而得到优化。持久连接不会在脚本结束时关闭,
相反它会被缓存起来并在还有一个脚本通过相同的标识请求一个连接时得以又一次利用。
持久连接的缓存能够使你避免在脚本每次须要与数据库对话时都要部署一个新的连接的资源消耗,让你的Web应用更加高速。
上面实例中的array(PDO::ATTR_PERSISTENT => true)就是把连接类型设置为持久连接。
具体解释2) PDO中的事务
PDO->beginTransaction()方法标明起始点,PDO->commit()方法标明回滚结束点,并运行SQL,PDO->rollBack()运行回滚。
<?php
try {
$dbh = new PDO(‘mysql:host=localhost;dbname=test’, ‘root’, ”);
$dbh->query(‘set names utf8;’);
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$dbh->beginTransaction();
$dbh->exec(”INSERT INTO `test`.`table` (`name` ,`age`)VALUES (‘mick’, 22);”);
$dbh->exec(”INSERT INTO `test`.`table` (`name` ,`age`)VALUES (‘lily’, 29);”);
$dbh->exec(”INSERT INTO `test`.`table` (`name` ,`age`)VALUES (‘susan’, 21);”);
$dbh->commit();
} catch (Exception $e) {
$dbh->rollBack();
echo “Failed: ” . $e->getMessage();
}
?>
现 在你已经通过PDO建立了连接,在部署查询之前你必须搞明确PDO是如何管理事务的。假设你曾经从未遇到过事务处理,(如今简介一下:)它们提供了4 个基本的特性:原子性,一致性,独立性和持久性(Atomicity, Consistency, Isolation and Durability,ACID)通俗一点讲,一个事务中全部的工作在提交时,即使它是分阶段运行的,也要保证安全地应用于数据库,不被其它的连接干扰。 事务工作也能够在请求错误发生时轻松地自己主动取消。
事务的典型运用就是通过把批量的改变“保存起来”然后马上运行。这样就会有彻底地提高更新效率的优点。换句话说,事务能够使你的脚本更高速同一时候可能更健壮(要实现这个优点你仍然须要正确的使用它们)。
不幸运的是,并非每一个数据库都支持事务,因此PDO须要在建立连接时执行在被觉得是“自己主动提交”的模式下。自己主动提交模式意味着你执行的每一个查询都 有它自己隐含的事务处理,不管数据库支持事务还是因数据库不支持而不存在事务。假设你须要一个事务,你必须使用 PDO->beginTransaction() 方法创建一个。假设底层驱动不支持事务处理,一个PDOException就会被抛出(与你的异常处理设置无关,由于这总是一个严重的错误状态)。在一个 事物中,你能够使用 PDO->commit() 或 PDO->rollBack() 结束它,这取决于事务中代码执行是否成功。
当脚本结束时或一个连接要关闭时,假设你另一个未处理完的事务,PDO将会自己主动将其回滚。这是对于脚本意外终止的情况来说是一个安全的方案——假设你没有明白地提交事务,它将会假设发生了一些错误,为了你数据的安全,所以就运行回滚了。
二、PDOStatement
PDOStatement->bindColumn() — Bind a column to a PHP variable
PDOStatement->bindParam() — Binds a parameter to the specified variable name
PDOStatement->bindValue() — Binds a value to a parameter
PDOStatement->closeCursor() — Closes the cursor, enabling the statement to be executed again.
PDOStatement->columnCount() — Returns the number of columns in the result set
PDOStatement->errorCode() — Fetch the SQLSTATE associated with the last operation on the statement handle
PDOStatement->errorInfo() — Fetch extended error information associated with the last operation on the statement handle
PDOStatement->execute() — Executes a prepared statement
PDOStatement->fetch() — Fetches the next row from a result set
PDOStatement->fetchAll() — Returns an array containing all of the result set rows
PDOStatement->fetchColumn() — Returns a single column from the next row of a result set
PDOStatement->fetchObject() — Fetches the next row and returns it as an object.
PDOStatement->getAttribute() — Retrieve a statement attribute
PDOStatement->getColumnMeta() — Returns metadata for a column in a result set
PDOStatement->nextRowset() — Advances to the next rowset in a multi-rowset statement handle
PDOStatement->rowCount() — Returns the number of rows affected by the last SQL statement
PDOStatement->setAttribute() — Set a statement attribute
PDOStatement->setFetchMode() — Set the default fetch mode for this statement
三、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异常并设置它的属性来反映错误代号和错误信息。这中设置在除错时也是非常实用的,由于他会 有效的“放大(blow up)”脚本中的出错点,非常高速的指向一个你代码中可能出错区域。(记住:假设异常导致脚本中断,事务处理回自己主动回滚。)
异常模式也是很实用的,由于你可以使用比曾经那种使用传统的PHP风格的错误处理结构更清晰的结构处理错误,比使用安静模式使用更少的代码及嵌套,也可以更加明白地检查每一个数据库訪问的返回值。
关于PHP中异常的很多其它信息请看Exceptions章节
PDO 使用基于SQL-92 SQLSTATE 的错误代号字符串;特定的PDO驱动应当将自己本身的代号相应到适当的SQLSTATE代号上。PDO->errorCode() 方法仅仅返回单一的SQLSTATE代号。假设你须要关于一个错误的更加有针对性的信息,PDO也提供了一个PDO->errorInfo()方法, 它能够返回一个包括了SQLSTATE代号,特定数据库驱动的错误代号和特定数据库驱动的错误说明字符串。
// 改动默认的错误显示级别
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);
?>
属性列表:
表示一个布尔类型
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
Specifies that the parameter is an INOUT parameter for a stored procedure. You must bitwise-OR this value with anexplicit PDO::PARAM_* data type.
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
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连接的server端数据库版本号
PDO::ATTR_CLIENT_VERSION
仅仅读属性,表示PDO连接的clientPDO驱动版本号
PDO::ATTR_SERVER_INFO
仅仅读属性,表示PDO连接的server的meta信息
PDO::ATTR_CONNECTION_STATUS
PDO::ATTR_CASE
通过PDO::CASE_