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)(上线务必删掉)
基本上就这些。不复杂但容易忽略状态码和错误处理,补上这两点,线上稳定性高很多。











