PHP mysqli_fetch_fields() 函数用法及示例

    PHP MySQLi 参考手册

mysqli_fetch_fields()函数返回结果集中代表字段(列)的对象的数组。

定义和用法

PHP结果对象(属于mysqli_result类)表示由SELECT或DESCRIBE或EXPLAIN查询返回的MySQL结果。
mysqli_fetch_fields函数的作用是:接受一个结果对象作为参数,并返回一个对象数组,每个对象表示结果中的一个字段。

语法

mysqli_fetch_fields($result);

参数

序号参数及说明
1

result(必需)

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

返回值

PHP mysqli_fetch_fields()函数返回一个对象数组,其中每个对象都包含给定结果中字段的定义信息。如果没有信息,此函数将返回FALSE

返回数组的对象包含以下属性$ minus;。

  • name - 列名

  • orgname - 原始的列名(如果指定了别名)

  • table - 表名

  • orgtable - 原始的表名(如果指定了别名)

  • def - 该字段的默认值

  • max_length - 字段的最大宽度

  • length - 在表定义中指定的字段宽度

  • charsetnr - 字段的字符集号

  • flags - 字段的位标志

  • type - 用于字段的数据类型

  • decimals - 整数字段,小数点后的位数

PHP版本

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

在线示例

以下示例演示了mysqli_fetch_fields()函数的用法(面向过程风格)-

<?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");

   //获取所有字段
   $info = mysqli_fetch_fields($res);
   foreach ($info as $ele) {
      print("ID: ".$ele->name."\n");
      print("First_Name: ".$ele->table."\n");
      print("Last_Name: ".$ele->max_length."\n");
      print("Place_Of_Birth: ".$ele->charsetnr."\n");
      print("Country: ".$ele->flags."\n");
      print("Country: ".$ele->type."\n");
      print("\n");
   }
   //结束语句
   mysqli_free_result($res);

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

输出结果

创建表.....
插入记录.....
ID: ID
First_Name: myplayers
Last_Name: 1
Place_Of_Birth: 63
Country: 32768
Country: 3

ID: First_Name
First_Name: myplayers
Last_Name: 8
Place_Of_Birth: 33
Country: 0
Country: 253

ID: Last_Name
First_Name: myplayers
Last_Name: 10
Place_Of_Birth: 33
Country: 0
Country: 253

ID: Place_Of_Birth
First_Name: myplayers
Last_Name: 8
Place_Of_Birth: 33
Country: 0
Country: 253

ID: Country
First_Name: myplayers
Last_Name: 11
Place_Of_Birth: 33
Country: 0
Country: 253

在线示例

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

<?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();

   //获取所有行作为数组
   $info = $result->fetch_fields();
   foreach ($info as $ele) {
      print("ID: ".$ele->name."\n");
      print("First_Name: ".$ele->table."\n");
      print("Last_Name: ".$ele->max_length."\n");
      print("Place_Of_Birth: ".$ele->charsetnr."\n");
      print("Country: ".$ele->flags."\n");
      print("Country: ".$ele->type."\n");
      print("\n");
   }
   //结束语句
   $stmt->close();

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

PHP MySQLi 参考手册