如何用PHP调用第三方API并处理JSON数据-php教程-PHP中文网

file_get_contents()调get接口最快但需配合stream_context_create()：必须设user-agent、timeout和ignore_errors，否则易403或死等；post或认证场景应选curl。

如何用php调用第三方api并处理json数据

PHP用`file_get_contents()`发GET请求最简单，但得配好`stream_context_create()`

直接用file_get_contents()调第三方API是最快上手的方式，尤其只读取公开数据时。但它默认不带User-Agent头，很多API会直接返回403；也不支持超时控制，网络卡住就死等。

必须用stream_context_create()构造上下文，把关键参数写进去：

$opts = [
    'http' => [
        'method'  => 'GET',
        'header'  => "User-Agent: PHP\n",
        'timeout' => 5,
        'ignore_errors' => true, // 防止4xx/5xx直接报错
    ]
];
$content = file_get_contents('https://api.example.com/data', false, stream_context_create($opts));

ignore_errors => true很关键——否则HTTP状态码非2xx时file_get_contents()直接返回false，连错误响应体都拿不到
timeout建议设为3–10秒，别用默认的无限等待
如果API需要Authorization头，写在header里，注意换行符用\n

用`cURL`发POST或带认证的请求更可控

一旦要传POST数据、JSON body、Bearer Token或处理重定向，cURL是唯一靠谱选择。它能精确控制每个环节，错误也更容易定位。

基础模板长这样：

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

$ch = curl_init('https://api.example.com/login');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['email' => 'a@b.c', 'password' => '123']));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer abc123'
]);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

漏掉CURLOPT_RETURNTRANSFER => true会导致响应直接输出到页面，而不是返回字符串
json_encode()后必须手动加Content-Type: application/json头，否则API大概率拒收
用curl_getinfo($ch, CURLINFO_HTTP_CODE)拿状态码，别依赖$response内容判断成败

`json_decode()`失败？先检查`json_last_error()`和原始响应

json_decode($response)返回null不一定是JSON格式错，常见真凶是：响应根本不是JSON（比如HTML错误页）、BOM头、UTF-8编码不干净、或者$response本身就是false（cURL没设CURLOPT_RETURNTRANSFER）。

必须分两步排障：

if ($response === false) {
    echo 'cURL failed: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        echo 'JSON error: ' . json_last_error_msg();
        echo "\nRaw response: " . htmlspecialchars($response);
    }
}