PDOStatement::rowCount 與事務操作的關係

gitbox 2025-05-28

在PHP編程中，PDO（PHP Data Objects）是一個非常強大的數據庫訪問層，它使得操作數據庫更加靈活和安全。 PDO提供了許多有用的功能，而PDOStatement::rowCount()函數是一個常用的方法，尤其是在執行數據庫操作後，獲取受影響的行數時非常有用。本文將詳細討論PDOStatement::rowCount()在事務操作中的作用和應用。

1. 什麼是PDOStatement::rowCount() ？

PDOStatement::rowCount()是PDO的一個方法，用於返回最近執行的SQL語句影響的行數。具體來說，當你執行一個INSERT、UPDATE、DELETE或其他能夠影響數據表的SQL語句時， rowCount()方法會返回受影響的行數。

示例：

 <?php
try {
    $pdo = new PDO("mysql:host=localhost;dbname=test", "root", "password");
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // 開始事務
    $pdo->beginTransaction();
    
    // 執行更新操作
    $stmt = $pdo->prepare("UPDATE users SET email = :email WHERE id = :id");
    $stmt->execute([':email' => '[email protected]', ':id' => 1]);
    
    // 獲取受影響的行數
    echo "受影響的行數: " . $stmt->rowCount();
    
    // 提交事務
    $pdo->commit();
} catch (Exception $e) {
    // 回滾事務
    $pdo->rollBack();
    echo "錯誤: " . $e->getMessage();
}
?>

在上面的示例中，當我們執行更新操作後， $stmt->rowCount()會返回被更新的行數。可以根據這個數值來判斷是否進行了實際的更新操作。

2. rowCount()在事務操作中的應用

在事務操作中， rowCount()方法也扮演著非常重要的角色，尤其是在處理多個數據庫操作時，我們需要確保每個操作是否成功執行，並根據結果決定是否提交或回滾事務。

使用場景

確認操作成功：在執行多個數據庫操作時，我們可以使用rowCount()來確認每個操作是否影響了數據庫中的數據。如果rowCount()返回0，表示沒有數據被修改，這時可以選擇回滾事務或繼續執行其他操作。
條件提交或回滾：在事務中，我們通常會有多個SQL操作，如果任何一個操作沒有成功執行（即rowCount()為0），我們可以根據這個返回值來決定是否回滾整個事務，保證數據的完整性。

示例：事務中使用rowCount()判斷是否提交或回滾

<?php
try {
    $pdo = new PDO("mysql:host=localhost;dbname=test", "root", "password");
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // 開始事務
    $pdo->beginTransaction();
    
    // 執行第一個操作
    $stmt1 = $pdo->prepare("UPDATE users SET email = :email WHERE id = :id");
    $stmt1->execute([':email' => '[email protected]', ':id' => 1]);
    
    // 檢查是否有行被更新
    if ($stmt1->rowCount() == 0) {
        throw new Exception("沒有行被更新，回滾事務");
    }

    // 執行第二個操作
    $stmt2 = $pdo->prepare("DELETE FROM users WHERE id = :id");
    $stmt2->execute([':id' => 2]);

    // 檢查刪除操作
    if ($stmt2->rowCount() == 0) {
        throw new Exception("沒有行被刪除，回滾事務");
    }

    // 如果所有操作都成功，提交事務
    $pdo->commit();
    echo "事務已提交";
} catch (Exception $e) {
    // 回滾事務
    $pdo->rollBack();
    echo "錯誤: " . $e->getMessage();
}
?>

在這個示例中，我們首先開始一個事務，並執行兩個操作。如果任何一個操作沒有影響到數據庫中的數據，我們會拋出異常並回滾事務。這樣可以確保在整個事務中的所有操作都成功，否則就不會提交。

3. 注意事項

雖然PDOStatement::rowCount()在許多情況下非常有用，但在某些數據庫系統中， rowCount()返回的值可能並不總是準確。例如，在某些情況下， rowCount()可能在執行SELECT查詢時不返回預期的行數，或者在某些數據庫中可能不支持該方法。因此，在使用rowCount()時，要確保了解你所使用的數據庫和PDO的行為。

4. 總結

PDOStatement::rowCount()函數在PDO的事務操作中起到了非常重要的作用。它幫助開發者確認SQL操作是否成功執行，並決定是否提交或回滾事務。通過結合事務的使用， rowCount()能夠確保數據庫操作的一致性和數據完整性。儘管在某些情況下， rowCount()可能並不完全可靠，但它仍然是一個強大的工具，尤其是在需要處理多個SQL操作的複雜事務時。

PDOStatement::rowCount