連線是透過創建 PDO 基類別的實例而建立的。不管使用哪種驅動程序,都是用 PDO 類別名稱。建構函數接收用於指定資料庫來源(所謂的 DSN)以及可能還包括使用者名稱和密碼(如果有的話)的參數。
Example #1 連接到 MySQL
<?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass); ?>
如果有任何連接錯誤,將拋出一個 PDOException 異常物件。如果想要處理錯誤狀態,可以捕獲異常,或選擇留給透過 set_exception_handler() 設定的應用程式全域異常處理程序。
Example #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(); } ?>
如果應用程式不在PDO 構造函數中捕獲異常,zend 引擎採取的預設動作是結束腳本並顯示一個回溯跟踪,此回溯跟踪可能洩漏完整的資料庫連接細節,包括用戶名和密碼。因此有責任去明確(透過 catch 語句)或隱式(透過 set_exception_handler() )地捕捉異常。
連線資料成功後,傳回一個 PDO 類別的實例給腳本,此連線在 PDO 物件的生存週期中保持活動。要關閉連接,需要銷毀物件以確保所有剩餘到它的引用都被刪除,可以賦一個 NULL 值給物件變數。如果不明確地這麼做,PHP 在腳本結束時會自動關閉連線。
Example #3 關閉一個連接
<?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass); // 在此使用连接 // 现在运行完成,在此关闭连接 $dbh = null; ?>
很多 web 應用程式透過使用到資料庫服務的持久連接獲得好處。持久連接在腳本結束後不會被關閉,且被緩存,當另一個使用相同憑證的腳本連接請求時被重複使用。持久連線快取可以避免每次腳本需要與資料庫回話時建立一個新連線的開銷,從而讓 web 應用程式更快。
Example #4 持久化連接
<?php $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass, array( PDO::ATTR_PERSISTENT => true )); ?>
如果想要使用持久連接,必須在傳遞給 PDO 建構子的驅動選項陣列中設定 PDO::ATTR_PERSISTENT 。如果是在物件初始化之後以 PDO::setAttribute() 設定此屬性,則驅動程式將不會使用持久連線。
如果使用PDO ODBC 驅動且ODBC 庫支援ODBC 連接池(有unixODBC 和Windows 兩種做法;可能會有更多),建議不要使用持久的PDO 連接,而是把連接緩存留給ODBC 連接池層處理。 ODBC 連接池在進程中與其他模組共用;如果要求 PDO 快取連接,則此連接絕不會被返回到 ODBC 連接池,導致建立額外的連接來服務其他模組。