萬盛學電腦網

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

PHP 使用 MySQL 交易 (Transaction) 完整實作與最佳實踐

什麼是資料庫交易?

交易 (Transaction) 將一組 SQL 操作視為單一不可分割的工作單元:**要么全部成功提交,要么全部失敗回滾**。確保資料一致性 (ACID 特性)。典型場景:轉帳扣款、訂單建立扣庫存、多表關聯寫入。

前置條件

  • 資料表引擎必須為 InnoDB (MyISAM 不支援交易)
  • PHP 使用 PDO 或 mysqli (舊版 mysql_* 函數已移除,勿使用)

PDO 交易完整範例 (推薦現代寫法)

<?php
// 資料庫連線配置
$dsn = 'mysql:host=localhost;dbname=test;charset=utf8mb4';
$user = 'root';
$pass = 'password';

try {
    $pdo = new PDO($dsn, $user, $pass, [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES => false,
    ]);
    
    // 1. 開始交易
    $pdo->beginTransaction();
    
    try {
        // 業務邏輯:使用者 A 轉帳 100 給使用者 B
        $fromUser = 1;
        $toUser = 2;
        $amount = 100;
        
        // 扣除轉出方餘額
        $stmt = $pdo->prepare("UPDATE accounts SET balance = balance - ? WHERE id = ? AND balance >= ?");
        $stmt->execute([$amount, $fromUser, $amount]);
        if ($stmt->rowCount() === 0) {
            throw new Exception("轉出方餘額不足或用戶不存在");
        }
        
        // 增加轉入方餘額
        $stmt = $pdo->prepare("UPDATE accounts SET balance = balance + ? WHERE id = ?");
        $stmt->execute([$amount, $toUser]);
        if ($stmt->rowCount() === 0) {
            throw new Exception("轉入方用戶不存在");
        }
        
        // 記錄交易流水
        $stmt = $pdo->prepare("INSERT INTO transactions (from_user, to_user, amount, type) VALUES (?, ?, ?, 'transfer')");
        $stmt->execute([$fromUser, $toUser, $amount]);
        
        // 2. 全部成功,提交交易
        $pdo->commit();
        echo "轉帳成功!";
        
    } catch (Exception $e) {
        // 3. 任何環節失敗,回滾交易
        $pdo->rollBack();
        echo "轉帳失敗: " . $e->getMessage();
    }
    
} catch (PDOException $e) {
    die("資料庫連線失敗: " . $e->getMessage());
}

mysqli 交易範例 (程序風格)

<?php
$mysqli = new mysqli('localhost', 'root', 'password', 'test');
$mysqli->set_charset('utf8mb4');

if ($mysqli->connect_errno) {
    die("連線失敗: " . $mysqli->connect_error);
}

// 關閉自動提交
$mysqli->autocommit(false);

try {
    $fromUser = 1;
    $toUser = 2;
    $amount = 100;
    
    // 扣款
    $stmt = $mysqli->prepare("UPDATE accounts SET balance = balance - ? WHERE id = ? AND balance >= ?");
    $stmt->bind_param('iii', $amount, $fromUser, $amount);
    $stmt->execute();
    if ($stmt->affected_rows === 0) throw new Exception("餘額不足");
    
    // 入帳
    $stmt = $mysqli->prepare("UPDATE accounts SET balance = balance + ? WHERE id = ?");
    $stmt->bind_param('ii', $amount, $toUser);
    $stmt->execute();
    if ($stmt->affected_rows === 0) throw new Exception("目標用戶不存在");
    
    // 流水
    $stmt = $mysqli->prepare("INSERT INTO transactions (from_user, to_user, amount) VALUES (?, ?, ?)");
    $stmt->bind_param('iii', $fromUser, $toUser, $amount);
    $stmt->execute();
    
    // 提交
    $mysqli->commit();
    echo "成功";
    
} catch (Exception $e) {
    $mysqli->rollback();
    echo "失敗: " . $e->getMessage();
}

