(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDOStatement::fetch — 從結果集中獲取下一行
$fetch_style = ?, int $cursor_orientation = PDO::FETCH_ORI_NEXT, int $cursor_offset = 0): mixed
從一個(gè) PDOStatement 對象相關(guān)的結果集中獲取下一行。fetch_style 參數決定 POD 如何返回行。
fetch_style
控制下一行如何返回給調用者。此值必須是 PDO::FETCH_* 系列常量中的一個(gè)，缺省為 PDO::ATTR_DEFAULT_FETCH_MODE 的值 （默認為 PDO::FETCH_BOTH ）。
PDO::FETCH_ASSOC：返回一個(gè)索引為結果集列名的數組
PDO::FETCH_BOTH（默認）：返回一個(gè)索引為結果集列名和以0開(kāi)始的列號的數組
PDO::FETCH_BOUND：返回 true ，并分配結果集中的列值給 PDOStatement::bindColumn() 方法綁定的 PHP 變量。
PDO::FETCH_CLASS：返回一個(gè)請求類(lèi)的新實(shí)例，映射結果集中的列名到類(lèi)中對應的屬性名。如果 fetch_style 包含 PDO::FETCH_CLASSTYPE（例如：PDO::FETCH_CLASS |
PDO::FETCH_CLASSTYPE），則類(lèi)名由第一列的值決定
PDO::FETCH_INTO：更新一個(gè)被請求類(lèi)已存在的實(shí)例，映射結果集中的列到類(lèi)中命名的屬性
PDO::FETCH_LAZY：結合使用 PDO::FETCH_BOTH 和 PDO::FETCH_OBJ，創(chuàng )建供用來(lái)訪(fǎng)問(wèn)的對象變量名
PDO::FETCH_NUM：返回一個(gè)索引為以0開(kāi)始的結果集列號的數組
PDO::FETCH_OBJ：返回一個(gè)屬性名對應結果集列名的匿名對象
cursor_orientation
對于 一個(gè) PDOStatement 對象表示的可滾動(dòng)游標，該值決定了哪一行將被返回給調用者。此值必須是 PDO::FETCH_ORI_* 系列常量中的一個(gè)，默認為 PDO::FETCH_ORI_NEXT。要想讓 PDOStatement 對象使用可滾動(dòng)游標，必須在用 PDO::prepare() 預處理SQL語(yǔ)句時(shí)，設置 PDO::ATTR_CURSOR 屬性為 PDO::CURSOR_SCROLL。
offset
對于一個(gè) cursor_orientation 參數設置為 PDO::FETCH_ORI_ABS 的PDOStatement 對象代表的可滾動(dòng)游標，此值指定結果集中想要獲取行的絕對行號。
對于一個(gè) cursor_orientation 參數設置為 PDO::FETCH_ORI_REL 的PDOStatement 對象代表的可滾動(dòng)游標，此值指定想要獲取行相對于調用 PDOStatement::fetch() 前游標的位置
此函數（方法）成功時(shí)返回的值依賴(lài)于提取類(lèi)型。在所有情況下，失敗都返回 false 。
示例 #1 使用不同的提取方式獲取行
<?php
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
$sth->execute();
/* 運用 PDOStatement::fetch 風(fēng)格 */
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");
?>
以上例程會(huì )輸出：
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
示例 #2 使用一個(gè)可滾動(dòng)游標獲取行
<?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);
?>
以上例程會(huì )輸出：
Reading forwards: 21 10 5 16 0 5 19 20 10 Reading backwards: 19 20 10 16 0 5 21 10 5