PDO(PHP Data Object) 是PHP 5新出來的東西,在PHP 6都要出來的時候,PHP 6只預設使用PDO來處理資料庫,將把所有的資料庫擴充移到了PECL,那麼預設就是沒有了我們喜愛的php_mysql.dll之類的了,那怎麼辦捏,我們只有與時俱進了,我就小試了一把PDO。 (本文只是入門級的,高手可以略過,呵呵)
【PDO是啥】
PDO是PHP 5新加入的一個重大功能,因為在PHP 5以前的php4/php3都是一堆的資料庫擴充來跟各個資料庫的連接和處理,什麼php_mysql.dll、php_pgsql.dll、php_mssql.dll、php_sqlite.dll等等擴充功能來連接MySQL、PostgreSQL、MS SQL Server、SQLite,同樣的,我們必須藉助ADOdb、PEAR::DB、PHPlib ::DB之類的資料庫抽象類別來幫助我們,無比煩瑣和低效,畢竟,php程式碼的效率怎麼能夠我們直接用C/C++寫的擴展斜率高捏?所以嘛,PDO的出現是必然的,大家要平靜學習的心態去接受使用,也許你會發現能夠減少你不少功夫哦。
【安裝PDO】
我是在Windows XP SP2 上面,所以嘛,整個過程都是在Windows行進行的啦,至於Linux/FreeBSD 等平台,請自行查找資料設定安裝。
我的是PHP 5.1.4,已經自有了php_pdo.dll的擴展,但需要稍微設定一下才能使用。
打開c:windowsphp.ini ,那是我的PHP配置文件,找到下面這行:
extension_dir
這個就是我們擴展存在的目錄,我的PHP 5擴展是在:C:php5ext,那麼我就把這行改成:
extension_dir = "C:/php5/ext"
然後再往php.ini下面找到:
;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
下面有一堆類似;extension=php_mbstring.dll 的東西,這裡就是PHP擴充載入的配置了,我們再最後面加上我們PDO的擴充:
extension=php_pdo.dll
extension=php_pdo_mysql.dll
extension=php_pdo_pgsql.dll
extension=php_pdo_sqlite.dll
extension=php_pdo_mssql.dll
extension=php_pdo_odbc.dll
extension=php_pdo_firebird.dll
;extension=php_pdo_oci8.dll
各種PDO的驅動,能給加上的全給加上,不過後面的php_pdo_oci8.dll,因為我沒有安裝Oralce資料庫,所以沒有這個,就使用分號註解掉它。然後重啟我們的Web伺服器, IIS/Apache,我的是IIS,嘿嘿,表鄙視我,在Windows上,簡單嘛。
重新啟動後,在我們Web伺服器的文檔目錄下寫一個phpinfo.php的文件,加上這些:
<?
phpinfo();
?>
然後打開我們可愛的瀏覽器:IE/FireFox,我的是FireFox 2.0,剛下載的,很爽,不怕流氓軟體,哈哈。
在瀏覽器裡面輸入: http://localhost/phpinfo.php ,如果你的這個頁面路徑不一致,請自己輸入。
在產出的內容中,如果你能夠順利的看到:
PDO
PDO support enabled
PDO drivers mysql, pgsql, sqlite, mssql, odbc, firebird
後面有各種驅動的說明:PDO_Firebird,pdo_mssql,pdo_mysql,PDO_ODBC,pdo_pgsql,pdo_sqlite
那麼,恭喜你安裝成功了,否則恭喜你安裝我上面的步驟。
【牛刀小小試】
我用的是MySQL 4.0.26,但我個人推薦大家使用MySQL 4.1.x 或MySQL 5.0.x,因為那些版本有很多有趣的東西都值得學習。我們這裡PDO需要連接的就是我的MySQL 4.0啦,如果你沒有安裝MySQL,請自己安裝。我們建立好了MySQL,並且在test庫裡加入了表foo,包括id,name,gender,time等四個欄位。
我們開始建構第一個PDO應用,建立一個pdo.php檔案在Web文件目錄下:
<?php
$dsn = "mysql:host=localhost;dbname=test";
$db = new PDO($dsn, 'root', '');
$count = $db->exec("INSERT INTO foo SET name = 'heiyeluren',gender='男',time=NOW()");
echo $count;
$db = null;
?>
不懂啥意思,俺們來慢慢講講。這行:
$dsn = "mysql:host=localhost;dbname=test";
就是建構我們的DSN(資料來源),看看裡面的資訊包含:資料庫類型是mysql,主機位址是localhost,資料庫名稱是test,就這麼幾個訊息。不同資料庫的資料來源構造方式是不一樣的。
$db = new PDO($dsn, 'root', '');
初始化一個PDO對象,建構函數的參數第一個就是我們的資料來源,第二個是連接資料庫伺服器的用戶,第三個參數是密碼。我們不能保證連結成功,後面我們會講到異常情況,這裡我們姑且認為它是連結成功的。
$count = $db->exec("INSERT INTO foo SET name = 'heiyeluren',gender='男',time=NOW()");
echo $count;
呼叫我們連接成功的PDO物件來執行一個查詢,這個查詢是一個插入一筆記錄的操作,使用PDO::exec() 方法會傳回一個影響記錄的結果,所以我們輸出這個結果。最後還是需要結束物件資源:
$db = null;
預設這個不是長連接,如果需要資料庫長連接,需要最後加一個參數:array(PDO::ATTR_PERSISTENT => true) 變成這樣:
$db = new PDO( $dsn, 'root', '', array(PDO::ATTR_PERSISTENT => true));
一次操作就這麼簡單,也許跟以前的沒有太大差別,跟ADOdb倒有幾分相似。
【繼續了解】
如果我們想提取數據的話,那麼就應該使用數據獲取功能。 (下面用到的$db都是上面已經連接好的物件)
<?php
foreach($db->query("SELECT * FROM foo")){
print_r($row);
}
?>
我們也可以使用這個取得方式:
<?php
$rs = $db->query("SELECT * FROM foo");
while($row = $rs->fetch()){
print_r($row);
}
?>
如果想一次把資料都取得到陣列裡可以這樣:
<?php
$rs = $db->query("SELECT * FROM foo");
$result_arr = $rs->fetchAll();
print_r($result_arr);
?>
Array
([0] => Array(
[id] => 1
[0] => 1
[name] => heiyeluren
[1] => heiyeluren
[gender] => 男[2] => 男[時間] => 2006-10-28 23:14:23
[3] => 2006-10-28 23:14:23
)
}
我們看裡面的記錄,數字索引和關聯索引都有,浪費資源,我們只需要關聯索引的:
<?php
$db->setAttribute(PDO::ATTR_CASE, PDO::CASE_UPPER);
$rs = $db->query("SELECT * FROM foo");
$rs->setFetchMode(PDO::FETCH_ASSOC);
$result_arr = $rs->fetchAll();
print_r($result_arr);
?>
看上面的程式碼,setAttribute() 方法是設定部分屬性,主要屬性有:PDO::ATTR_CASE、PDO::ATTR_ERRMODE等等,我們這裡需要設定的是PDO::ATTR_CASE,就是我們使用關聯索引來取得資料集的時候,關聯索引是大寫還是小寫,有幾個選擇:
PDO::CASE_LOWER -- 強制列名是小寫PDO::CASE_NATURAL -- 列名按照原始的方式PDO::CASE_UPPER -- 強制列名為大寫
我們使用setFetchMode方法來設定取得結果集的回傳值的類型,同類型還有:
PDO::FETCH_ASSOC -- 關聯數組形式PDO::FETCH_NUM -- 數字索引數組形式PDO::FETCH_BOTH -- 兩者數組形式都有,這是預設的PDO::FETCH_OBJ -- 按照物件的形式,類似於以前的mysql_fetch_object()
當然,一般情況下我們是使用PDO::FETCH_ASSOC,具體使用什麼,按照你自己的需要,其他獲取類型參考手冊。
除了上面這種取得資料的方式,還有這種:
<?php
$rs = $db->prepare("SELECT * FROM foo");
$rs->execute();
while($row = $rs->fetch()){
print_r($row);
}
?>
其實差不多啦。如果你想要取得指定記錄裡一個欄位結果的話,可以使用PDOStatement::fetchColumn():
<?php
$rs = $db->query("SELECT COUNT(*) FROM foo");
$col = $rs->fetchColumn();
echo $col;
?>
一般使用fetchColumn()來進行count統計或某些只需要單一欄位的記錄很好操作。
簡單的總結上面的操作:
查詢操作主要是PDO::query()、PDO::exec()、PDO::prepare()。 PDO::query()主要是用於有記錄結果回傳的操作,特別是SELECT操作,PDO::exec()主要是針對沒有結果集合回傳的操作,例如INSERT、UPDATE、DELETE等操作,它傳回的結果是目前操作影響的列數。 PDO::prepare()主要是預處理操作,需要透過$rs->execute()來執行預處理裡面的SQL語句,這個方法可以綁定參數,功能比較強大,不是本文能夠簡單說明白的,大家可以參考手冊和其他文件。 取得結果集運算主要是:PDOStatement::fetchColumn()、PDOStatement::fetch()、PDOStatement::fetchALL()。 PDOStatement::fetchColumn() 是取得結果指定第一筆記錄的某個字段,缺省是第一個字段。 PDOStatement::fetch() 是用來取得一筆記錄,PDOStatement::fetchAll()是取得所有記錄集到一個中,取得結果可以透過PDOStatement::setFetchMode來設定需要結果集合的類型。
另外有兩個週邊的操作,一個是PDO::lastInsertId()和PDOStatement::rowCount()。 PDO::lastInsertId()是傳回上次插入操作,主鍵列類型是自增的最後的自增ID。 PDOStatement::rowCount()主要用於PDO::query()和PDO::prepare()進行DELETE、INSERT、UPDATE操作影響的結果集,對PDO::exec()方法和SELECT操作無效。
【錯誤處理】
如果程式中碰到錯誤咋辦?我們這裡描述PDO類別的錯誤訊息和異常處理。
1. 物件導向的方式
先看看如果連接錯誤等的處理,使用物件導向的方式來處理:
<?php
try {
$db = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
$db = null;
} catch (PDOException $e) {
print "Error: " . $e->getMessage() . "<br/>";
die();
}
?>
這裡利用我們PHP 5物件導向的異常處理特徵,如果裡面有異常的話就初始化呼叫PDOException來初始化一個異常類別。
PDOException異常類別的屬性結構:
<?php
class PDOException extends Exception
{
public $errorInfo = null; // 錯誤訊息,可以呼叫PDO::errorInfo() 或PDOStatement::errorInfo()來存取protected $message; // 例外訊息,可以試試Exception::getMessage() 來存取protected $code ; // SQL狀態錯誤碼,可以使用Exception::getCode() 來存取
}
?>
這個異常處理類是整合PHP 5內建的異常處理類,我們簡單的看一下PHP 5內建的異常處理類結構:
<?php
class Exception
{
// 屬性protected $message = 'Unknown exception'; // 異常訊息protected $code = 0; // 使用者自訂異常碼protected $file; // 發生異常的檔案名稱protected $line; // 發生異常的程式碼行號
// 方法final function getMessage(); // 傳回異常訊息final function getCode(); // 傳回異常碼final function getFile(); // 傳回發生異常的檔名final function getLine(); // 傳回發生異常的程式碼行號final function getTrace(); // backtrace() 陣列final function getTraceAsString(); // 已格成化成字串的getTrace() 訊息
}
?>
對應的,在程式碼中可以適當的呼叫getFile() 和getLine() 來進行錯誤定位,更方便的進行偵錯。
2. 使用過程導向的方法
先看程式碼:
<?
$db = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
$rs = $db->query("SELECT aa,bb,cc FROM foo");
if ($db->errorCode() != '00000'){
print_r($db->errorInfo());
exit;
}
$arr = $rs->fetchAll();
print_r($arr);
$db = null;
?>
PDO和PDOStatement物件有errorCode() 和errorInfo() 方法,如果沒有任何錯誤, errorCode() 傳回的是: 00000 ,否則就會傳回一些錯誤碼。 errorInfo() 傳回的數組,包括PHP定義的錯誤代碼和MySQL的錯誤代碼和錯誤訊息,數組結構如下:
Array
(
[0] => 42S22
[1] => 1054
[2] => Unknown column 'aaa' in 'field list'
)
每次執行查詢以後,errorCode() 的結果都是最新的,所以我們可以輕鬆地自己控制錯誤訊息顯示。
【簡單總結】
從上面的使用看出,PDO功能確實強大,另外還有一些內容我沒有講到,例如綁定參數、預處理、預存程序、事務處理等等功能。另外還有不同資料擴DSN的構造,Oracle資料庫自己很多特殊的東西,都需要深入去學習理解,這篇文章就只是簡單的描述了一些入門知識,算是對PDO一個簡單的了解吧。