使用PDOStatement::rowCount 檢查DELETE 操作的影響

gitbox 2025-05-28

在PHP 中，當我們使用PDO (PHP Data Objects) 進行數據庫操作時，刪除數據是一個常見的需求。為了確保DELETE 操作成功並獲取有關操作結果的詳細信息，我們可以利用PDOStatement::rowCount函數來檢查刪除操作對數據庫的影響。

PDO::prepare 和DELETE 操作

在執行DELETE 操作時，我們通常需要使用PDO::prepare來準備SQL 語句，並通過PDOStatement::execute來執行。 PDOStatement::rowCount函數能夠告訴我們在執行DELETE 語句後，實際刪除了多少行。

 <?php
// 數據庫連接信息
$dsn = 'mysql:host=localhost;dbname=testdb';
$username = 'root';
$password = '';

// 創建 PDO 實例
try {
    $pdo = new PDO($dsn, $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // DELETE SQL 語句
    $sql = "DELETE FROM users WHERE last_login < :date";
    $stmt = $pdo->prepare($sql);

    // 綁定參數
    $date = '2023-01-01';
    $stmt->bindParam(':date', $date);

    // 執行刪除操作
    $stmt->execute();

    // 檢查 DELETE 操作的影響
    $rowCount = $stmt->rowCount();
    echo "成功刪除了 {$rowCount} 條記錄。";
} catch (PDOException $e) {
    echo "錯誤: " . $e->getMessage();
}
?>

rowCount 函數的作用

在執行DELETE 語句後， rowCount()方法返回一個整數，表示受影響的行數。在上面的例子中，假設有5 條記錄符合刪除條件，那麼rowCount()將返回5，表示這5 條記錄被成功刪除。

需要注意的是， rowCount()在某些數據庫驅動下（如MySQL）可能在執行DELETE語句時有不同的行為。比如，如果DELETE 語句的WHERE 條件沒有匹配到任何記錄， rowCount()將返回0，表示沒有記錄被刪除。

注意事項

事務管理：在執行DELETE 操作時，建議將其放入事務中，以便在出現錯誤時能夠回滾操作，確保數據庫的一致性。
刪除結果的驗證：通過rowCount()檢查實際刪除的行數，能夠幫助開發者驗證刪除操作是否成功執行。特別是在涉及到條件刪除時， rowCount()可以有效地幫助我們確認刪除的記錄是否符合預期。
性能考慮：如果DELETE 操作涉及大量數據，建議謹慎使用，最好使用LIMIT 語句分批刪除，以避免一次性刪除大量數據對性能造成影響。

上面就是如何使用PDOStatement::rowCount函數來檢查DELETE 操作對數據庫的影響。通過這個方法，我們可以方便地監控刪除操作的效果，確保程序在與數據庫交互時的可靠性和準確性。