PDOStatement::nextRowset

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

    PDOStatement::nextRowset — 进入多行集语句句柄中的下一个行集

    描述

    public PDOStatement::nextRowset(): bool

    一些数据库服务器支持返回多个行集（也称为结果集）的存储过程。 PDOStatement::nextRowset() 允许您访问与 PDOStatement 对象关联的第二个和后续行集。每个行集可以与前一个行集具有不同的列集。

    参数

    此函数没有参数。

    返回值

    成功时返回 true，失败时返回 false。

    范例

    范例 #1 获取从存储过程返回的多个行集

    以下示例展示了如何调用存储过程 MULTIPLE_ROWSETS，该过程返回三个行集。我们使用 do-while 循环来调用 PDOStatement::nextRowset() 方法，直到它返回 false，并在没有更多行集可用时终止循环。

    <?php
    $sql     = 'CALL multiple_rowsets()';
    $stmt = $conn->query($sql);
    $i = 1;
    do {
    $rowset = $stmt->fetchAll(PDO::FETCH_NUM);
    if (    $rowset) {
    printResultSet($rowset, $i);
    }
    $i++;
    } while (    $stmt->nextRowset());

    function     printResultSet(&$rowset, $i) {
    print     "Result set $i:\n";
    foreach (    $rowset as $row) {
    foreach (    $row as $col) {
    print     $col . "\t";
    }
    print     "\n";
    }
    print     "\n";
    }
    ?>

    上面的示例将输出

    Result set 1:
apple    red
banana   yellow

Result set 2:
orange   orange    150
banana   yellow    175

Result set 3:
lime     green
apple    red
banana   yellow

    参见

    改善此页面

    了解如何改善此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献注释 3 个注释

    3
    guilleamathews at gmail dot com
    12 年前
    PDO::nextRowset() 目前似乎不受 Firebird PDO 驱动程序支持。不幸的是。
    -2
    et dot coder at gmail dot com
    9 年前
    在 MSSQL 和 'dsn' => 'dblib:... ' 上，
    如果您知道行集数量，请不要使用 do..while 的构造。

    <?php
    do {
    $pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
    } while (
    $pdoStatement->nextRowset()
    );
    ?>
    当我在第二个 nextRowset 获取大量 fetchAll（超过 30 个）时，出现错误 - Segmentation fault。

    使用逐步骤而不是 do..while 解决了此错误
    <?php
    $pdoStatement    ->fetchAll(\PDO::FETCH_ASSOC);
    $pdoStatement->nextRowset();
    $pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
    ?>
    -8
    alex at 1stleg dot com
    8 年前
    如果您使用 PDO::fetch 而不是 PDO::fetchAll，并且没有到达结果集的末尾，PDO::nextRowset() 将失败，并显示 "SQLSTATE[HY000]: General error: PDO_DBLIB: dbresults() returned FAIL"。
    ＋添加注释
    To Top