PHP中的PDO函数库（PDO Functions）

古城微笑少年丶 2022-08-27 03:21 240阅读 0赞

# #

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”：

<?php   
 $dbh  =  new  PDO ( ' mysql:host=localhost;dbname=test ' ,  ' root ' ,  '' ) ;  
 ?>

一个“查询对象”的例子，返回“PDOStatement”：

<?php   
 $sql  =  " INSERT INTO \`test\`.\`table\` (\`name\` ,\`age\`)VALUES (?, ?); " ;  
 $stmt  =  $dbh \-> prepare ( $sql ) ;  
 ?>

一个“结果集对象”的例子，返回“PDOStatement”：

<?php   
 $sql  =  " SELECT \* FROM \`table\` WHERE \`name\` = 'samon' " ;  
 $stmt  =  $dbh \-> query ( $sql ) ;  
 ?>

在test库里面生成table表，并写入一些数据：

<?php   
 $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()方法的作用是获取写入的最后一条数据的主键值。

<?php   
 $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()方法的作用是为一个“数据库连接对象”设定属性。

<?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  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()方法的作用是获取错误码。

<?php   
 $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()执行回滚。

<?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 () ;  
 \}   
 ?>