PHP返回JSON分页数据怎么实现

时间：2026-04-09

PHP返回JSON分页数据需手动构造结构，包括data列表和meta分页元信息，严格校验参数、正确计算offset、查询总数而非仅count($data)，并设置Content-Type头。

php返回json数据怎么分页_json分页数据返回实现【详解】

PHP 返回 JSON 分页数据时，必须手动构造分页结构

PHP 本身没有内置的「JSON 分页」函数，json_encode() 只负责序列化，分页逻辑（如当前页、总条数、每页数量、数据列表）得你自己组织。常见错误是只返回 $data 数组，前端拿不到 total 或 page，导致无法渲染分页控件。

推荐结构：始终用统一顶层键包裹，比如 data 放列表、meta 放分页元信息。不要把分页字段和业务字段混在同级：

{
  "data": [...],
  "meta": {
    "total": 127,
    "per_page": 10,
    "current_page": 3,
    "last_page": 13,
    "from": 21,
    "to": 30
  }
}

后端计算 $total = $pdo->query("SELECT COUNT(*) FROM ...")->fetchColumn()，不能靠 count($data) —— 那只是当前页数量
last_page 要用 ceil($total / $per_page) 算，别四舍五入
前端传来的 page 和 per_page 必须校验：max(1, (int)$_GET['page'])，防 SQL 注入或越界

MySQL LIMIT 偏移量计算容易出错

分页的核心是 SQL 的 LIMIT offset, length，但 offset = (page - 1) * per_page 这个公式，很多人漏了减 1，结果第一页就跳过前 per_page 条。

示例（PDO）：

$page = max(1, (int)($_GET['page'] ?? 1));
$per_page = max(1, min(100, (int)($_GET['per_page'] ?? 10))); // 限制最大每页100条
$offset = ($page - 1) * $per_page;
$stmt = $pdo->prepare("SELECT id, title FROM posts WHERE status = ? ORDER BY id DESC LIMIT ?, ?");
$stmt->execute([1, $offset, $per_page]);
$data = $stmt->fetchAll(PDO::FETCH_ASSOC);

别用 LIMIT $page, $per_page —— 这是第 $page 页起始位置，不是「第几页」
大偏移量（如 page=10000）性能差，考虑游标分页（用上一页最后 ID）替代
ORDER BY 字段必须有索引，否则 LIMIT + OFFSET 会全表扫描

header('Content-Type: application/json') 不能少

不设 header，浏览器或前端框架（如 axios）可能把响应当文本处理，response.data 解析失败，控制台报 Unexpected token。

必须在 echo json_encode(...) 前调用：header('Content-Type: application/json; charset=utf-8');
如果用了输出缓冲（ob_start），确保没意外输出空格或 BOM —— 会导致 JSON 解析失败，错误信息是 JSON parse error: Unexpected token
开发时可用 var_dump(json_last_error_msg()); 检查编码失败原因，常见于中文未 UTF-8 编码或资源含 null 字节