怎样在PHP翻页函数中实现基于游标的API分页-php教程-PHP中文网

不能用offset/limit做api分页，因其需全扫描前n行导致性能差，且并发增删时会漏数或重复；游标分页基于上一页末尾排序值（如id或(created_at,id)）续查，避免扫描、保证一致性。

怎样在php翻页函数中实现基于游标的api分页

为什么不能用 offset/limit 做 API 分页

因为 OFFSET 在大数据量下会拖慢查询，比如 OFFSET 1000000 仍要扫描前一百万行；更严重的是，若中间有数据插入或删除，page=11 可能漏掉或重复返回记录。游标分页（cursor-based pagination）靠排序字段+上一页末尾值来定位下一页，跳过扫描、保证一致性。

如何构造游标值并嵌入 SQL 查询

游标本质是排序字段的编码值（如 id 或 created_at），必须满足：唯一、有序、不可变。推荐用 id（主键）或组合 (created_at, id) 防止时间重复：

前端传 cursor=12345 表示“取 id > 12345 的前 N 条”
后端需校验 cursor 是合法整数或 base64 解码后的字符串（如 base64_encode("2024-05-01 10:00:00|123")）
SQL 必须带 ORDER BY id ASC（方向需与游标逻辑一致），且 WHERE id > ? 不能写成 >=
查询时加 LIMIT N+1：多查 1 条用于判断是否有下一页，但只返回 N 条给客户端

示例片段：

$cursor = $_GET['cursor'] ?? null;
$limit = min((int)($_GET['limit'] ?? 20), 100);
$params = [];
$sql = "SELECT id, title, created_at FROM posts WHERE 1=1";

if ($cursor !== null) {
    $sql .= " AND id > ?";
    $params[] = (int)$cursor;
}
$sql .= " ORDER BY id ASC LIMIT " . ($limit + 1);

$stmt = $pdo->prepare($sql);
$stmt->execute($params);
$rows = $stmt->fetchAll();
$hasNext = count($rows) > $limit;
if ($hasNext) {
    array_pop($rows); // 剔除多查的那条
}
$nextCursor = $hasNext ? (string)$rows[count($rows)-1]['id'] : null;