PDOStatement::fetch 函数

适用PHP版本

PHP 5.1.0及以上版本

函数说明

PDOStatement::fetch() 函数用于从数据集中获取一行数据，并返回一个与结果集的当前行相对应的关联数组、数字数组或对象，具体取决于传递给函数的模式。

函数语法

PDOStatement::fetch(int $fetch_style = PDO::FETCH_ASSOC, int $fetch_argument = null, array $ctor_args = array()): mixed

参数

• $fetch_style (可选) - 规定返回数据的类型，可以是以下常量之一：
  • PDO::FETCH_ASSOC - 返回关联数组（默认）
  • PDO::FETCH_NUM - 返回数字数组
  • PDO::FETCH_BOTH - 返回关联数组和数字数组（默认行为）
  • PDO::FETCH_OBJ - 返回对象
  • PDO::FETCH_COLUMN - 仅返回单列的值
• $fetch_argument (可选) - 如果选择了 PDO::FETCH_COLUMN，此参数指定返回列的索引。
• $ctor_args (可选) - 该参数提供构造函数参数（当返回对象时），通常传递给返回对象的构造函数。

返回值

成功时，返回一行数据，如果数据已被取出，则返回该行，否则返回 false。

示例

假设我们已经连接到数据库，并执行了一个查询：

$stmt = $pdo->query('SELECT name, email FROM users');

我们可以使用 PDOStatement::fetch() 来获取单条记录：

$row = $stmt->fetch(PDO::FETCH_ASSOC);
echo $row['name'];  // 输出该行的 name 列的值
echo $row['email']; // 输出该行的 email 列的值

示例代码的说明

在上述示例中，首先通过查询获得结果集。接着，使用 fetch(PDO::FETCH_ASSOC) 从结果集中取出一行数据，并以关联数组的形式返回。通过访问数组的键，我们能够获取各列的数据。