PHP MySQLi 函数

PHP mysqli_result::fetch_assoc() / mysqli_fetch_assoc() 函数用于获取结果的下一行设置为关联数组。对此函数的每次后续调用都将返回结果集中的下一行,如果没有更多行,则返回 null。

如果结果的两列或多列具有相同的名称,则最后一列将采用优先并覆盖任何以前的数据。要访问具有相同名称的多个列,可以使用 mysqli_fetch_row() 来获取数字索引数组,或者可以在 SQL 查询选择列表中使用别名来为列指定不同的名称。

语法

//面向对象风格
public mysqli_result::fetch_assoc()

//面向过程风格
mysqli_fetch_assoc(result)

参数

结果 必填。 仅适用于面向过程风格:指定 mysqli_query()、mysqli_store_result()、mysqli_use_result() 或 mysqli_stmt_get_result() 返回的 mysqli_result 对象。

返回值

返回一个表示所获取行的关联数组,其中数组中的每个键表示结果集中某一列的名称,如果结果集中没有更多行,则返回 null,否则返回 false

示例:面向对象风格

下面的示例展示了mysqli_result::fetch_assoc()方法的用法。

<?php
//建立与数据库的连接
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->connect_errno) {
  echo "Failed to connect to MySQL: ". $mysqli->connect_error;
  exit();
}

//从数据库获取查询结果
$sql = "SELECT Name, Age FROM Employee ORDER BY Age";
$result = $mysqli->query($sql);

//获取关联数组
while ($row = $result->fetch_assoc()) {
  printf("%s, %d\n", $row["Name"], $row["Age"]);
}

//免费结果集
$result->free_result();

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

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

Marry, 23
Kim, 26
John, 27
Adam, 28

示例:面向过程风格

下面的示例显示mysqli_fetch_assoc()的用法 函数。

<?php
//建立与数据库的连接
$mysqli = mysqli_connect("localhost", "user", "password", "database");
if (mysqli_connect_errno()) {
  echo "Failed to connect to MySQL: ". mysqli_connect_error();
  exit();
}

//从数据库获取查询结果
$sql = "SELECT Name, Age FROM Employee ORDER BY Age";
$result = mysqli_query($mysqli, $sql);

//获取关联数组
while ($row = mysqli_fetch_assoc($result)) {
  printf("%s, %d\n", $row["Name"], $row["Age"]);
}

//免费结果集
mysqli_free_result($result);

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

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

Marry, 23
Kim, 26
John, 27
Adam, 28

示例:mysqli_result 迭代器和 mysqli_result::fetch_assoc() 用法的比较

mysqli_result 可以使用 foreach 循环进行迭代。无论当前位置如何,结果集始终从第一行开始迭代。

<?php
//建立与数据库的连接
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->connect_errno) {
  echo "Failed to connect to MySQL: ". $mysqli->connect_error;
  exit();
}

$sql = "SELECT Name, Age FROM Employee ORDER BY Age";

//使用迭代器
$result = $mysqli->query($sql);
foreach ($result as $row) {
  printf("%s, %d\n", $row["Name"], $row["Age"]);
}

echo "\n==================\n";

//不使用迭代器
$result = $mysqli->query($sql);
while ($row = $result->fetch_assoc()) {
  printf("%s, %d\n", $row["Name"], $row["Age"]);
}

//免费结果集
$result->free_result();

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

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

Marry, 23
Kim, 26
John, 27
Adam, 28

==================
Marry, 23
Kim, 26
John, 27
Adam, 28