(PHP 5, PHP 7, PHP 8)
mysqli_stmt::$num_rows -- mysqli_stmt::num_rows -- mysqli_stmt_num_rows — 返回从服务器获取的行数
面向对象风格
过程式风格
返回在语句中缓冲的行数。此函数仅在调用 mysqli_stmt_store_result() 以将整个结果集缓冲在语句句柄中后才能工作。
此函数返回 0，除非所有行都已从服务器获取。
示例 #1 面向对象风格
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
$stmt = $mysqli->prepare($query);
$stmt->execute();
/* 将结果存储在内部缓冲区中 */
$stmt->store_result();
printf("行数：%d.\n", $stmt->num_rows);示例 #2 过程式风格
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
$stmt = mysqli_prepare($link, $query);
mysqli_stmt_execute($stmt);
/* 将结果存储在内部缓冲区中 */
mysqli_stmt_store_result($stmt);
printf("行数：%d.\n", mysqli_stmt_num_rows($stmt));上面的示例将输出
Number of rows: 20.
请注意，对于有时会错过阅读此函数重要手册条目的人
如果您不使用 mysqli_stmt_store_result( )，并且在执行准备好的语句后立即调用此函数，此函数通常会返回 0，因为它无法知道结果集中有多少行，因为结果集尚未保存在内存中。
mysqli_stmt_store_result( ) 将结果集保存在内存中，因此您可以在执行语句并保存结果集后立即使用此函数。
如果您不保存结果集，但仍然想使用此函数，您必须使用 mysqli_stmt_fetch( ) 逐行遍历结果集，然后再使用此函数确定行数。
不过，如果您想在不存储结果集的情况下确定行数，并在遍历结果集后确定行数，为什么不简单地在循环中每次获取一行时使用内部计数器，并保存函数调用呢？
简而言之，此函数只有在您保存结果集并希望在遍历结果集之前确定行数时才有用，否则您可以像我建议的那样重建其用法。