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_RESULT 或 MYSQLI_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