PHP用cURL调用API需四步：curl_init()初始化、curl_setopt()配置参数（含URL、RETURNTRANSFER、TIMEOUT等）、curl_exec()执行、curl_close()关闭；POST传JSON须设CURLOPT_POST、CURLOPT_POSTFIELDS为json_encode结果，并显式添加'Content-Type: application/json'头。
PHP 用 cURL 调用 API 接口的基本写法
直接上能跑的最小可用代码：用 curl_init() 初始化，curl_setopt() 配置参数，curl_exec() 发起请求，最后记得 curl_close()。
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($response === false) {
echo 'cURL 错误: ' . curl_error($ch);
} elseif ($http_code !== 200) {
echo "HTTP 状态码异常: $http_code";
} else {
$data = json_decode($response, true);
}
POST 请求传参（JSON 格式）要注意 Content-Type
很多 API（尤其是 RESTful 接口）要求 Content-Type: application/json，否则后端收不到或解析失败。别只塞 json_encode() 就完事，header 必须同步设置。
-
CURLOPT_POST设为true或用CURLOPT_CUSTOMREQUEST => 'POST' -
CURLOPT_POSTFIELDS填json_encode($params)，不是数组本身 - 必须显式加
CURLOPT_HTTPHEADER，包含'Content-Type: application/json' - 如果接口需要认证，header 里一并加上
'Authorization: Bearer xxx'
常见错误：cURL 返回空、false 或 0，但没报错
这通常不是代码语法问题，而是配置漏项或网络环境导致。重点排查这几项：
-
CURLOPT_RETURNTRANSFER没设为true→curl_exec()直接输出而非返回字符串 -
CURLOPT_SSL_VERIFYPEER在本地测试时被设为true，但无有效证书 → 加curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)（仅限开发） - 目标域名 DNS 解析失败或超时 → 检查
CURLOPT和
_CONNECTTIMEOUT
CURLOPT_TIMEOUT是否过短 - 响应体过大被截断 → 确认没误设
CURLOPT_HEADER或CURLOPT_NOBODY
用 file_get_contents() 能不能替代 cURL？
可以，但限制明显：不支持 POST JSON、无法精细控制 header、超时不灵活、默认不支持 HTTPS 证书验证（PHP 5.6+ 后行为有变化）。简单 GET 请求且接口不校验 header 时可用，例如：
$opts = [
'http' => [
'method' => 'GET',
'timeout' => 10,
'header' => "User-Agent: PHP\r\n"
]
];
$context = stream_context_create($opts);
$result = file_get_contents('https://api.example.com/status', false, $context);
但只要涉及 POST、token 认证、自定义 header 或调试需求，curl 是唯一靠谱选择。别为了少写几行代码牺牲可控性和排错能力。
真正麻烦的从来不是怎么发请求，而是处理重定向跳转、cookie 维持、连接复用、错误重试策略这些细节 —— 这些在生产环境里一个都绕不开。
