連接是通過創(chuàng)建 PDO 基類的實例而建立的。不管使用哪種驅(qū)動程序,都是用 PDO 類名。構(gòu)造函數(shù)接收用于指定數(shù)據(jù)庫源(所謂的 DSN)以及可能還包括用戶名和密碼(如果有的話)的參數(shù)。
示例 #1 連接到 MySQL
<?php
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
?>
如果有任何連接錯誤,將拋出一個 PDOException
異常對象。如果想處理錯誤狀態(tài),可以捕獲異常,或者選擇留給通過 set_exception_handler() 設(shè)置的應(yīng)用程序全局異常處理程序。
示例 #2 處理連接錯誤
<?php
try {
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
foreach($dbh->query('SELECT * from FOO') as $row) {
print_r($row);
}
$dbh = null;
} catch (PDOException $e) {
print "Error!: " . $e->getMessage() . "<br/>";
die();
}
?>
如果應(yīng)用程序不在 PDO 構(gòu)造函數(shù)中捕獲異常,zend 引擎采取的默認(rèn)動作是結(jié)束腳本并顯示一個回溯跟蹤,此回溯跟蹤可能泄漏完整的數(shù)據(jù)庫連接細(xì)節(jié),包括用戶名和密碼。因此有責(zé)任去顯式(通過 catch
語句)或隱式(通過 set_exception_handler() )地捕獲異常。
連接數(shù)據(jù)成功后,返回一個 PDO 類的實例給腳本,此連接在 PDO 對象的生存周期中保持活動。要想關(guān)閉連接,需要銷毀對象以確保所有剩余到它的引用都被刪除,可以賦一個 null
值給對象變量。如果不明確地這么做,PHP 在腳本結(jié)束時會自動關(guān)閉連接。
示例 #3 關(guān)閉一個連接
<?php
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
// 在此使用連接
// 現(xiàn)在運行完成,在此關(guān)閉連接
$dbh = null;
?>
很多 web 應(yīng)用程序通過使用到數(shù)據(jù)庫服務(wù)的持久連接獲得好處。持久連接在腳本結(jié)束后不會被關(guān)閉,且被緩存,當(dāng)另一個使用相同憑證的腳本連接請求時被重用。持久連接緩存可以避免每次腳本需要與數(shù)據(jù)庫回話時建立一個新連接的開銷,從而讓 web 應(yīng)用程序更快。
示例 #4 持久化連接
<?php
$dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass, array(
PDO::ATTR_PERSISTENT => true
));
?>
注意:
如果想使用持久連接,必須在傳遞給 PDO 構(gòu)造函數(shù)的驅(qū)動選項數(shù)組中設(shè)置
PDO::ATTR_PERSISTENT
。如果是在對象初始化之后用 PDO::setAttribute() 設(shè)置此屬性,則驅(qū)動程序?qū)⒉粫褂贸志眠B接。
注意:
如果使用 PDO ODBC 驅(qū)動且 ODBC 庫支持 ODBC 連接池(有unixODBC 和 Windows 兩種做法;可能會有更多),建議不要使用持久的 PDO 連接,而是把連接緩存留給 ODBC 連接池層處理。 ODBC 連接池在進(jìn)程中與其他模塊共享;如果要求 PDO 緩存連接,則此連接絕不會被返回到 ODBC 連接池,導(dǎo)致創(chuàng)建額外的連接來服務(wù)其他模塊。