2009年3月26日星期四

PDO参数说明

因为自己PHPCORE的核心框架是用PDO进行数据库驱动的,所以,对于它的一些基本配置参数必须有一定的了解,以下是收集到部分内容,供日后参考使用:


(备注:PDO是一个“数据库访问抽象层”,作用是统一各种数据库的访问接口,与mysql和mysqli的函数库相比,PDO让跨数据库的使用更具有亲和力;与ADODB和MDB2相比,PDO更高效。目前而言,实现“数据库抽象层”任重而道远,使用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->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”表示的是一个数据库连接对象(new PDO产生),“PDOStatement”表示的是一个查询对象(PDO->query()产生)或者是一个结果集对象(PDO->prepare()产生)。 
一个“数据库连接对象”的例子,返回“PDO”: 
$dbh = new PDO('mysql:host=localhost;dbname=test', 'root', ''); 
?> 

一个“查询对象”的例子,返回“PDOStatement”: 
$sql = "Insert INTO `test`.`table` (`name` ,`age`)VALUES (?, ?);"; 
$stmt = $dbh->prepare($sql); 
?> 

一个“结果集对象”的例子,返回“PDOStatement”: 
$sql = "Select * FROM `table` Where `name` = 'samon'"; 
$stmt = $dbh->query($sql); 
?> 

在test库里面生成table表,并写入一些数据: 
$dbh = new PDO('mysql:host=localhost;dbname=test', 'root', ''); 
$dbh->query('set names utf8;'); 

$sql = " 
Drop TABLE IF EXISTS `table`; 
Create TABLE `test`.`table` ( 
`id` INT( 10 ) NOT NULL AUTO_INCREMENT PRIMARY KEY, 
`name` VARCHAR( 255 ) NOT NULL , 
`age` VARCHAR( 255 ) NOT NULL 
) ENGINE = InnoDB DEFAULT CHARSET=utf8; 
Insert INTO `test`.`table` (`name` ,`age`)VALUES ('samon', '27'); 
Insert INTO `test`.`table` (`name` ,`age`)VALUES ('leo', '26'); 
Insert INTO `test`.`table` (`name` ,`age`)VALUES ('ben', '28'); 
"; 
$dbh->query($sql); 
?> 

PDO->exec()方法的作用是处理一条SQL语句,并返回所影响的条目数。 

PDO->query()方法的作用是处理一条SQL语句,并返回一个“PDOStatement”。 

PDO->prepare()方法的作用是生成一个“查询对象”。 

PDO->lastInsertId()方法的作用是获取写入的最后一条数据的主键值。 
$dbh = new PDO('mysql:host=localhost;dbname=test', 'root', ''); 
$dbh->query('set names utf8;'); 

$sql = "Insert INTO `test`.`table` (`name` ,`age`)VALUES ('mick', 22);"; 
$dbh->query($sql); 
$lid = $dbh->lastInsertId($sql); 
print_r($lid); // 显示主键的值 
?> 

PDO->quote()方法的作用是为某个SQL中的字符串添加引号。PDO->quote()方法有两个参数,第一个参数是字符串,第二个参数表示参数的类型。 

PDO->getAttribute()方法的作用是获取一个“数据库连接对象”的属性。PDO->setAttribute()方法的作用是为一个“数据库连接对象”设定属性。 
// 修改默认的错误显示级别 
$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 from a resultset. 
PDO::PARAM_EVT_FETCH_POST 
    Event triggered subsequent to fetching a result from a resultset. 
PDO::PARAM_EVT_NORMALIZE 
    Event triggered during bound parameter registration allowing the driver to normalize the parameter name. 

PDO->getAvailableDrivers()方法的作用是获取有效的PDO驱动器名称。 

PDO->errorInfo()方法的作用获取错误的信息,PDO->errorCode()方法的作用是获取错误码。 
$dbh = new PDO('mysql:host=localhost;dbname=test', 'root', ''); 
$dbh->query('set names utf8;'); 
$sql = "Insert INTO `test`.`table` (`name` ,`ageeeeee`)VALUES ('mick', 22);"; 
$dbh->query($sql); 
print_r($dbh->errorInfo()); 
/** 
* Array 
* ( 
*     [0] => 42S22 
*     [1] => 1054 
*     [2] => Unknown column 'ageeeeee' in 'field list' 
* ) 
*/ 
?> 

PDO->__construct()方法的作用是建立一个PDO链接数据库的实例。 

PDO->beginTransaction(),PDO->commit(),PDO->rollBack()这三个方法是在支持回滚功能时一起使用的。PDO->beginTransaction()方法标明起始点,PDO->commit()方法标明回滚结束点,并执行SQL,PDO->rollBack()执行回滚。 
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(); 
?>