mysqli::multi_query
mysqli_multi_query
(PHP 5, PHP 7)
mysqli::multi_query -- mysqli_multi_query — 执行查询
说明
面向对象风格
mysqli::multi_query (
string
$query ) :
bool
过程化风格
执行一个 SQL 语句，或者多个使用分号分隔的 SQL 语句。
要获得执行结果中的第一个结果集，请使用 mysqli_use_result() 或 mysqli_store_result() 函数。 要读取后续的结果集， 请使用 mysqli_more_results() 和 mysqli_next_result() 函数。
返回值
如果第一个 SQL 语句就失败了，返回 FALSE。 如果是批量执行 SQL 语句， 必须首先调用 mysqli_next_result() 函数，才可以获取后续语句的错误信息。
范例
Example #1 mysqli::multi_query() 例程
面向对象风格
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* 检查连接 */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT CURRENT_USER();";
$query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5";
/* 批量执行查询 */
if ($mysqli->multi_query($query)) {
do {
/* store first result set */
if ($result = $mysqli->store_result()) {
while ($row = $result->fetch_row()) {
printf("%s\n", $row[0]);
}
$result->free();
}
/* print divider */
if ($mysqli->more_results()) {
printf("-----------------\n");
}
} while ($mysqli->next_result());
}
/* 关闭连接 */
$mysqli->close();
?>
过程化风格
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* 检查连接 */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT CURRENT_USER();";
$query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5";
/* 批量执行查询 */
if (mysqli_multi_query($link, $query)) {
do {
/* store first result set */
if ($result = mysqli_store_result($link)) {
while ($row = mysqli_fetch_row($result)) {
printf("%s\n", $row[0]);
}
mysqli_free_result($result);
}
/* print divider */
if (mysqli_more_results($link)) {
printf("-----------------\n");
}
} while (mysqli_next_result($link));
}
/* 关闭连接 */
mysqli_close($link);
?>
以上例程的输出类似于：
my_user@localhost ----------------- Amersfoort Maastricht Dordrecht Leiden Haarlemmermeer
参见
- mysqli_query() - 对数据库执行一次查询
- mysqli_use_result() - Initiate a result set retrieval
- mysqli_store_result() - 转移上一次查询返回的结果集
- mysqli_next_result() - 为读取 multi_query 执行之后的下一个结果集做准备
- mysqli_more_results() - 检查批量查询中是否还有查询结果
