PHP mysqli multi_query()方法

 PHP MySQLi 函数

PHP mysqli::multi_query() / mysqli_multi_query() 函数用于执行一个或多个查询，这些查询是用分号连接。

查询在对数据库的一次调用中异步发送，但数据库按顺序处理它们。该函数等待第一个查询完成，然后将控制权返回给 PHP。然后，MySQL 服务器将处理序列中的下一个查询。一旦下一个结果准备好，MySQL将等待PHP下一次执行mysqli_next_result()。

建议使用do-while来处理多个查询。在所有查询完成并将其结果提取到 PHP 之前，连接将一直处于繁忙状态。在处理所有查询之前，不能在同一连接上发出其他语句。要继续执行序列中的下一个查询，可以使用 mysqli_next_result() 函数。如果下一个结果还没有准备好，mysqli将等待MySQL服务器的响应。要检查是否有更多结果，可以使用 mysqli_more_results() 函数。

对于产生结果集的查询，例如 SELECT、SHOW、DESCRIBE 或 EXPLAIN，可以使用 mysqli_use_result() 或 mysqli_store_result()用于检索结果集。对于不生成结果集的查询，可以使用相同的函数来检索受影响行数等信息。

语法

//面向对象风格
public mysqli::multi_query(query)

//面向过程风格
mysqli_multi_query(mysql, query)

参数

返回值

如果第一个语句失败，则返回 false。要从其他语句中检索后续错误，可以先调用 mysqli_next_result() 函数。

示例:面向对象风格

下面的示例显示 mysqli:: 的用法multi_query() 方法。

<?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_multi_query()函数的用法。

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