PHP mysqli_stmt_result_metadata() 函数用法及示例

PHP MySQLi 参考手册

mysqli_stmt_result_metadata()函数从准备好的语句返回结果集元数据。

定义和用法

mysqli_stmt_result_metadata()函数接受预准备语句对象作为参数，如果给定语句执行SELECT查询(或任何其他返回结果集的查询)，则它(此函数)返回一个元数据对象，该对象保存有关给定语句结果集的信息。

语法

mysqli_stmt_result_metadata($stmt);

参数

返回值

PHP mysqli_stmt_result_metadata()函数在成功时返回元数据对象，在失败时返回false。

PHP版本

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

在线示例

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

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

   mysqli_query($con, "CREATE TABLE test(Name VARCHAR(255), age INT)");
   mysqli_query($con, "INSERT INTO test values('Raju', 25)");
   mysqli_query($con, "INSERT INTO test values('Jonathan', 30)");
   print("创建表.....\n");

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

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

   //检索结果设置元数据
   $metadata = mysqli_stmt_result_metadata($stmt);
   print_r(mysqli_fetch_fields($metadata));
 
   mysqli_free_result($metadata);

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

输出结果

创建表.....
Array
(
    [0] => stdClass Object
        (
            [name] => Name
            [orgname] => Name
            [table] => test
            [orgtable] => test
            [def] =>
            [db] => mydb
            [catalog] => def
            [max_length] => 0
            [length] => 765
            [charsetnr] => 33
            [flags] => 0
            [type] => 253
            [decimals] => 0
        )

    [1] => stdClass Object
        (
            [name] => AGE
            [orgname] => AGE
            [table] => test
            [orgtable] => test
            [def] =>
            [db] => mydb
            [catalog] => def
            [max_length] => 0
            [length] => 11
            [charsetnr] => 63
            [flags] => 32768
            [type] => 3
            [decimals] => 0
        )

)

在线示例

在面向对象风格中，此函数的语法为$stmt-> result_metadata();。以下是面向对象风格中此函数的示例；

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

   //检索结果设置元数据
   $metadata = $stmt->result_metadata();

   $field = $metadata->fetch_field();
   print("字段名称: ".$field->name);

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

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

输出结果

创建表.....
插入记录.....
字段名称: Name

PHP MySQLi 参考手册