如何在 PHP 中递归获取分页 API 数据-php教程-PHP中文网

如何在 PHP 中递归获取分页 API 数据

本文介绍如何通过递归方式优雅处理带分页链接（nexthref）的 restful api 响应，避免循环嵌套与重复代码，提升可读性、健壮性和内存管理能力。

本文介绍如何通过递归方式优雅处理带分页链接（nexthref）的 restful api 响应，避免循环嵌套与重复代码，提升可读性、健壮性和内存管理能力。

在调用支持分页的 REST API（如电商商品列表、用户记录等）时，常见响应结构中包含 meta.nextHref 字段，指向下一页数据的 URL。若使用 while 循环反复初始化 cURL 句柄并手动拼接结果，不仅逻辑冗余、易出错，还难以统一错误处理和资源释放。

更推荐采用递归函数设计：将 URL 作为参数传入，每次请求后检查是否存在 nextHref，存在则递归调用自身，并用 array_merge() 合并结果。这种方式语义清晰、符合函数式思维，且天然支持深度优先的数据聚合。

以下是优化后的完整实现：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

function get_data($url) {
    // 初始化 cURL
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_HEADER, 0);

    // 设置请求头（注意：$token 需在函数作用域外定义或通过闭包/依赖注入传入）
    $headers = [
        "accept: application/json;charset=utf-8",
        "Authorization: Bearer {$token}",
        "Content-Type: application/json-patch+json"
    ];
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

    // 执行请求
    $resp = curl_exec($curl);
    $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    curl_close($curl);

    // 基础错误处理
    if ($resp === false || $httpCode !== 200) {
        throw new RuntimeException("HTTP {$httpCode}: Failed to fetch data from {$url}");
    }

    $res = json_decode($resp, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new RuntimeException("Invalid JSON response from {$url}");
    }

    // 当前页数据存入数组
    $array = [$res];

    // 递归获取下一页（若存在）
    if (isset($res['meta']['nextHref']) && !empty($res['meta']['nextHref'])) {
        $array = array_merge($array, get_data($res['meta']['nextHref']));
    }

    return $array;
}

⚠️ 关键注意事项：