PHP PDO 怎么用可滚动游标读取结果集中的指定行

PHP PDO 要读取结果集中的指定行，关键是在 prepare() 时声明 PDO::CURSOR_SCROLL，然后把 PDO::FETCH_ORI_ABS 和目标行号传给 fetch()。例如目标行号为 2 时，调用 $stmt->fetch(PDO::FETCH_ASSOC, PDO::FETCH_ORI_ABS, 2)。这里的行号由 PDO 游标语义决定，不是 SQL 的 LIMIT 偏移量。

官方地址：https://www.php.net/manual/en/pdo.constants.php

可滚动游标解决的是“已经得到一个结果集后，回到其中某个位置读取”的问题。先保证游标在 prepare 阶段创建成功，再用绝对行号读取；如果驱动不支持滚动游标，就不要把 FETCH_ORI_ABS 当成分页方案。

1. 在 prepare 阶段打开可滚动游标

PDO 默认更常见的是前向游标，只能沿结果集继续读取。要使用 FETCH_ORI_ABS，必须在 prepare() 的第二个参数中传入 PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL，之后再 execute()。查询最好带有稳定的 ORDER BY，否则数据库返回的自然顺序变化时，同一个行号可能对应不同记录。

prepare($sql, [
    // 滚动能力必须在创建 PDOStatement 时声明。
    PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL,
]);

$stmt->execute(['status' => 'active']);
?>

注意配置位置：把 ATTR_CURSOR 写在 execute() 的参数里不会改变游标类型；游标属于已经创建的 PDOStatement。

2. 用 FETCH_ORI_ABS 读取指定行

PDOStatement::fetch() 的第二个参数是游标方向，第三个参数是偏移值。方向使用 PDO::FETCH_ORI_ABS 时，第三个参数表示结果集中的绝对行号；返回形式仍由第一个参数控制，这里用 PDO::FETCH_ASSOC 得到列名数组。

fetch(
    PDO::FETCH_ASSOC,
    PDO::FETCH_ORI_ABS,
    $rowNumber
);

// fetch() 失败或目标行不存在时返回 false，不能直接当数组使用。
if ($row === false) {
    throw new RuntimeException('指定行不存在，或当前 PDO 驱动不支持该游标操作');
}

echo $row['id'], ': ', $row['name'];
?>

不要使用 if (!$row) 代替严格判断：如果结果行本身包含可转为假值的数据，宽松判断会把数据问题误判成读取失败。行号越界时也应走 false 分支。

3. 行号、驱动支持与结果顺序要一起判断

绝对行号只有在“结果集顺序稳定、游标能力真实可用”时才有意义。先把排序列固定下来，再把行号限制在业务允许的范围内。不同 PDO 驱动对滚动游标的支持并不等价，手册中也明确要求 FETCH_ORI_* 只用于可滚动游标；因此线上代码不要只看 prepare() 没报错就认定 ABS 已生效。

一个实用的排查顺序是：确认第二个 prepare 参数仍然是 CURSOR_SCROLL；确认 SELECT 有 ORDER BY；用 FIRST 读取首行、再用 ABS 读取目标行进行对照；最后观察目标行是否与预期主键匹配。如果驱动只提供前向读取，就改为在 SQL 层明确筛选，或一次性读入可控大小的结果集后在 PHP 中定位，不要把无效的游标参数当成分页性能优化。

4. 关闭游标并完成最小验证

只读取一行并不代表结果集资源已经立刻释放。后续还要复用同一连接执行其他语句时，可以显式调用 closeCursor()，让驱动尽快释放当前语句占用的结果集资源。若项目使用异常模式，建议把 prepare/execute/fetch 放在 try/catch 中，记录驱动错误而不是吞掉 false。

prepare($sql, [PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL]);
    $stmt->execute(['status' => 'active']);
    $row = $stmt->fetch(PDO::FETCH_ASSOC, PDO::FETCH_ORI_ABS, 2);

    if ($row === false) {
        echo '没有读取到目标行';
    } else {
        echo $row['id'];
    }
} finally {
    // 读取结束后释放游标，避免影响同一连接的后续查询。
    if (isset($stmt)) {
        $stmt->closeCursor();
    }
}
?>

常见问题

FETCH_ORI_ABS 的行号是从 0 还是从 1 开始？

应以当前 PDO 驱动的文档和实际验证为准，不能把数组下标习惯直接套到游标行号上。使用稳定主键做对照，分别测试首行、目标行和越界行，比只打印一条结果更可靠。

为什么设置了 CURSOR_SCROLL 仍然读不到指定行？

常见原因是驱动没有实现滚动游标，或者游标没有在 prepare() 阶段声明。先检查驱动文档和最小测试，再决定是否改用 SQL 筛选或受控的 fetchAll()。

参考资料：https://www.php.net/manual/en/pdostatement.fetch.php；https://www.php.net/manual/en/pdo.constants.php