PDOStatement::fetch

PHP PDO 参考手册Справочное руководство по PHP PDO

PDOStatement::fetch — Извлекает следующую строку из набора результатов (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

Описание

Синтаксис

mixed PDOStatement::fetch ([ int $fetch_style [, int $cursor_orientation = PDO::FETCH_ORI_NEXT [, int $cursor_offset = 0 ]]] )

Извлекает следующую строку из набора результатов, связанного с объектом PDOStatement. Параметр fetch_style определяет, как PDO возвращает строку.

Parameters

fetch_style

Управляет тем, как следующая строка будет возвращена вызывающей стороне. Это значение должно быть одной из констант PDO::FETCH_*, по умолчанию принимая значение PDO::ATTR_DEFAULT_FETCH_MODE (которое по умолчанию равно PDO::FETCH_BOTH).

  • PDO::FETCH_ASSOC: возвращает массив, индексированный именами столбцов набора результатов

  • PDO::FETCH_BOTH(по умолчанию): возвращает массив, индексированный как именами столбцов набора результатов, так и номерами столбцов, начиная с 0

  • PDO::FETCH_BOUND: возвращаетTRUE, и присваивает значения столбцов в наборе результатов PHP-переменным, привязанным методом PDOStatement::bindColumn().

  • PDO::FETCH_CLASS: возвращает новый экземпляр запрошенного класса, сопоставляя столбцы набора результатов с соответствующими именами свойств в классе. Еслиfetch_styleсодержит PDO::FETCH_CLASSTYPE (например,PDO::FETCH_CLASS | PDO::FETCH_CLASSTYPE), имя класса определяется значением первого столбца

  • PDO::FETCH_INTO: обновляет существующий экземпляр запрошенного класса, сопоставляя столбцы результирующего набора именованным свойствам класса

  • PDO::FETCH_LAZY: используется в сочетании сPDO::FETCH_BOTHиPDO::FETCH_OBJ, создаёт имена переменных объекта для доступа

  • PDO::FETCH_NUM: возвращает массив, индексированный номерами столбцов результирующего набора, начиная с 0

  • PDO::FETCH_OBJ: возвращает анонимный объект, имена свойств которого соответствуют именам столбцов результирующего набора

cursor_orientation
Для прокручиваемого курсора, представленного объектом PDOStatement, это значение определяет, какая строка будет возвращена вызывающей стороне. Это значение должно быть одной из констант PDO::FETCH_ORI_*, по умолчанию — PDO::FETCH_ORI_NEXT. Чтобы объект PDOStatement использовал прокручиваемый курсор, необходимо установить атрибут PDO::ATTR_CURSOR в PDO::CURSOR_SCROLL при подготовке SQL-инструкции с помощью PDO::prepare().

offset
Для прокручиваемого курсора, представленного объектом PDOStatement с параметром cursor_orientation, установленным в PDO::FETCH_ORI_ABS, это значение задаёт абсолютный номер строки, которую нужно извлечь из результирующего набора.
Для прокручиваемого курсора, представленного объектом PDOStatement с параметром cursor_orientation, установленным в PDO::FETCH_ORI_REL, это значение задаёт позицию извлекаемой строки относительно позиции курсора перед вызовом PDOStatement::fetch().

Возвращаемые значения

Значение, возвращаемое этой функцией (методом) при успешном выполнении, зависит от типа выборки. Во всех случаях при неудаче возвращается FALSE.

Примеры

Выборка строк с различными стилями выборки

<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();

/* 运用 PDOStatement::fetch 风格 */
print("PDO::FETCH_ASSOC: ");
print("Return next row as an array indexed by column name\n");
$result = $sth->fetch(PDO::FETCH_ASSOC);
print_r($result);
print("\n");

print("PDO::FETCH_BOTH: ");
print("Return next row as an array indexed by both column name and number\n");
$result = $sth->fetch(PDO::FETCH_BOTH);
print_r($result);
print("\n");

print("PDO::FETCH_LAZY: ");
print("Return next row as an anonymous object with column names as properties\n");
$result = $sth->fetch(PDO::FETCH_LAZY);
print_r($result);
print("\n");

print("PDO::FETCH_OBJ: ");
print("Return next row as an anonymous object with column names as properties\n");
$result = $sth->fetch(PDO::FETCH_OBJ);
print $result->NAME;
print("\n");
?>

Приведённый выше пример выведет:

PDO::FETCH_ASSOC: Return next row as an array indexed by column name
Array
(
    [NAME] => apple
    [COLOUR] => red
)

PDO::FETCH_BOTH: Return next row as an array indexed by both column name and number
Array
(
    [NAME] => banana
    [0] => banana
    [COLOUR] => yellow
    [1] => yellow
)

PDO::FETCH_LAZY: Return next row as an anonymous object with column names as properties
PDORow Object
(
    [NAME] => orange
    [COLOUR] => orange
)

PDO::FETCH_OBJ: Return next row as an anonymous object with column names as properties
kiwi

Выборка строк с использованием прокручиваемого курсора

<?php
function readDataForwards($dbh) {
  $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY BET';
  try {
    $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL));
    $stmt->execute();
    while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_NEXT)) {
      $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n";
      print $data;
    }
    $stmt = null;
  }
  catch (PDOException $e) {
    print $e->getMessage();
  }
}
function readDataBackwards($dbh) {
  $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY bet';
  try {
    $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL));
    $stmt->execute();
    $row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_LAST);
    do {
      $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n";
      print $data;
    } while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_PRIOR));
    $stmt = null;
  }
  catch (PDOException $e) {
    print $e->getMessage();
  }
}

print "Reading forwards:\n";
readDataForwards($conn);

print "Reading backwards:\n";
readDataBackwards($conn);
?>

Приведённый выше пример выведет:

Reading forwards:
21    10    5
16    0     5
19    20    10

Reading backwards:
19    20    10
16    0     5
21    10    5

PHP PDO 参考手册Справочное руководство по PHP PDO

Другие расширения