Laravel如何实现分页查询_Laravel分页功能使用【前端】-php教程-PHP中文网

paginate() 返回 LengthAwarePaginator 实例而非纯数组，含分页元信息；前端需取 response.data.data 获取数据，并显式传递搜索参数以保持条件，可用 simplePaginate() 优化性能。

laravel如何实现分页查询_laravel分页功能使用【前端】

为什么 `paginate()` 返回的数据结构和普通数组不一样

因为 paginate() 不返回纯数据列表，而是返回一个 LengthAwarePaginator 实例——它自带分页元信息（如 current_page、last_page、next_page_url 等），前端无法直接遍历渲染。常见错误是写 v-for="item in data" 却忘了取 data.data。

正确做法是解构响应：后端用 return $users->paginate(10);，前端接收后需访问 response.data.data 获取实际数据，response.data.links 或 response.data.meta（取决于是否用 jsonPaginate()）读取分页控制字段。

容易踩的坑：

直接把整个 LengthAwarePaginator 对象 JSON 输出给前端，导致前端收到嵌套过深、字段名不一致（比如 per_page 而非 pageSize）
没处理 appends()，导致带搜索参数分页时 URL 丢失条件（例如 ?keyword=abc 分页跳转后消失）
前端用 axios.get('/api/users') 请求，但没在 URL 中传 page 参数，后端始终返回第 1 页

如何让前端自定义分页参数名（比如用 `p` 代替 `page`）

Laravel 默认只认 page 查询参数，但前端框架（如 Element Plus、Ant Design Vue）可能默认传 current 或 p。硬改前端参数名不如后端适配更稳妥。

两种方式：

全局配置：在 config/app.php 中设置 'pagination' => 'bootstrap-5' 不影响参数名，真正起作用的是 Illuminate\Pagination\AbstractPaginator::$currentPageResolver，但不建议动它
请求时显式指定：在控制器里用 User::query()->paginate(10, ['*'], 'p') ——第三个参数就是 URL 中的参数名，这样 ?p=2 就能正确跳转第 2 页
更灵活的做法：用 request()->input('p', 1) 手动取值 + forPage()，适合需要复合逻辑的场景（比如合并多个查询条件时）

前端点击分页按钮时，如何保持搜索条件不丢失

关键不是“记住条件”，而是每次分页请求都**显式带上当前所有筛选参数**。Laravel 本身不保存状态，全靠前端拼 URL。

示例场景：用户在 ?keyword=laravel&status=active 下翻页，下一页链接应为 ?keyword=laravel&status=active&page=2，而不是只有 ?page=2。

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

实操建议：

后端返回的 links.next 是完整 URL（含原有参数），可直接用于 <a :href="link.next"></a>；但如果用 JS 请求（如 axios），就别依赖它，自己拼
前端维护一个 filters 对象（如 { keyword: '', status: 'all' }），分页时用 axios.get('/api/users', { params: { ...filters, page: nextPage } })
避免在 paginate() 后链式调用 appends(request()->except('page'))——这仅影响 Blade 模板里的 $users->links() 渲染，对 API 响应无效