17370845950

本文介绍如何在不依赖 eloquent 模型或数据库的情况下，对 http 获取的 json 数据进行客户端分页，使用 laravel 的集合方法（如 `skip()` 和 `take()`）按每页 10 条高效切片原始数据。

在实际开发中，我们常需调用第三方 API（如天气服务、公共数据接口等），其响应为 JSON 格式且不含内置分页逻辑。此时若想在 Laravel 应用中实现“每页 10 条”的分页体验，不能直接调用 $collection->paginate()（该方法仅适用于 Query Builder 或 Eloquent，底层依赖数据库偏移与限制），而应采用「内存分页（In-Memory Pagination）」策略：先将完整数据加载为 Laravel 集合，再基于请求参数动态截取子集。

以下是完整、可落地的实现步骤：

✅ 步骤一：获取并解析远程 JSON 响应

use Illuminate\Support\Facades\Http;

$response = Http::get(env('API_ENDPOINT'), $queryParams);

if (!$response->successful()) {
    abort(500, 'Failed to fetch data from external API');
}

$data = $response->json();
$results = $data['results'] ?? [];
$total = $data['num_results'] ?? count($results); // 兜底：用数组长度估算总数

✅ 步骤二：计算分页参数并切片数据

$page = max(1, (int) $request->input('page', 1)); // 防止 page ≤ 0
$perPage = 10;
$skip = ($page - 1) * $perPage;

$collection = collect($results);
$pagedResults = $collection->skip($skip)->take($perPage)->values()->all(); // ->values() 重置键名，确保返回连续索引数组

// 计算分页元信息（供前端渲染页码）
$lastPage = (int) ceil($total / $perPage);
$hasMore = $page < $lastPage;

✅ 步骤三：构造标准化分页响应（推荐）

return response()->json([
    'data' => $pagedResults,
    'meta' => [
        'current_page' => $page,
        'per_page' => $perPage,
        'total' => $total,
        'last_page' => $lastPage,
        'has_more' => $hasMore,
        'from' => $skip + 1,
        'to' => min($skip + $perPage, $total),
    ]
]);

⚠️ 注意事项与最佳实践

• 性能提醒：此方案适用于 results 总量可控（例如 ≤ 5000 条）。若原始数据极大（如数万条），应优先推动上游 API 支持服务端分页（如 ?limit=10&offset=20），避免全量拉取。
• 健壮性增强：建议对 $results 做类型校验（is_array()）、空值处理，并设置超时与重试机制（Http::timeout(10)->retry(2)）。
• SEO 与链接友好：若用于 Web 页面，可配合 LengthAwarePaginator 封装（需手动传入 $total 和 $perPage），以兼容 Laravel 的 {{ $data->links() }} 组件：

  use Illuminate\Pagination\LengthAwarePaginator;
  $paginator = new LengthAwarePaginator($pagedResults, $total, $perPage, $page, [
      'path' => $request->url(),
      'query' => $request->query(),
  ]);

通过以上方式，你无需模型、不碰数据库，仅凭集合操作即可实现专业级的 JSON 分页体验——简洁、可靠，且完全符合 Laravel 开发范式。