-
PHP PDO函数库详解
添加时间:2013-7-12 点击量:PDO是一个“数据库接见抽象层”,感化是同一各类数据库的接见接口,与mysql和mysqli的函数库比拟,PDO让跨数据库的应用更具有亲和力;与ADODB和MDB2比拟,PDO更高效。
原来,再大的房子,再大的床,没有相爱的人陪伴,都只是冰冷的物质。而如果身边有爱人陪伴,即使房子小,床小,也觉得无关紧要,因为这些物质上面有了爱的温度,成了家的元素。—— 何珞《婚房》#书摘#
今朝而言,实现“数据库抽象层”任重而道远,应用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() — 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() — utes a prepared statement
PDOStatement->fetch() — Fetches the next row a result set
PDOStatement->fetchAll() — Returns an array containing all of the result set rows
PDOStatement->fetchColumn() — Returns a single column 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 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(),PDO->rollBack()这三个办法是在支撑回滚功能时一路应用的。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() — utes a prepared statement
PDOStatement->fetch() — Fetches the next row a result set
PDOStatement->fetchAll() — Returns an array containing all of the result set rows
PDOStatement->fetchColumn() — Returns a single column 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代号,特定命据库驱动的错误代号和特定命据库驱动的错误申明字符串。
<?php
// 批改默认的错误显示级别
¥dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);
?>
属性列表:
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
Specifies that the parameter is an INOUT parameter for a stored procedure. You must bitwise-OR this value with an explicit 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连接的办事器端数据库版本
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
Available since PHP 5.2.0
PDO::ATTR_EMULATE_PREPARES
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
Event triggered prior to execution of a prepared statement.
PDO::PARAM_EVT_EXEC_POST
Event triggered subsequent to execution of a prepared statement.
PDO::PARAM_EVT_FETCH_PRE
Event triggered prior to fetching a result a resultset.
PDO::PARAM_EVT_FETCH_POST
Event triggered subsequent to fetching a result a resultset.
PDO::PARAM_EVT_NORMALIZE
Event triggered during bound parameter registration allowing the driver to normalize the parameter name.