php curl调用远程接口核心是初始化、配置参数、执行并处理结果；get请求需设url、returntransfer、timeout；post提交json需json_encode并设content-type头；须校验http状态码及curl_error。
PHP 中用 cURL 调用远程接口，核心就三点：初始化、配置参数、执行并处理结果。只要参数设对，基本不会出错。
基础调用：GET 请求最简写法
想获取一个公开 API 的数据（比如天气、汇率），用 GET 最常见：
- 先调用 curl_init() 创建句柄
- 用 curl_setopt() 设置 URL、超时、返回方式等关键选项
- 调用 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); // 超时 10 秒
$result = curl_exec($ch);
curl_close($ch);
if ($result === false) {
echo '请求失败：' . curl_error($ch);
} else {
$data = json_decode($result, true);
}
带参数的 POST 请求：提交表单或 JSON 数据
向接口提交数据，重点在设置请求方法、请求体和头信息：
立即学习“PHP免费学习笔记（深入）”；
- 用 CURLOPT_POST 或 CURLOPT_CUSTOMREQUEST 控制方法
- 数组传参用 CURLOPT_POSTFIELDS（自动编码为 x-www-form-urlencoded）
- 发 JSON 时需手动 json_encode 并设置 Content-Type: application/json
示例（JSON 提交）：
$data = ['name' => '张三', 'email' => 'zhang@example.com'];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/user');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Accept: application/json'
]);
$result = curl_exec($ch);
curl_close($ch);
处理响应头、状态码和错误
不能只看返回内容，还要检查 HTTP 状态是否正常、是否有重定向、是否超时：
- 用 CURLOPT_HEADER + CURLOPT_NOBODY 可只取头信息
- 执行后调 curl_getinfo($ch, CURLINFO_HTTP_CODE) 拿状态码
- 用 curl_errno($ch) 和 curl_error($ch) 判断底层错误
建议每次请求后都做基础校验：
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($httpCode >= 200 && $httpCode < 300) {
// 成功
} elseif ($httpCode == 0) {
// 网络层失败（如域名无法解析、连接被拒）
} else {
// HTTP 错误（404、500 等）
}
进阶技巧：复用句柄、设置 Cookie、跳过 SSL 验证
高频调用时可复用 cURL 句柄提升性能；调试阶段有时需忽略证书验证：
- 初始化一次 $ch，多次调用 curl_setopt_array() 改 URL/参数，避免反复 init/close
- 用 CURLOPT_COOKIEJAR 和 CURLOPT_COOKIEFILE 管理会话 Cookie
- 开发环境临时跳过 HTTPS 证书检查：加 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)（上线务必删掉）
基本上就这些。不复杂但容易忽略状态码和错误处理，补上这两点，线上稳定性高很多。
