PHP Conference Japan 2024

    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

    参见

    发现问题？

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

    用户贡献的注释 2 条注释

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

    <?php
    do {
    $pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
    } while (
    $pdoStatement->nextRowset()
    );
    ?>
    当我获取第二个 nextRowset 的大型 fetchAll（超过 30 个）时，我收到错误 - 分段错误。

    使用分步而不是 do..while 是此错误的修复方法
    <?php
    $pdoStatement    ->fetchAll(\PDO::FETCH_ASSOC);
    $pdoStatement->nextRowset();
    $pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
    ?>
    ＋添加注释
    To Top