萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP PDO 完整使用指南:連接配置、CRUD 操作、事務、預處理、錯誤處理與效能優化

PDO 是 PHP 訪問數據庫的標準化介面,本文系統整理其核心方法、預處理模式、事務控制、錯誤模式、實戰代碼模板,作為開發手冊隨時查閱。

核心方法速查

方法用途返回值
query()執行 SELECT 等有結果集語句PDOStatement
exec()執行 INSERT/UPDATE/DELETE/DDL影響行數
lastInsertId()獲取上次 INSERT 自增 ID字符串/整數
prepare()預處理語句PDOStatement
beginTransaction()開啟事務bool
commit()提交事務bool
rollBack()回滾事務bool
setAttribute()設置屬性(錯誤模式、預處理模擬等)bool

PDOStatement 取數方法

方法說明
fetch(style)取下一行,配合 while 遍歷
fetchAll(style)一次性取所有行(大結果集慎用)
fetchColumn(index)直接取單列值,游標自動前移
rowCount()SELECT 返回行數(不保證所有驅動支援)
columnCount()結果集列數

fetch_style 參數詳解

  • PDO::FETCH_BOTH(預設):關聯+數字索引雙份
  • PDO::FETCH_ASSOC:僅關聯索引 **推薦**
  • PDO::FETCH_NUM:僅數字索引
  • PDO::FETCH_OBJ:返回 stdClass 對象
  • PDO::FETCH_CLASS:映射到指定類(配合 setFetchMode)

1. 建立連接(DSN + 屬性配置)

 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);

2. 錯誤處理三種模式

// 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);

3. CRUD 範本(預處理模式)

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();

4. 事務控制模板

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; // 向上拋出或自定義處理
}

5. 進階技巧

  • 批量插入:單條 prepare + 循環 execute,或構建多值 INSERT ... VALUES (?,?),(?,?)...(注意 max_allowed_packet)。
  • 調試 SQL:$stmt->debugDumpParams() 打印綁定參數與編譯後 SQL。
  • 游標支援:PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL 可隨機訪問結果集行。
  • 多結果集:$stmt->nextRowset() 處理存儲過程多結果集。

避坑清單

  1. lastInsertId() 在多值 INSERT 中僅返回**第一行** ID,非最後一行。
  2. rowCount() 對 SELECT 在某些驅動不可靠,改用 SELECT COUNT(*) 獨立查詢。
  3. 預處理參數**不能**綁定表名、列名、LIMIT/OFFSET 數值(需白名單驗證後拼接)。
  4. 持久連接 ATTR_PERSISTENT 可能導致「MySQL server has gone away」,長連接需配合 ATTR_TIMEOUT 或定期 ping。

將上述模板封裝為 Database::query()、Database::execute()、Database::transaction() 靜態方法,即可構建專屬輕量 DB 層,兼具 PDO 標準與業務便利性。

copyright © 萬盛學電腦網 all rights reserved