mysqli::$affected_rows

适用PHP版本

PHP 5 >= 5.0.0, PHP 7, PHP 8

函数说明

mysqli::$affected_rows 是一个属性，用于获取前一次执行的 MySQLi 查询语句所影响的行数。该属性适用于执行了 INSERT、UPDATE、DELETE 等操作后的结果，返回受影响的记录数。

函数语法

int $mysqli->affected_rows

返回值

• 返回整数值，表示受影响的行数。
• 如果最近一次查询失败，返回 -1。
• 对于无影响的查询（例如 SELECT），返回 0。

示例

假设执行一条更新语句，查看受影响的行数。

示例代码

<?php
$mysqli = new mysqli("localhost", "username", "password", "database");
if ($mysqli->connect_errno) {
  echo "连接失败: " . $mysqli->connect_error;
  exit();
}

$sql = "UPDATE users SET status='active' WHERE last_login < DATE_SUB(NOW(), INTERVAL 1 YEAR)";
$mysqli->query($sql);
echo "受影响的行数为: " . $mysqli->affected_rows;

$mysqli->close();
?>

示例代码说明

以上代码演示了如何通过 MySQLi 对象执行一条 UPDATE 语句，并使用 $mysqli->affected_rows 属性获取此次操作影响的记录数。它可以用来判断数据库操作是否成功以及影响了多少条数据。