PHP mysqli_stmt_fetch() 函数用法及示例

PHP MySQLi 参考手册

mysqli_stmt_fetch()函数将预准备语句中的结果提取到绑定变量中。

定义和用法

您可以使用mysqli_prepare()函数创建一个预处理语句,该语句具有参数标记(“?”)(如果有值)。预处理语句后,需要使用mysqli_stmt_bind_param()函数将值绑定到所创建语句的参数。

以相同的方式,可以使用 mysqli_stmt_bind_result() 函数将语句的结果集的列绑定到所需的变量。

如果调用了mysqli_stmt_fetch()函数,则在绑定列之后,它将结果的列提取到指定的变量中。

语法

mysqli_stmt_fetch($stmt);

参数

序号参数及说明
1

stmt(必需)

这是表示准备好的语句的对象。

返回值

如果获取数据,PHP mysqli_stmt_fetch()函数将返回TRUE;如果出现错误,则返回FALSE;如果结果中没有更多行,则返回NULL

PHP版本

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

在线示例

以下示例演示了mysqli_stmt_fetch()函数的用法(面向过程风格),使用预处理语句将结果中的值绑定到变量:

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

   mysqli_query($con, "CREATE TABLE myplayers(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("创建表.....\n");
   mysqli_query($con, "INSERT INTO myplayers values(1, 'Sikhar', 'Dhawan', 'Delhi', 'India')");
   mysqli_query($con, "INSERT INTO myplayers values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   print("插入记录.....\n");

   //检索表的内容
   $stmt = mysqli_prepare($con, "SELECT * FROM myplayers");

   //执行语句
   mysqli_stmt_execute($stmt);

   //将结果中的值绑定到变量
   mysqli_stmt_bind_result($stmt, $id, $fname, $lname, $pob, $country);

   while (mysqli_stmt_fetch($stmt)) {
      print("Id: ".$id."\n");
      print("fname: ".$fname."\n");
      print("lname: ".$lname."\n");
      print("pob: ".$pob."\n");
      print("country: ".$country."\n");
      print("\n");

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

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

输出结果

创建表.....
插入记录.....
Id: 1
fname: Sikhar
lname: Dhawan
pob: Delhi
country: India

Id: 2
fname: Jonathan
lname: Trott
pob: CapeTown
country: SouthAfrica

在线示例

在面向对象风格中,此函数的语法为$stmt->fetch();。以下是面向对象风格中此函数的示例,使用预处理语句将变量绑定到结果集:

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

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

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

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

   //将变量绑定到结果集
   $stmt->bind_result($name, $age);
   while ($stmt->fetch()) {
      print("Name: ".$name."\n");
      print("Age: ".$age."\n");
   }

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

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

输出结果

创建表.....
记录已删除.....
Name: Raju
Age: 25
Name: Rahman
Age: 30

在线示例

以下示例使用 mysqli_stmt_bind_result() 和 mysqli_stmt_fetch() 函数获取DESCRIBE查询的结果-

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

   mysqli_query($con, "CREATE TABLE myplayers(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("创建表.....\n");

   //表的说明
   $stmt = mysqli_prepare($con, "DESC myplayers");

   //执行语句
   mysqli_stmt_execute($stmt);

   //将结果中的值绑定到变量
   mysqli_stmt_bind_result($stmt, $field, $type, $null, $key, $default, $extra);

   while (mysqli_stmt_fetch($stmt)) {
      print("Field: ".$field."\n");
      print("Type: ".$type."\n");
      print("Null: ".$null."\n");
      print("Key: ".$key."\n");
      print("Default: ".$default."\n");
      print("Extra: ".$extra."\n");
      print("\n");
   }

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

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

输出结果

创建表.....
Field: ID
Type: int(11)
Null: YES
Key:
Default:
Extra:

Field: First_Name
Type: varchar(255)
Null: YES
Key:
Default:
Extra:

Field: Last_Name
Type: varchar(255)
Null: YES
Key:
Default:
Extra:

Field: Place_Of_Birth
Type: varchar(255)
Null: YES
Key:
Default:
Extra:

Field: Country
Type: varchar(255)
Null: YES
Key:
Default:
Extra:

在线示例

以下示例使用 mysqli_stmt_bind_result() 和 mysqli_stmt_fetch() 函数获取SHOW TABLES查询的结果,返回当前数据库中的所有表:

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

   //选择数据库
   mysqli_query($con, "CREATE DATABASE NewDatabase");
   mysqli_select_db($con, "NewDatabase");

   //创建表
   mysqli_query($con, "CREATE TABLE test1(Name VARCHAR(255), Age INT)");
   mysqli_query($con, "CREATE TABLE test2(Name VARCHAR(255), Age INT)");
   mysqli_query($con, "CREATE TABLE test3(Name VARCHAR(255), Age INT)");
   print("创建的表.....\n");

   //显示表
   $stmt = mysqli_prepare($con, "SHOW TABLES");

   //执行语句
   mysqli_stmt_execute($stmt);

   //将结果中的值绑定到变量
   mysqli_stmt_bind_result($stmt, $table_name);

   print("当前数据库中的所有表: \n");
   while (mysqli_stmt_fetch($stmt)) {
      print($table_name."\n");
   }

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

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

输出结果

创建的表.....
当前数据库中的所有表:
test1
test2
test3

PHP MySQLi 参考手册