PHP mysqli_multi_query() 函数用法及示例

PHP MySQLi 参考手册

mysqli_multi_query()函数执行一个或多个针对数据库的查询。多个查询用分号进行分隔。

定义和用法

mysqli_multi_query()函数接受表示查询的字符串值作为参数之一,并在数据库上执行/执行给定的查询。

执行一个 SQL 语句,或者多个使用分号分隔的 SQL 语句。
要获得执行结果中的第一个结果集,请使用 mysqli_use_result() 或 mysqli_store_result() 函数。 要读取后续的结果集, 请使用 mysqli_more_results() 和 mysqli_next_result() 函数。

语法

mysqli_multi_query($con, query)

参数

序号参数及说明
1

con(必需)

这是一个表示与MySQL Server的连接的对象。

2

query(必需)

这是一个字符串值,表示要执行的查询。

3

mode(可选)

这是表示结果模式的整数值。您可以将MYSQLI_USE_RESULTMYSQLI_STORE_RESULT 作为值传递给此参数。

返回值

 如果第一个 SQL 语句就失败了,返回 FALSE。 如果是批量执行 SQL 语句, 必须首先调用 mysqli_next_result() 函数,才可以获取后续语句的错误信息。

PHP版本

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

在线示例

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

<?php
   //建立连接
   $con = mysqli_connect("localhost", "root", "password", "mydb");
   $query = "CREATE TABLE Test(Name VARCHAR(255), AGE INT); insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)";
   mysqli_multi_query($con, $query);
   print("Data added......");
   //关闭连接
   mysqli_close($con);
?>

输出结果

Data added......

如果您观察数据库中表的内容,则可以看到插入的记录,如下所示:

mysql> select * from players;
+------------+-----------+-------------+
| First_Name | Last_Name | Country     |
+------------+-----------+-------------+
| Shikhar    | Dhawan    | India       |
| Jonathan   | Trott     | SouthAfrica |
+------------+-----------+-------------+
2 rows in set (0.00 sec)

在线示例

在面向对象的样式中,此函数的语法为$con-> multi_query();。以下是面向对象样式中此函数的示例;

<?php
   $con = new mysqli("localhost", "root", "password", "mydb");
   $query = "CREATE TABLE Test(Name VARCHAR(255), AGE INT); insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)";
   //将记录插入到players表中
   $con->multi_query($query);
   print("Data Created......");
   //关闭连接
   $res = $con -> close();
?>

输出结果

Data added......

在线示例

下面的示例创建一个表并使用mysqli_multi_query()函数一个接一个地执行查询来填充它-

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

   mysqli_multi_query($con, "CREATE TABLE IF NOT EXISTS my_team(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("已创建表 ..."."\n");

   //将记录插入到my_team表中
   mysqli_multi_query($con, "insert into my_team values(1, 'Shikhar', 'Dhawan', 'Delhi', 'India')");
   mysqli_multi_query($con, "insert into my_team values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   mysqli_multi_query($con, "insert into my_team values(3, 'Kumara', 'Sangakkara', 'Matale', 'Srilanka')");
   mysqli_multi_query($con, "insert into my_team values(4, 'Virat', 'Kohli', 'Delhi', 'India')");

   print("插入记录 ..."."\n");

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

输出结果

已创建表 ...
插入记录 ...

在线示例

假设我们已经在数据库中创建了一个表Players并填充了它,如下所示-

CREATE TABLE Players (Name VARCHAR(255), Age INT, Score INT);
insert into Players values('Dhavan', 33, 90),('Rohit', 28, 26),('Kohli', 25, 50);

以下示例从mysqli_multi_query函数检索结果集-

<?php
   //建立连接
   $con = mysqli_connect("localhost", "root", "password", "mydb");

   //执行多重查询
   $query = "SELECT * FROM players;CREATE TABLE Test (Name VARCHAR(255), Age INT);insert into Test values('Raju', 25),('Rahman', 30),('Ramani', 22);SELECT * FROM Test";

   $res = mysqli_multi_query($con, $query);

   if ($res) {
      do {
         if ($result = mysqli_use_result($con)) {
            while ($row = mysqli_fetch_row($result)) {
               print("Name: ".$row[0]."\n");
               print("Age: ".$row[1]."\n");
            }
            mysqli_free_result($result);
         }
         if (mysqli_more_results($con)) {
            print("\n");
         }
      } while (mysqli_next_result($con));
   }
   mysqli_close($con);
?>

输出结果

Name: Dhavan
Age: 33
Name: Rohit
Age: 28
Name: Kohli
Age: 25

Name: Raju
Age: 25
Name: Rahman
Age: 30
Name: Ramani
Age: 22

PHP MySQLi 参考手册