mysqli_stmt::$affected_rows

适用PHP版本

PHP 5 >= 5.0.0, PHP 7, PHP 8

函数说明

mysqli_stmt::$affected_rows 属性用于获取最近一次执行的预处理语句所影响的行数。常用于INSERT、UPDATE、DELETE等SQL语句执行后，判断受影响的记录数量。

函数语法

int $stmt->affected_rows

这里 $stmt 是一个 mysqli_stmt 对象。

返回值

返回一个整数，表示最近执行的预处理语句影响的行数。如果执行失败或语句未执行，返回 -1。

示例

  $stmt = $mysqli->prepare("UPDATE users SET email = ? WHERE id = ?");
  $stmt->bind_param("si", $email, $user_id);
  $stmt->execute();
  echo "影响的行数: " . $stmt->affected_rows;
  

示例代码说明

该示例先准备了一条更新用户邮箱的SQL语句，通过 bind_param 绑定参数，然后执行该语句。执行完成后，通过 $stmt->affected_rows 获取并输出受影响的记录数。