Laravel API中如何配置分页查询及设置分页参数的方法？

本文共计794个文字，预计阅读时间需要4分钟。

直接查看数据量和前端需求：

常见错误是默认写 paginate() 却没意识到它会多执行一条 COUNT(*) 查询——当表有千万级数据、又没给分页字段加索引时，接口直接卡住或超时。

• paginate(15) 返回完整分页对象，含 $data->lastPage()、$data->total()
• simplePaginate(15) 只返回当前页数据 + 下一页是否有数据（$data->hasMorePages()）
• Laravel 9+ 中，simplePaginate() 默认使用游标分页逻辑（但不是真正的游标分页，只是省 COUNT）

API 分页响应结构怎么统一？

别让前端每次自己拼 next_page_url 和 prev_page_url。Laravel 默认返回的 links 是 HTML 字符串，API 里基本用不上。