file_get_contents聚合远程JSON需配置stream_context_create设超时并检查false返回，再json_decode；curl_multi_init支持并发拉取多接口，效率更高；聚合层须统一字段结构、缓存需规避敏感参数且失效策略同步源接口。
PHP接口怎么用file_get_contents聚合远程JSON数据
直接用 file_get_contents 拉取其他接口的JSON最简单，但得自己处理错误和超时。它不支持设置连接超时（PHP 8.0+ 才在 stream_context_create 中支持 timeout），容易卡住主线程。
- 必须用
stream_context_create配置http选项，否则默认无超时，5秒以上响应就拖垮整个接口 - 返回值要先检查是否为
false，再用json_decode解析，否则json_last_error()会误报“语法错误” - 如果对方返回非200状态码（比如404），
file_get_contents默认仍返回body，得手动读取$http_response_header或改用get_headers
$ctx = stream_context_create(['http' => ['timeout' => 3]]);
$data = file_get_contents('https://api.example.com/users', false, $ctx);
if ($data === false) {
http_response_code(502);
echo json_encode(['error' => 'fetch failed']);
exit;
}
$result = json_decode($data, true);
为什么curl比file_get_contents更适合聚合多个来源
当你要同时拉取用户、订单、商品三个接口，curl 的 curl_multi_init 能并发执行，而 file_get_contents 只能串行。前者总耗时接近最长那个请求，后者是三者之和。
- 别直接用
curl_exec写三次——阻塞式调用会让90%的等待时间白白浪费 - 用
curl_multi_add_handle把多个CurlHandle加进批处理，再循环curl_multi_exec直到完成 - 记得对每个句柄单独调用
curl_getinfo($ch, CURLINFO_HTTP_CODE)判定状态，不能只看curl_error
聚合后怎么统一字段结构避免前端报错
不同接口返回的用户ID字段可能是 id、user_id、uid，不标准化会导致前端反复写兼容逻辑。聚合层必须做字段映射，而不是把原始数据拼一起就完事。
- 定义一个标准数组模板，比如
['id' => null, 'name' => null, 'email' => null]，所有来源都往里填 - 用
array_merge($template, $source_data)安全覆盖，避免isset($src['id']) ? $src['id'] : null这种重复判断 - 如果某个接口缺失关键字段（如邮箱），不要留空字符串，统一设为
null，让前端用??处理更清晰
缓存聚合结果时要注意哪些边界条件
聚合接口本身不能被CDN缓存（因为通常带用户token），但内部拉取的公共数据可以缓存。用 apcu_store 存10分钟没问题，但得注意键名是否包含动态参数。
立即学习“PHP免费学习笔记（深入）”；
- 键名必须排除敏感参数，比如
"user_aggr_{$uid}_{$region}"是危险的，应改为"user_aggr_public_{$region}" - 缓存失效策略要和源接口一致：如果商品API每5分钟更新一次，你的聚合缓存就不能设成30分钟
- 首次缓存未命中时，别让10个并发请求同时去拉远端——加一层
apcu_add尝试写锁，失败则 sleep 后重读
聚合真正的难点不在拼数据，而在控制每个环节的失败传播：一个下游超时不该让整个聚合返回500，一个字段缺失也不该导致 json_encode 出错。这些细节不压测根本看不出问题。
