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