本文讲解如何在不依赖 eloquent 模型或数据库的情况下，对远程 api 返回的 json 数组进行手动分页（如每页 10 条），通过 laravel 的集合方法（`skip()` + `take()`）高效完成客户端侧分页逻辑。
在实际开发中，我们常需调用第三方 REST API 获取 JSON 数据（例如天气、商品列表或用户聚合数据），而这些接口本身不支持分页参数（如 ?page=2&limit=10），或返回的是完整数据集（如你提供的 results 数组）。此时，若想在 Laravel 应用层实现“每页 10 条”的分页体验，就不能使用 Model::paginate() —— 因为它底层依赖数据库查询构建分页器。正确做法是：将原始 JSON 数组转为 Laravel 集合，再基于当前页码计算偏移量，手动切片数据。
以下是推荐实现方式（适用于 Laravel 8+）：
use Illuminate/Http/Request;
use Illuminate/Support/Facades/Http;
public function index(Request $request)
{
// 1. 发起 HTTP 请求获取原始响应
$response = Http::get(env('API_ENDPOINT'), $queryParams);
if (!$response->successful()) {
return response()->json(['error' => 'Failed to fetch data'], 500);
}
$data = $response->json();
$results = $data['results'] ?? [];
$total = $data['num_results'] ?? count($results); // 兼容 fallback 总数
// 2. 解析分页参数（默认第 1 页）
$page = max(1, (int) $request->input('page', 1));
$perPage = 10;
// 3. 使用集合进行内存分页
$collection = collect($results);
$offset = ($page - 1) * $perPage;
$paginatedItems = $collection->skip($offset)->take($perPage)->values()->all();
// 4. 构建标准分页响应（含元信息）
$lastPage = (int) ceil($total / $perPage);
$hasMore = $page < $lastPage;
return response()->json([
'data' => $paginatedItems,
'meta' => [
'current_page' => $page,
'last_page' => $lastPage,
'per_page' => $perPage,
'total' => $total,
'has_more' => $hasMore,
]
]);
}
✅ 关键点说明：
- collect($results) 将 PHP 数组转为可链式操作的 Illuminate/Support/Collection；
- skip($offset) 跳过前 ($page-1)*10 条，take(10) 取后续 10 条；
- ->values()->all() 重置键名（避免索引断裂），确保返回标准数字索引数组；
- 手动计算 last_page 和 has_more，便于前端判断是否显示“下一页”按钮。
⚠️ 注意事项：
- 此方案适用于总数据量适中（如 ≤ 10,000 条）的场景。若原始 JSON 过大（如 100MB），应优先推动上游 API 支持服务端分页，避免内存压力与网络开销；
- 若原始响应无 num_results 字段，建议用 count($results) 作为 total，但需注意：这仅反映本次请求返回的条目数，不代表全量总数（此时分页意义受限）；
- 前端请求时务必传入 ?page=2 等参数，否则默认始终返回第 1 页。
通过该方式，你完全绕开了模型与数据库，仅用 Laravel 集合能力就实现了专业、可控、可扩展的 JSON 分页逻辑。