PHP mysqli_fetch_array() 函数用法及示例

PHP MySQLi 参考手册

mysqli_fetch_array()函数从结果集中取得一行作为关联数组,或数字数组,或二者兼有。

定义和用法

PHP result对象(mysqli_result类)表示MySQL结果,由SELECT或DESCRIBE或EXPLAIN查询返回。
mysqli_fetch_array()函数的作用是:接受一个结果对象作为参数,检索给定结果对象中当前行的内容,并将其作为关联数组或数值数组返回。

语法

mysqli_fetch_array($result, [$type]);

参数

序号参数及说明
1

result(必需)

这是表示结果对象的标识符。

2

type(必需)

这是一个整数值,指定返回数组的类型。该type的值是以下值之一-

  • MYSQLI_ASSOC

  • MYSQLI_NUM

  • MYSQLI_BOTH

返回值

PHP mysqli_fetch_array()函数返回一个数组(关联或数字),该数组保存结果对象的当前行。如果没有更多行,此函数将返回NULL。

PHP版本

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

在线示例

以下示例演示了mysqli_fetch_array()函数的用法(面向过程风格),从结果集中取得行作为数字数组或关联数组,并打印输出字段值:

<?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')");
   mysqli_query($con, "INSERT INTO myplayers values(3, 'Kumara', 'Sangakkara', 'Matale', 'Srilanka')");
   print("插入记录.....\n");

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

   //获取所有行作为数组
   while($row = mysqli_fetch_array($res, MYSQLI_ASSOC)){
      print("ID: ".$row["ID"]."\n");
      print("First_Name: ".$row["First_Name"]."\n");
      print("Last_Name: ".$row["Last_Name"]."\n");
      print("Place_Of_Birth: ".$row["Place_Of_Birth"]."\n");
      print("Country: ".$row["Country"]."\n");
   }
   //结束语句
   mysqli_free_result($res);

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

输出结果

创建表.....
插入记录.....
ID: 1
First_Name: Sikhar
Last_Name: Dhawan
Place_Of_Birth: Delhi
Country: India
ID: 2
First_Name: Jonathan
Last_Name: Trott
Place_Of_Birth: CapeTown
Country: SouthAfrica
ID: 3
First_Name: Kumara
Last_Name: Sangakkara
Place_Of_Birth: Matale
Country: Srilanka

在线示例

在面向对象风格中,此函数的语法为$result->fetch_array();。以下是面向对象风格中此函数的示例;

<?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';

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

   //检索结果
   $result = $stmt->get_result();

   //获取所有行作为数组
   while($row = $result->fetch_array(MYSQLI_ASSOC)){	
      print("Name: ".$row["Name"]."\n");
      print("Age: ".$row["Age"]."\n");
   }

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

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

输出结果

创建表.....
Name: Raju
Age: 25
Name: Rahman
Age: 30

在线示例

您还可以将结果行的内容检索为数字数组:

<?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')");
   mysqli_query($con, "INSERT INTO myplayers values(3, 'Kumara', 'Sangakkara', 'Matale', 'Srilanka')");
   print("插入记录.....\n");

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

   //获取所有行作为数组
   while($row = mysqli_fetch_array($res, MYSQLI_NUM)){
      print("ID: ".$row[0]."\n");
      print("First_Name: ".$row[1]."\n");
      print("Last_Name: ".$row[2]."\n");
      print("Place_Of_Birth: ".$row[3]."\n");
      print("Country: ".$row[4]."\n");
   }
   //结束语句
   mysqli_free_result($res);

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

输出结果

创建表.....
插入记录.....
ID: 1
First_Name: Sikhar
Last_Name: Dhawan
Place_Of_Birth: Delhi
Country: India
ID: 2
First_Name: Jonathan
Last_Name: Trott
Place_Of_Birth: CapeTown
Country: SouthAfrica
ID: 3
First_Name: Kumara
Last_Name: Sangakkara
Place_Of_Birth: Matale
Country: Srilanka

PHP MySQLi 参考手册