使用PHP cURL可实现API调用，1. 发送GET请求获取数据需初始化cURL、设置选项、执行并解析JSON响应；2. POST请求通过CURLOPT_POST提交数据，传递JSON格式内容；3. 处理响应时检查HTTP状态码、验证解码结果、设置超时与安全机制，确保稳定性和安全性。
在PHP开发中，调用API接口获取数据是一个常见需求，比如获取天气信息、用户资料、支付接口等。最常用的方式是使用PHP的cURL扩展发送HTTP请求。下面详细介绍如何用PHP cURL正确请求API并处理返回的数据。
使用cURL发送GET请求获取API数据
GET请求用于从服务器获取数据，是最常见的API调用方式。
示例：调用一个返回JSON格式用户信息的API
$url = "https://api.example.com/users/1";
// 初始化cURL
$ch = curl_init();
// 设置请求选项
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 不直接输出结果
curl_setopt($ch, CURLOPT_TIMEOUT, 30); // 请求超时时间
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer your-access-token' // 如果需要认证
]);
// 执行请求
$response = curl_exec($ch);
// 检查是否有错误
if (curl_error($ch)) {
die("请求出错: " . curl_error($ch));
}
// 关闭cURL
curl_close($ch);
// 解析JSON响应
$data = json_decode($response, true);
// 使用数据
if ($data) {
echo "用户名: " . $data['name'];
} else {
echo "无法解析数据";
}
发送POST请求提交数据到API
当需要向API提交数据（如登录、创建资源）时，通常使用POST方法。
立即学习“PHP免费学习笔记（深入）”；
$url = "https://api.example.com/login";
$postData = [
'username' => 'testuser',
'password' => 'testpass'
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Accept: application/json'
]);
$response = curl_exec($ch);
if (curl_error($ch)) {
die("请求失败: " . curl_error($ch));
}
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
处理API响应与常见问题
成功调用API后，需正确处理响应内容和可能的异常情况。
关键点：- 检查HTTP状态码：可通过curl_getinfo($ch, CURLINFO_HTTP_CODE)获取状态码，如200表示成功，404表示未找到，401表示未授权。
- 验证JSON解码结果：json_decode()失败时返回null，建议用json_last_error()排查问题。
- 设置超时和重试机制：避免因网络问题导致脚本长时间阻塞。
- 安全处理敏感信息：不要在代码中硬编码API密钥，应通过配置文件或环境变量管理。
如果API返回非JSON数据（如XML或纯文本），根据实际类型选择合适的解析方式。
基本上就这些。掌握cURL的基本配置和错误处理，就能稳定地在PHP中调用各类API接口。实际开发中建议封装成函数或类，提高代码复用性。
