PHP mysqli_stmt_affected_rows() 函数用法及示例

PHP MySQLi 参考手册

mysqli_stmt_affected_rows()函数返回最后执行的语句更改,删除或插入的行总数.

定义和用法

mysqli_stmt_affected_rows()函数返回最近执行的语句影响(更改,删除,插入)的行数。

只有在INSERT,UPDATE或DELETE语句之后调用此函数,该函数才能正常工作。如果您需要了解受SELECT查询影响的行数,则需要使用 mysqli_stmt_num_rows() 函数。

语法

mysqli_stmt_affected_rows($stmt)

参数

序号参数及说明
1

stmt(必需)

这是表示执行SQL查询的语句的对象。

返回值

PHP mysqli_stmt_affected_rows()函数返回一个整数值,该值指示受先前(INSERT,UPDATE,REPLACE或DELETE)操作影响的行数。

如果语句有错误,则此函数返回-1。如果没有受影响的行,则此函数返回0

PHP版本

此函数最初是在PHP版本5中引入的,并且可以在所有更高版本中使用。

在线示例

假设我们已经在MySQL数据库中创建了一个名为employee的表,其内容如下:

mysql> select * from employee;
+------------+--------------+------+------+--------+
| FIRST_NAME | LAST_NAME    | AGE  | SEX  | INCOME |
+------------+--------------+------+------+--------+
| Vinay      | Bhattacharya |   20 | M    |  21000 |
| Sharukh    | Sheik        |   25 | M    |  23300 |
| Trupthi    | Mishra       |   24 | F    |  51000 |
| Sheldon    | Cooper       |   25 | M    |   2256 |
| Sarmista   | Sharma       |   28 | F    |  15000 |
+------------+--------------+------+------+--------+
5 rows in set (0.00 sec)

以下示例演示了mysqli_stmt_affected_rows()函数的用法(面向过程风格),执行update更新数据后,返回受影响的行数:

<?php
   $con = mysqli_connect("localhost", "root", "password", "mydb");

   $stmt = mysqli_prepare($con, "UPDATE employee set INCOME=INCOME-? where INCOME>=?");
   mysqli_stmt_bind_param($stmt, "si", $reduct, $limit);
   $limit = 20000;
   $reduct = 5000;

   //执行语句
   mysqli_stmt_execute($stmt);
   print("已更新的记录......\n");

   //受影响的行
   $count = mysqli_stmt_affected_rows($stmt);

   //结束语句
   mysqli_stmt_close($stmt);

   //关闭连接
   mysqli_close($con);

   print("受影响的行 ".$count);
?>

输出结果

已更新的记录......
受影响的行 3

在线示例

在面向对象风格中,此函数的语法为$con->affected_rows;。以下是面向对象风格中此函数的示例,执行delete删除数据后,返回受影响的行数:

<?php
   //建立连接
   $con = new mysqli("localhost", "root", "password", "mydb");

   $con -> query("CREATE TABLE Test(Name VARCHAR(255), AGE INT)");
   print("创建表.....\n");
   $con -> query("insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)");
   print("插入记录.....\n");

   $stmt = $con -> prepare( "DELETE FROM Test WHERE Name in(?, ?)");
   $stmt -> bind_param("ss", $name1, $name2);
   $name1 = 'Raju';
   $name2 = 'Rahman';
   print("记录已删除.....\n");

   //执行语句
   $stmt->execute();

   //Affected rows
   $count = $stmt ->affected_rows;
   print("受影响的行数 ".$count);

   //结束语句
   $stmt->close();

   //关闭连接
   $con->close();

?>

输出结果

创建表.....
插入记录.....
记录已删除.....
受影响的行数 2

在线示例

如果查询不影响任何行,让我们检查它的返回值-

<?php
   $con = @mysqli_connect("localhost", "root", "password", "mydb");

   mysqli_query($con, "CREATE TABLE Test(Name VARCHAR(255), AGE INT)");
   print("创建表.....\n");
   mysqli_query($con, "insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)");
   print("插入记录.....\n");

   $stmt = mysqli_prepare($con, "DELETE FROM test where Age<?");
   mysqli_stmt_bind_param($stmt, "i", $num);
   $num = 8;
   //执行语句
   mysqli_stmt_execute($stmt);
   //受影响的行
   $count = mysqli_stmt_affected_rows($stmt);
   print("受影响的行数(当查询不执行任何操作时): ".$count);

   //结束语句
   mysqli_stmt_close($stmt);
   //关闭连接
   mysqli_close($con);

?>

输出结果

创建表.....
插入记录.....
受影响的行数(当查询不执行任何操作时): 0

PHP MySQLi 参考手册