PHP MySQLi 函数

PHP mysqli::query() / mysqli_query() 函数用于对数据库执行查询。

对于非 DML 查询（不是 INSERT、UPDATE 或 DELETE），此函数类似于调用 mysqli_real_query() 后跟 mysqli_use_result() 或 mysqli_store_result()。

注意:当传递的语句长度超过服务器的max_allowed_pa​​cket时，该函数根据MySQL Native Driver (mysqlnd)还是MySQL返回不同的错误代码正在使用客户端库（libmysqlclient）。行为如下:

  • Linux 上的 mysqlnd 返回错误代码 1153。该错误消息意味着收到的数据包大于 max_allowed_pa​​cket 字节。
  • Windows 上的 mysqlnd 返回错误代码 2006。此错误消息意味着服务器已消失。
  • 所有平台上的 libmysqlclient 返回错误代码 2006。此错误消息意味着服务器已消失。

语法

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

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

参数

mysql 必填。 仅适用于面向过程风格:指定 mysqli_connect() 或 mysqli_init() 返回的 mysqli 对象。
查询 必填。 指定 SQL 查询字符串。
result_mode 可选。 指定结果模式。它指示如何从 MySQL 服务器返回结果。它可以是以下之一:
  • MYSQLI_STORE_RESULT（默认）- 返回带有缓冲结果集的 mysqli_result 对象。
  • MYSQLI_USE_RESULT - 返回带有未缓冲结果集的 mysqli_result 对象。只要有待获取的记录，连接线路就会繁忙，所有后续调用都会返回错误:命令不同步。为了避免该错误，必须从服务器获取所有记录，或者必须通过调用 mysqli_free_result() 丢弃结果集。
  • MYSQLI_ASYNC（可与 mysqlnd 一起使用）- 执行查询异步并且不会立即返回结果集。然后使用 mysqli_poll() 从此类查询中获取结果。与 MYSQLI_STORE_RESULT 或 MYSQLI_USE_RESULT 常量结合使用。

返回值

失败时返回 false 。对于生成结果集的成功查询，例如 SELECT、SHOW、DESCRIBE 或 EXPLAIN，此函数将返回 mysqli_result 对象。对于其他成功的查询，此函数将返回true。

示例:面向对象风格

下面的示例显示mysqli::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 EmpID, Name, Age FROM Employee ORDER BY Age";
$result = $mysqli->query($sql);

//关闭连接
$mysqli->close();

//获取结果集中的行数
$row_cnt = $result->num_rows;
printf("Result set has %d rows.\n", $row_cnt);
?>

上述代码的输出将类似于:

Result set has 58 rows.

示例:面向过程风格

下面的示例显示了mysqli_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 EmpID, Name, Age FROM Employee ORDER BY Age";
$result = mysqli_query($mysqli, $sql);

//关闭连接
mysqli_close($mysqli);

//获取结果集中的行数
$row_cnt = mysqli_num_rows($result);
printf("Result set has %d rows.\n", $row_cnt);
?>

上述代码的输出将类似于:

Result set has 58 rows.