如何在 PHP 中正确实现分页 API 请求的递归调用-php教程-PHP中文网

如何在 PHP 中正确实现分页 API 请求的递归调用

本文详解如何通过递归方式优雅处理含 nextHref 分页链接的 API 请求，避免循环嵌套导致的可读性差、错误难追踪等问题，并提供健壮、可维护的 PHP 实现方案。

本文详解如何通过递归方式优雅处理含 nexthref 分页链接的 api 请求，避免循环嵌套导致的可读性差、错误难追踪等问题，并提供健壮、可维护的 php 实现方案。

在调用支持分页的 RESTful API（如电商商品列表接口）时，常见响应结构中会包含一个 meta.nextHref 字段，指向下一页数据的 URL。若采用 while 循环反复重置 cURL 句柄并手动拼接结果，不仅逻辑冗余、状态管理复杂，还容易因异常中断导致部分数据丢失或死循环风险。

更优解是采用递归函数设计：将请求 URL 作为参数传入，每次成功获取响应后，提取当前数据并判断是否存在 nextHref；若存在，则递归调用自身，将后续结果合并返回。这种方式天然契合分页的链式结构，代码简洁、语义清晰、易于调试与扩展。

以下是推荐的完整实现（含关键优化）：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

function get_data($url, $token = '') {
    // 基础校验
    if (empty($url)) {
        throw new InvalidArgumentException('URL cannot be empty');
    }

    $curl = curl_init();
    curl_setopt_array($curl, [
        CURLOPT_URL            => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HEADER         => false,
        CURLOPT_TIMEOUT        => 30,
        CURLOPT_FOLLOWLOCATION => false,
        CURLOPT_HTTPHEADER     => [
            "Accept: application/json;charset=utf-8",
            "Authorization: Bearer $token",
            "Content-Type: application/json-patch+json"
        ],
        CURLOPT_SSL_VERIFYPEER => false, // 生产环境请启用证书验证
    ]);

    $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}");
    }

    // 当前页数据入栈
    $result = [$res];

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

    return $result;
}

// 使用示例：
try {
    $allData = get_data('https://api.example.com/products', 'your-jwt-token-here');
    foreach ($allData as $page) {
        foreach ($page['data'] ?? [] as $item) {
            echo $item['name'] . "\n";
        }
    }
} catch (Exception $e) {
    error_log('API fetch failed: ' . $e->getMessage());
}

⚠️ 注意事项与最佳实践：

防止无限递归：务必校验 nextHref 是否为有效 URL（使用 filter_var(..., FILTER_VALIDATE_URL)），避免因服务端返回错误链接导致崩溃；
超时与重试：生产环境中建议增加 CURLOPT_TIMEOUT 和简易重试机制（如失败后延迟重试 1–2 次）；
内存安全：若分页极深（如上千页），递归可能导致栈溢出，此时应回退至带迭代计数器的 while 循环 + 显式栈管理；
Token 安全传递：避免全局变量 $token，推荐通过参数传入或封装为类方法，便于单元测试与多租户支持；
SSL 验证：开发阶段可设 CURLOPT_SSL_VERIFYPEER => false 快速验证，但上线前必须设为 true 并配置 CA 证书路径。