PHP MySQLi 函数

PHP mysqli::store_result() / mysqli_store_result() 函数用于传输上次的结果集对 mysql 参数表示的数据库连接进行查询。

语法

//面向对象风格
public mysqli::store_result(mode)

//面向过程风格
mysqli_store_result(mysql, mode)

参数

mysql 必填。 仅适用于面向过程风格:指定 mysqli_connect() 或 mysqli_init() 返回的 mysqli 对象。
模式 可选。 指定选项。它可以是以下之一:
  • MYSQLI_STORE_RESULT_COPY_DATA - 将结果从内部 mysqlnd 缓冲区复制到获取的 PHP 变量中。默认情况下，mysqlnd 将使用引用逻辑来避免复制和重复内存中保存的结果。对于某些结果集，例如包含许多小行的结果集，复制方法可以减少总体内存使用量，因为保存结果的 PHP 变量可能会提前释放（仅适用于 mysqlnd）。
td>

返回值

返回缓冲结果对象，如果发生错误，则返回 false。

注意:如果查询没有返回结果集或者读取结果集失败，则该函数返回 false。成功调用 mysqli_query() 后此函数返回 false 的可能原因可能是结果集太大。

示例:面向对象风格

下面的示例展示了mysqli::store_result()方法的用法。

<?php
//建立与数据库的连接
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->connect_errno) {
  echo "Failed to connect to MySQL: ". $mysqli->connect_error;
  exit();
}

//包含多个查询的字符串
$sql = "SELECT CURRENT_USER();";
$sql .= "SELECT Name FROM Employee";

//执行多个查询
$mysqli->multi_query($sql);
do {
  //用PHP存储结果集
  if ($result = $mysqli->store_result()) {
    while ($row = $result->fetch_row()) {
      printf("%s\n", $row[0]);
    }
  }

  //如果有更多结果集，则打印分隔符
  if ($mysqli->more_results()) {
    printf("--------------\n");
  }
} while ($mysqli->next_result());

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

上述代码的输出将类似于:

user@localhost
--------------
Marry
Kim
John
Adam

示例:面向过程风格

下面的示例显示mysqli_store_result( ) 函数。

<?php
//建立与数据库的连接
$mysqli = mysqli_connect("localhost", "user", "password", "database");
if (mysqli_connect_errno()) {
  echo "Failed to connect to MySQL: ". mysqli_connect_error();
  exit();
}

//包含多个查询的字符串
$sql = "SELECT CURRENT_USER();";
$sql .= "SELECT Name FROM Employee";

//执行多个查询
mysqli_multi_query($mysqli, $sql);
do {
  //用PHP存储结果集
  if ($result = mysqli_store_result($mysqli)) {
    while ($row = mysqli_fetch_row($result)) {
      printf("%s\n", $row[0]);
    }
  }
  
  //如果有更多结果集，则打印分隔符
  if (mysqli_more_results($mysqli)) {
    printf("--------------\n");
  }
} while (mysqli_next_result($mysqli));

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

上述代码的输出将类似于:

user@localhost
--------------
Marry
Kim
John
Adam