$mysqli->close();

進階主題

1. 儲存點 - 部分回滾

<?php
$pdo->beginTransaction();

$pdo->exec("INSERT INTO logs (msg) VALUES ('step 1')");
$pdo->exec("SAVEPOINT step1"); // 設定儲存點

$pdo->exec("INSERT INTO logs (msg) VALUES ('step 2')");
// 假設 step 3 失敗但想保留 step 1,2
try {
    $pdo->exec("INSERT INTO invalid_table ..."); // 會失敗
} catch (Exception $e) {
    $pdo->exec("ROLLBACK TO SAVEPOINT step1"); // 回滾到 step1,step 1,2 保留
}

$pdo->commit(); // 最終只提交 step 1,2

2. 交易隔離等級

隔離等級髒讀不可重複讀幻讀效能
READ UNCOMMITTED可能可能可能最高
READ COMMITTED否可能可能高
REPEATABLE READ (預設)否否可能中
SERIALIZABLE否否否最低
<?php
// 設定隔離等級 (需在 beginTransaction 前)
$pdo->exec("SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED");
$pdo->beginTransaction();
// ...

3. 鎖機制與死鎖預防

  • 行鎖:SELECT ... FOR UPDATE (排他鎖)、LOCK IN SHARE MODE (共享鎖)
  • 死鎖預防:
    • 固定順序存取資源 (如按 ID 排序更新)
    • 縮短交易持續時間 (避免交易中進行網路請求、複雜運算)
    • 使用 innodb_lock_wait_timeout 設定等待超時 (預設 50 秒)

常見錯誤與除錯

錯誤 1:交易中混入 DDL (CREATE/ALTER/DROP TABLE)

後果:MySQL 會隱性提交當前交易 (隱性 commit),後續 rollback 無效。嚴禁在交易中執行 DDL。

錯誤 2:忘記關閉 autocommit (mysqli)

mysqli 預設 autocommit=ON,必須呼叫 $mysqli->autocommit(false) 或 $mysqli->begin_transaction() (PHP 5.5+)。

錯誤 3:捕獲 Exception 但未 rollback

// 錯誤寫法
try {
    $pdo->beginTransaction();
    // ... SQL
    $pdo->commit();
} catch (Exception $e) {
    echo $e->getMessage(); // 漏寫 rollback!
}

// 正確:finally 區塊確保清理 (PHP 5.5+)
try {
    $pdo->beginTransaction();
    // ...
    $pdo->commit();
} catch (Exception $e) {
    $pdo->rollBack();
    throw $e;
} finally {
    // 可選:清理資源
}

錯誤 4:巢狀交易 (MySQL 不支援真正巢狀)

<?php
$pdo->beginTransaction(); // 交易 1
// ...
$pdo->beginTransaction(); // 交易 2 - 實際上會隱性提交交易 1!
// ...
$pdo->rollBack(); // 只回滾交易 2,交易 1 已提交無法回滾

// 解決:使用儲存點模擬巢狀
$pdo->beginTransaction();
$pdo->exec("SAVEPOINT nested");
// ...
$pdo->exec("ROLLBACK TO SAVEPOINT nested");

最佳實踐檢查清單

  1. ✅ 使用 PDO (物件導向、支援多資料庫、預處理語句)
  2. ✅ 設定 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION 讓錯誤拋出異常
  3. ✅ try-catch 包裹交易區塊,catch 中呼叫 rollBack()
  4. ✅ 交易內 僅包含 DML (INSERT/UPDATE/DELETE),排除 DDL、SELECT (除非加鎖)
  5. ✅ 交易程式碼 簡短、快速,避免長時間持有鎖
  6. ✅ 重要操作記錄 交易流水表 供稽核追蹤
  7. ✅ 正式環境監控 死鎖日誌 (SHOW ENGINE INNODB STATUS)
copyright © 萬盛學電腦網 all rights reserved