使用 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 操作对数据库的影响。通过这个方法，我们可以方便地监控删除操作的效果，确保程序在与数据库交互时的可靠性和准确性。