PDO 是 PHP 訪問數據庫的標準化介面,本文系統整理其核心方法、預處理模式、事務控制、錯誤模式、實戰代碼模板,作為開發手冊隨時查閱。
| 方法 | 用途 | 返回值 |
|---|---|---|
query() | 執行 SELECT 等有結果集語句 | PDOStatement |
exec() | 執行 INSERT/UPDATE/DELETE/DDL | 影響行數 |
lastInsertId() | 獲取上次 INSERT 自增 ID | 字符串/整數 |
prepare() | 預處理語句 | PDOStatement |
beginTransaction() | 開啟事務 | bool |
commit() | 提交事務 | bool |
rollBack() | 回滾事務 | bool |
setAttribute() | 設置屬性(錯誤模式、預處理模擬等) | bool |
| 方法 | 說明 |
|---|---|
fetch(style) | 取下一行,配合 while 遍歷 |
fetchAll(style) | 一次性取所有行(大結果集慎用) |
fetchColumn(index) | 直接取單列值,游標自動前移 |
rowCount() | SELECT 返回行數(不保證所有驅動支援) |
columnCount() | 結果集列數 |
PDO::FETCH_BOTH(預設):關聯+數字索引雙份PDO::FETCH_ASSOC:僅關聯索引 **推薦**PDO::FETCH_NUM:僅數字索引PDO::FETCH_OBJ:返回 stdClass 對象PDO::FETCH_CLASS:映射到指定類(配合 setFetchMode) PDO::ERRMODE_EXCEPTION, // 拋出異常
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, // 預設關聯數組
PDO::ATTR_EMULATE_PREPARES => false, // 使用原生預處理
PDO::ATTR_PERSISTENT => true, // 持久連接(視場景)
];
$dbh = new PDO($dsn, 'user', 'pass', $options);
// SILENT(預設):靜默,需手動檢查 errorCode()/errorInfo()
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
// WARNING:觸發 E_WARNING,腳本繼續
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);
// EXCEPTION(推薦):拋出 PDOException,統一 try/catch
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
prepare($sql);
$stmt->execute([':login'=>'kevin', ':password'=>password_hash('123', PASSWORD_DEFAULT)]);
echo $dbh->lastInsertId(); // 新記錄 ID
// UPDATE
$sql = "UPDATE `user` SET `password`=:pwd WHERE `user_id`=:id";
$stmt = $dbh->prepare($sql);
$stmt->execute([':id'=>7, ':pwd'=>password_hash('456', PASSWORD_DEFAULT)]);
echo $stmt->rowCount(); // 影響行數
// DELETE
$sql = "DELETE FROM `user` WHERE `login` LIKE :pattern";
$stmt = $dbh->prepare($sql);
$stmt->execute([':pattern'=>'kevin%']);
echo $stmt->rowCount();
// SELECT
$sql = "SELECT * FROM `user` WHERE `login` LIKE :pattern";
$stmt = $dbh->prepare($sql);
$stmt->execute([':pattern'=>'kevin%']);
while ($row = $stmt->fetch()) {
print_r($row);
}
// 或一次性取所有
$all = $stmt->fetchAll();
beginTransaction();
$dbh->exec("INSERT INTO `order` ... VALUES (...)");
$dbh->exec("INSERT INTO `order_item` ... VALUES (...)");
$dbh->exec("UPDATE `stock` SET `qty`=`qty`-1 WHERE `id`=...");
$dbh->commit();
} catch (Exception $e) {
$dbh->rollBack();
error_log("Transaction failed: " . $e->getMessage());
throw $e; // 向上拋出或自定義處理
}
prepare + 循環 execute,或構建多值 INSERT ... VALUES (?,?),(?,?)...(注意 max_allowed_packet)。$stmt->debugDumpParams() 打印綁定參數與編譯後 SQL。PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL 可隨機訪問結果集行。$stmt->nextRowset() 處理存儲過程多結果集。lastInsertId() 在多值 INSERT 中僅返回**第一行** ID,非最後一行。rowCount() 對 SELECT 在某些驅動不可靠,改用 SELECT COUNT(*) 獨立查詢。ATTR_PERSISTENT 可能導致「MySQL server has gone away」,長連接需配合 ATTR_TIMEOUT 或定期 ping。將上述模板封裝為 Database::query()、Database::execute()、Database::transaction() 靜態方法,即可構建專屬輕量 DB 層,兼具 PDO 標準與業務便利性。