如何用 PDOStatement::rowCount 判断数据库操作是否成功

gitbox 2025-05-19

在使用 PHP 的 PDO（PHP Data Objects）操作数据库时，开发者经常需要判断一条 SQL 语句是否执行成功，特别是在进行 INSERT、UPDATE 或 DELETE 操作时。PDOStatement::rowCount 方法提供了一种方便的方式来检查受影响的行数，从而判断数据库操作是否有效。

什么是 PDOStatement::rowCount？

rowCount() 是 PDOStatement 类中的一个方法，用于返回受上一个 SQL 语句影响的行数。适用于 DELETE、INSERT 和 UPDATE 类型的语句，对于 SELECT 语句是否可用则依赖于驱动（如 MySQL 的 SELECT 默认不支持准确的行数返回）。

基本语法

$affectedRows = $statement->rowCount();

其中 $statement 是通过 $pdo->prepare() 和 $statement->execute() 执行后的返回对象。

示例：使用 rowCount 判断操作是否成功

下面我们来看一个实际的例子，演示如何使用 rowCount() 来判断一次 UPDATE 操作是否成功更新了任何数据。

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

    $sql = "UPDATE users SET email = :email WHERE id = :id";
    $stmt = $pdo->prepare($sql);

    $stmt->bindParam(':email', $newEmail);
    $stmt->bindParam(':id', $userId);

    $newEmail = "[email protected]";
    $userId = 3;

    $stmt->execute();

    if ($stmt->rowCount() > 0) {
        echo "用户信息更新成功，共更新 " . $stmt->rowCount() . " 条记录。";
    } else {
        echo "没有记录被更新，可能是因为数据没有变化或用户ID不存在。";
    }

} catch (PDOException $e) {
    echo "数据库操作失败: " . $e->getMessage();
}
?>

注意事项

对 SELECT 的支持有限：虽然某些数据库驱动支持 SELECT 查询后使用 rowCount()，但这不是跨数据库兼容的行为。如果你需要准确的 SELECT 行数，请考虑使用 fetchAll() 并对结果数组计数。
行数为 0 不等于失败：当更新的数据与原数据相同时，SQL 执行成功但不会影响任何行，rowCount() 返回 0。这种情况不应视为失败，而是“无变化”。
事务中的使用：在事务中使用 rowCount() 不会受影响。你可以根据返回值决定是否提交或回滚事务。

小结

PDOStatement::rowCount 是判断数据库写操作是否生效的有力工具，尤其在需要给用户提供反馈或执行逻辑判断时非常有用。不过，开发者需要理解它在不同上下文中的表现，以避免误解操作结果。

通过合理地使用 rowCount()，可以提升 PHP 应用的健壮性和用户体验。如果你在开发中遇到不确定的数据库操作效果，尝试引入 rowCount() 来提升代码的可控性与反馈能力。