当前位置:

首页 > 编程开发 > PHP返回JSON分页数据怎么实现

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

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

本文目录

    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 字节

    Laravel 或 ThinkPHP 等框架已封装,但底层逻辑一样

    框架的 paginate() 方法(如 Laravel 的 Post::paginate(10))返回的是 Paginator 对象,调用 ->toJson() 才是标准 JSON。它内部也做三件事:查总数、算 offset、查数据列表。

    如果你在裸 PHP 里想模仿,关键就是别绕开「总数查询」—— 很多人图省事只查数据再 count($data),那 total 永远等于 per_page,前端永远显示「共 10 条」。

    真正难的不是拼 JSON,是让分页参数、SQL 偏移、总数统计三者对齐。少一个环节,前端翻页就错乱。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Nod 0.8.1怎样理解状态码、Ray ID与计划检查
    Nod 0.8.1怎样理解状态码、Ray ID与计划检查

    Nod 0.8.1补充连接服务状态与原因、Attio Cloudflare 403诊断,并让Gmail在连接服务429或503后延后计划轮询。

    Ducter 0.0.59如何理解同会话聊天、Git可选和附件变化
    Ducter 0.0.59如何理解同会话聊天、Git可选和附件变化

    Ducter 0.0.59扩展Telegram、Slack和Mac iMessage会话,区分项目目录来源、Git可选、等待状态与附件入口。

    llama.cpp b12435、b12436、b12438测试构建的三类兼容变化有什么区别?
    llama.cpp b12435、b12436、b12438测试构建的三类兼容变化有什么区别?

    llama.cpp b12435、b12436、b12438预发布构建,分别解释Vulkan并列选择确定性、32位编译与Jinja JSON键排序的适用范围。

    ScopeWeaver 0.9.2、0.9.3与0.9.4如何区分运行时、Zod和任务状态变化
    ScopeWeaver 0.9.2、0.9.3与0.9.4如何区分运行时、Zod和任务状态变化

    ScopeWeaver 0.9.2、0.9.3与0.9.4分别调整桥运行时、Zod依赖和同进程服务器重建后的暂停状态;区分版本对象与作者本地研究用途声明。

    AG2 1.3.2的输入Token为何变多,旧ACP版本还能用吗
    AG2 1.3.2的输入Token为何变多,旧ACP版本还能用吗

    AG2 1.3.2统一缓存Token统计并更新ACP1.x依赖;解释预算提前触达、报表口径与Python3.15构建限制。

    llama.cpp b12433怎样为AMD奇数列保留MUL_MAT_ID回退路径
    llama.cpp b12433怎样为AMD奇数列保留MUL_MAT_ID回退路径

    llama.cpp b12433避免AMD设备将奇数src0列送入需要偶数列的MMVF路径:满足偶数条件才保留MMVF,其他形状沿用既有回退。对应改动发生在MUL_MAT_ID处理和相关同步判断中,范围限定于代码说明中的类型与token条件。

    Ducter 0.0.58如何区分下一步消息、完成后消息与后台会话
    Ducter 0.0.58如何区分下一步消息、完成后消息与后台会话

    Ducter 0.0.58调整任务阅读、执行中消息和后台会话,区分下一步发送与做完再说,并说明tailnet HTTPS辅助的条件。

    Unlimited OCR 2在TextMind能否直接使用,账号权限与模型示例如何区分
    Unlimited OCR 2在TextMind能否直接使用,账号权限与模型示例如何区分

    Unlimited OCR 2官方确认百度智能云TextMind渠道;区分云端入口、账号权限配额与本地模型部署,避免混淆接口和计费条件。

    TensorFold 1.2.9的Ollama接口和服务配置文件怎么用
    TensorFold 1.2.9的Ollama接口和服务配置文件怎么用

    TensorFold 1.2.9的服务配置文件用于保存和复用启动参数,Ollama兼容API则在同一推理路径上提供聊天、生成和模型查询等接口。理解配置优先级及后端限制,比只看到“兼容”就直接迁移全部流量更有用。

    如何理解Univer 1.5.2的二次混淆移除与构建边界?
    如何理解Univer 1.5.2的二次混淆移除与构建边界?

    理解Univer 1.5.2的关键,是把额外混淆与构建压缩分开。本版删除二次混淆插件及相关配置,同时保留Pro模块的minify设置;它解释的是产物处理方式的变化,不代表增加了表格或公式能力。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。