file_get_contents()最快但限制多，仅适合简单get；curl最稳且功能全，需注意curlopt_returntransfer等设置；guzzle最清爽但需composer，适合现代项目。
用 file_get_contents() 最快但限制多
它适合发简单 GET 请求，比如拉公开的 JSON 接口，不用装扩展、代码就一行。但默认不支持 POST、没超时控制、不能设 header，出错只返回 false，连错误原因都看不到。
常见错误现象：file_get_contents(): failed to open stream: HTTP request failed! —— 大概率是目标接口返回了 4xx/5xx，但它不报具体状态码；或者开启了 allow_url_fopen=Off（很多生产环境禁用）。
实操建议：
- 先检查
ini_get('allow_url_fopen')是否为1 - 加
stream_context_create()才能设超时和 User-Agent，否则容易卡死 - 别用它传敏感数据或发 POST，header 和 body 都难控制
$ctx = stream_context_create(['http' => ['timeout' => 5]]);
$data = file_get_contents('https://api.example.com/data', false, $ctx);
用 cURL 是最稳的选择
PHP 自带，全平台兼容，GET/POST/PUT/认证/header/证书/重定向都能控。唯一门槛是写法略啰嗦，新手容易漏关 curl_close() 或忘设 CURLOPT_RETURNTRANSFER。
立即学习“PHP免费学习笔记（深入）”；
常见错误现象：返回空字符串、直接输出响应体到页面、JSON 解析失败 —— 基本都是没设 CURLOPT_RETURNTRANSFER => true，导致结果被 echo 出来而不是返回变量。
实操建议：
- 必须设
CURLOPT_RETURNTRANSFER => true，否则返回true而不是内容 - 加
CURLOPT_FOLLOWLOCATION => true处理跳转，但注意可能触发重定向循环 - POST 时用
CURLOPT_POSTFIELDS，传数组自动变成application/x-www-form-urlencoded，传 JSON 字符串要手动设 header
$ch = curl_init('https://api.example.com/login');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['user'=>'a','pass'=>'b']));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
用 Guzzle 写得清爽但要装包
如果你项目已用 Composer，Guzzle 是最接近现代写法的选项：链式调用、异常明确、JSON 自动解析、中间件可扩展。但它不是内置，线上部署得确认 vendor/autoload.php 可加载，且老版本 PHP（如 7.2 以下）不兼容。
常见错误现象：Class 'GuzzleHttp\Client' not found —— 不是没装，就是 autoloader 没引入；或者用 Promise 异步时没跑 wait()，结果变量还是个 Promise 对象。
实操建议：
- 装完后第一行必须
require 'vendor/autoload.php'; - 错误统一用
try/catch (GuzzleException $e)捕获，比判断返回值直观得多 - 别在循环里反复 new Client，复用一个实例更省资源
use GuzzleHttp\Client;
$client = new Client();
try {
$res = $client->get('https://api.example.com/data', ['timeout' => 3]);
$data = json_decode($res->getBody(), true);
} catch (RequestException $e) {
error_log($e->getMessage());
}
超时、重试、编码这些细节最容易翻车
接口不稳定时，只设一次请求超时没用；中文乱码常因没声明 Content-Type: application/json; charset=utf-8；而 json_decode() 默认返回对象，直接取 $data->id 却忘了加第二个参数 true，就会报“Trying to get property 'id' of non-object”。
实操建议：
- 网络请求一律设超时：cURL 用
CURLOPT_TIMEOUT，Guzzle 用timeout选项，file_get_contents必须配stream_context_create - POST JSON 时，header 和 body 要同步：body 是 JSON 字符串，header 就得带
charset=utf-8 - 所有
json_decode()后的操作，先is_array()或加?? []防空，别信接口永远返回成功格式
复杂点在于：没有万能方案。内网调用用 file_get_contents 省事；对外服务必须用 cURL 或 Guzzle 控制力；而重试逻辑、熔断、日志埋点，得自己一层层补，框架不会替你做。
