PHP中的PDO函數庫(PDO Functions)

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:ARAM
* 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();
}
?>