上一节:
下一节:

  PHP mysqli_multi_query MySQLi 函数

  • 定义和用法

    mysqli_multi_query - 执行查询

  • 版本支持

    PHP4 PHP5 PHP7
    不支持 支持 支持

  • 语法

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

  • 参数

    参数 必需的 描述
    link 是 由mysqli_connect() 或 mysqli_init() 返回的链接标识。
    query 是 查询语句。 查询语句中的数据一定要正确的进行转义(防止SQL注入)。

  • 返回值

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

  • 示例

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

  • 相关函数

    mysqli_query() - 对数据库执行一次查询
    mysqli_use_result() - 启动结果集检索
    mysqli_store_result() - 转移上一次查询返回的结果集
    mysqli_next_result() - 为读取 multi_query 执行之后的下一个结果集做准备
    mysqli_more_results() - 检查批量查询中是否还有查询结果
返回全部 MySQLi 参考
上一节:
下一节: