閱讀(510) 書簽贊(0) 我要糾錯(cuò)

PHP8 PDOStatement::fetch

2024-03-26 09:50 更新

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDOStatement::fetch — 從結(jié)果集中獲取下一行

說明

public PDOStatement::fetch(int $mode = PDO::FETCH_DEFAULT, int $cursorOrientation = PDO::FETCH_ORI_NEXT, int $cursorOffset = 0): mixed

從一個(gè) PDOStatement 對(duì)象相關(guān)的結(jié)果集中獲取下一行。mode 參數(shù)決定 POD 如何返回行。

參數(shù)

mode

控制下一行如何返回給調(diào)用者。此值必須是 PDO::FETCH_* 系列常量中的一個(gè)，缺省為 PDO::ATTR_DEFAULT_FETCH_MODE 的值（默認(rèn)為 PDO::FETCH_BOTH ）。

PDO::FETCH_ASSOC：返回一個(gè)索引為結(jié)果集列名的數(shù)組
PDO::FETCH_BOTH（默認(rèn)）：返回一個(gè)索引為結(jié)果集列名和以0開始的列號(hào)的數(shù)組
PDO::FETCH_BOUND：返回 true ，并分配結(jié)果集中的列值給 PDOStatement::bindColumn() 方法綁定的 PHP 變量。
PDO::FETCH_CLASS：返回一個(gè)請(qǐng)求類的新實(shí)例，映射結(jié)果集中的列名到類中對(duì)應(yīng)的屬性名，然后調(diào)用構(gòu)造函數(shù)，除非指定 PDO::FETCH_PROPS_LATE。如果 mode 包含 PDO::FETCH_CLASSTYPE（例如：PDO::FETCH_CLASS | PDO::FETCH_CLASSTYPE），則類名由第一列的值決定
PDO::FETCH_INTO：更新一個(gè)被請(qǐng)求類已存在的實(shí)例，映射結(jié)果集中的列到類中命名的屬性
PDO::FETCH_LAZY：PDO::FETCH_BOTH 和 PDO::FETCH_OBJ 組合使用，返回 PDORow 對(duì)象，該對(duì)象在訪問時(shí)創(chuàng)建對(duì)象屬性名。
PDO::FETCH_NAMED：返回與 PDO::FETCH_ASSOC 具有相同形式的數(shù)組，除了如果有多個(gè)同名列，則該鍵引用的值將是具有該列名的行中所有值的數(shù)組
PDO::FETCH_NUM：返回一個(gè)索引為以0開始的結(jié)果集列號(hào)的數(shù)組
PDO::FETCH_OBJ：返回一個(gè)屬性名對(duì)應(yīng)結(jié)果集列名的匿名對(duì)象
PDO::FETCH_PROPS_LATE：當(dāng)與 PDO::FETCH_CLASS 一起使用時(shí)，類的構(gòu)造方法在從相應(yīng)的列值分配屬性之前被調(diào)用。

cursorOrientation

對(duì)于一個(gè) PDOStatement 對(duì)象表示的可滾動(dòng)游標(biāo)，該值決定了哪一行將被返回給調(diào)用者。此值必須是 PDO::FETCH_ORI_* 系列常量中的一個(gè)，默認(rèn)為 PDO::FETCH_ORI_NEXT。要想讓 PDOStatement 對(duì)象使用可滾動(dòng)游標(biāo)，必須在用 PDO::prepare() 預(yù)處理SQL語句時(shí)，設(shè)置 PDO::ATTR_CURSOR 屬性為 PDO::CURSOR_SCROLL。

cursorOffset

對(duì)于一個(gè) cursorOrientation 參數(shù)設(shè)置為 PDO::FETCH_ORI_ABS 的 PDOStatement 對(duì)象代表的可滾動(dòng)游標(biāo)，此值指定結(jié)果集中想要獲取行的絕對(duì)行號(hào)。

對(duì)于一個(gè) cursorOrientation 參數(shù)設(shè)置為 PDO::FETCH_ORI_REL 的 PDOStatement 對(duì)象代表的可滾動(dòng)游標(biāo)，此值指定想要獲取行相對(duì)于調(diào)用 PDOStatement::fetch() 前游標(biāo)的位置

返回值

此方法成功時(shí)返回的值依賴于獲取類型。在所有情況下，失敗或沒有更多記錄時(shí)都返回 false。

錯(cuò)誤／異常

如果屬性 PDO::ATTR_ERRMODE 設(shè)置為 PDO::ERRMODE_WARNING，則發(fā)出級(jí)別為 E_WARNING 的錯(cuò)誤。

如果屬性 PDO::ATTR_ERRMODE 設(shè)置為 PDO::ERRMODE_EXCEPTION，則拋出 PDOException。

示例

示例 #1 使用不同的提取方式獲取行

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

/* 運(yùn)用 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 a PDORow 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 a PDORow 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)游標(biāo)獲取行

<?php
function readDataForwards($dbh) {
    $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY BET';
    $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;
    }
}
function readDataBackwards($dbh) {
    $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY bet';
    $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));
}

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

示例 #3 構(gòu)造順序

當(dāng)通過 PDO::FETCH_CLASS 獲取對(duì)象時(shí)，首先分配對(duì)象屬性，然后調(diào)用類的構(gòu)造方法。如果還指定了 PDO::FETCH_PROPS_LATE，則此順序相反，即首先調(diào)用構(gòu)造方法，然后分配屬性。

<?php
class Person
{
    private $name;

    public function __construct()
    {
        $this->tell();
    }

    public function tell()
    {
        if (isset($this->name)) {
            echo "I am {$this->name}.\n";
        } else {
            echo "I don't have a name yet.\n";
        }
    }
}

$sth = $dbh->query("SELECT * FROM people");
$sth->setFetchMode(PDO::FETCH_CLASS, 'Person');
$person = $sth->fetch();
$person->tell();
$sth->setFetchMode(PDO::FETCH_CLASS|PDO::FETCH_PROPS_LATE, 'Person');
$person = $sth->fetch();
$person->tell();
?>

以上示例的輸出類似于：

I am Alice.
I am Alice.
I don't have a name yet.
I am Bob.

參見

PDO::prepare() - 預(yù)處理要執(zhí)行的語句，并返回語句對(duì)象
PDOStatement::execute() - 執(zhí)行預(yù)處理語句
PDOStatement::fetchAll() - 從結(jié)果集中獲取剩余的行
PDOStatement::fetchColumn() - 從結(jié)果集中的下一行返回單獨(dú)的一列
PDOStatement::fetchObject() - 獲取下一行并作為一個(gè)對(duì)象返回
PDOStatement::setFetchMode() - 為語句設(shè)置默認(rèn)的獲取模式

以上內(nèi)容是否對(duì)您有幫助：

← PHP8 PDOStatement::execute

PHP8 PDOStatement::fetchAll →

寫筆記

我要補(bǔ)充