如何在 PHP 中使用 cURL 提取并解析 JSON API 数据-php教程-PHP中文网

如何在 PHP 中使用 cURL 提取并解析 JSON API 数据

本文详解如何通过 PHP 的 cURL 发起 HTTP 请求获取 JSON 格式的 API 响应，并正确解码、遍历和提取嵌套数据（如 name、calories、sugar_g 等字段），避免常见数组访问错误与循环覆盖问题。

本文详解如何通过 php 的 curl 发起 http 请求获取 json 格式的 api 响应，并正确解码、遍历和提取嵌套数据（如 `name`、`calories`、`sugar_g` 等字段），避免常见数组访问错误与循环覆盖问题。

在 PHP 中调用外部 API 并结构化处理返回的 JSON 数据，是 Web 开发中的高频任务。典型流程包括：发起 cURL 请求 → 获取响应字符串 → JSON 解码 → 遍历并提取目标字段。你提供的示例中，API 返回的是一个包含 "items" 数组的 JSON 对象，每个子项为一道食物的营养数据。关键在于：json_decode($response, true) 将其转为关联数组，后续必须以数组语法（而非对象语法）访问，且需在循环内对每条记录独立处理——否则变量会被反复覆盖，最终仅保留最后一项。

以下是一个完整、健壮的实现示例：

wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support

基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。

下载

<?php // 1. 初始化 cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/foods'); // 替换为真实 API 地址
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    // 如需认证，可添加：'Authorization: Bearer YOUR_TOKEN'
]);

// 2. 执行请求并获取响应
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 3. 检查请求是否成功
if ($httpCode !== 200 || $response === false) {
    throw new Exception("API request failed with HTTP {$httpCode}");
}

// 4. 安全解码 JSON（检查有效性）
$jsonDecoded = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new Exception('Invalid JSON response: ' . json_last_error_msg());
}

// 5. 提取并处理所有 items（确保 items 存在且为数组）
if (!isset($jsonDecoded['items']) || !is_array($jsonDecoded['items'])) {
    throw new Exception('"items" key missing or not an array in response');
}

// 6. 遍历每条记录，提取所需字段并存储（例如存入数组或数据库）
$foodData = [];
foreach ($jsonDecoded['items'] as $index => $item) {
    // 显式检查字段是否存在，避免 Notice 错误
    $foodData[] = [
        'id'           => $index + 1,
        'name'         => $item['name'] ?? 'Unknown',
        'calories'     => (float)($item['calories'] ?? 0),
        'sugar_g'      => (float)($item['sugar_g'] ?? 0),
        'protein_g'    => (float)($item['protein_g'] ?? 0),
        'serving_size_g' => (float)($item['serving_size_g'] ?? 0),
        'carbohydrates_total_g' => (float)($item['carbohydrates_total_g'] ?? 0),
    ];
}

// 7. 输出或进一步使用结果
foreach ($foodData as $food) {
    echo "【{$food['name']}】{$food['calories']} kcal | Sugar: {$food['sugar_g']}g | Protein: {$food['protein_g']}g\n";
}
?>

✅ 关键注意事项：

永远校验 curl_exec() 返回值和 HTTP 状态码，网络异常或服务端错误会导致 $response 为空或非 JSON；
务必用 json_last_error() 验证解码结果，无效 JSON 会静默返回 null，直接访问 'items' 将触发 PHP Warning；
使用空合并运算符 ?? 和类型转换（如 (float)）提升鲁棒性，防止缺失字段导致脚本中断；
不要在循环外定义单个变量（如 $name = $item['name']）——这只会保存最后一次迭代的值；如需批量处理，请将数据存入数组、对象或写入数据库；
若需更高性能或更简洁语法，可考虑使用 Guzzle HTTP Client 替代原生 cURL，但底层原理一致。

掌握这一流程，即可稳定对接各类 RESTful 营养、天气、电商等 JSON API，为数据展示、分析或同步打下坚实基础。