file_get_contents()调API最快但缺陷明显：不支持POST、超时控制弱、错误仅返回false且无法获取HTTP状态码；推荐封装cURL或使用Guzzle，并注意超时、重试、日志与可观测性。
PHP 用 file_get_contents() 调 API 最快但有硬伤
能用，但默认不支持 POST、超时控制弱、出错只返回 false，连 HTTP 状态码都拿不到。尤其调外部接口时，401 或 502 全被吞掉，debug 只能靠猜。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 仅限调用公开的 GET 接口，且对方允许跨域（CORS）或直连（非浏览器环境）
- 必须手动加
stream_context_create()控制超时，例如：$opts = ['http' => ['timeout' => 5]];
$ctx = stream_context_create($opts);
$res = file_get_contents('https://api.example.com/data', false, $ctx); - 调用前先检查
allow_url_fopen是否开启（ini_get('allow_url_fopen')），很多生产环境是关的
推荐用 curl_init()，但别裸写重复逻辑
原生 cURL 灵活，但每次都要设 CURLOPT_RETURNTRANSFER、CURLOPT_HEADER、CURLOPT_TIMEOUT……容易漏。重点不是“会不会用”，而是“怎么避免下次又写一遍”。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 封装成最小可用函数，至少支持 GET/POST、JSON 自动编码、基础错误判断：
function api_call($url, $method = 'GET', $data = []) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
if ($method === 'POST') {
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
}
$res = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return $http_code >= 200 && $http_code < 300 ? json_decode($res, true) : false;
} - 别在循环里反复
curl_init()，复用句柄或改用curl_multi_init()批量调用 - 注意 HTTPS：若报
SSL certificate problem，不是简单加CURLOPT_SSL_VERIFYPEER关验证，而是检查系统 CA 证书路径（curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem')）
Composer 装 guzzlehttp/guzzle 前先想清楚依赖成本
Guzzle 是最常用的 PHP HTTP 客户端，但引入它意味着整个项目要跑 Composer、autoload、可能和旧版 PHP 冲突。如果你只是在 WordPress 插件或小型后台里调一个天气 API，真没必要。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认最低 PHP 版本：Guzzle 7 要求 PHP >= 7.2；若还在用 PHP 5.6，只能选 Guzzle 6 或退回去用 cURL
- 避免全局安装，用
composer require guzzlehttp/guzzle:^7.5锁定小版本，防止某天自动升级破坏兼容性 - 别直接 new
GuzzleHttp\Client后裸调 —— 加一层 wrapper 处理统一超时、重试、日志，否则后续换 SDK 会更痛
调试时怎么看真实请求和响应？
光看 var_dump($res) 没用。API 返回空、假、乱码，大概率是请求发错了，而不是接口本身问题。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
curl_setopt($ch, CURLOPT_VERBOSE, true)+fopen('php://temp', 'r+b')抓原始请求头/体（别打 log 文件，容易权限出错） - 对方文档写 “传
Authorization: Bearer xxx”，就真要检查 header 是不是多空格、少冒号、token 过期没刷新 - 本地测试时，用
http://httpbin.org替代真实接口，验证你的 PHP 代码是否真发出了预期请求（比如http://httpbin.org/post查 POST 数据）
429、或者 JSON 解析前忘了检查 json_last_error()。留个心眼：所有 API 调用，必须有 fallback 和可观测入口。 
