17370845950

本文讲解如何在不依赖 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 分页逻辑。