PHP Academy · 课时

处理 API 响应与错误

Q: 「处理 API 响应与错误」这节课中我会学到什么？

检查 HTTP 状态码，处理错误，并解析 API 负载。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

检查 HTTP 状态码，处理错误，并解析 API 负载。

处理 API 响应与错误 是 CoddyKit 上的免费 PHP Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

检查 HTTP 状态码

在处理响应正文之前，请始终检查 HTTP 状态码。

<?php
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($statusCode !== 200) {
    throw new RuntimeException("API error: HTTP $statusCode");
}

解析 JSON 响应

请解码 JSON 正文并处理解析错误。

<?php
$body = curl_exec($ch);
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
// $data is now a PHP array

错误响应正文

即使对于 4xx/5xx 响应，应用程序接口也经常会在正文中返回错误详细信息。发生错误时，请始终解析并记录正文。

<?php
if ($statusCode >= 400) {
    $err = json_decode($body, true);
    $msg = $err["message"] ?? "Unknown API error";
    throw new RuntimeException("API $statusCode: $msg");
}

cURL 传输错误

网络错误（DNS 失败、超时）不同于 HTTP 错误。请先检查 curl_errno()，然后再检查 HTTP 状态。

<?php
if (curl_errno($ch)) {
    throw new RuntimeException("Transport error: ".curl_error($ch));
}

封装到辅助函数中

请将 cURL 的设置、执行和错误处理封装到可复用的函数中。

<?php
function httpGet(string $url, string $token): array {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => ["Authorization: Bearer $token"],
        CURLOPT_TIMEOUT        => 15,
    ]);
    $body   = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $errno  = curl_errno($ch);
    curl_close($ch);
    if ($errno) throw new RuntimeException(curl_strerror($errno));
    if ($status >= 400) throw new RuntimeException("HTTP $status");
    return json_decode($body, true, 512, JSON_THROW_ON_ERROR);
}

重试逻辑

对于暂时性错误（503 服务不可用、超时），请使用指数退避并设置重试上限。

<?php
$maxRetries = 3;
for ($attempt = 0; $attempt < $maxRetries; $attempt++) {
    try {
        $data = httpGet($url, $token);
        break;
    } catch (RuntimeException $e) {
        if ($attempt === $maxRetries - 1) throw $e;
        sleep(2 ** $attempt);
    }
}

速率限制标头

许多应用程序接口都会包含速率限制标头：X-RateLimit-Remaining 和 X-RateLimit-Reset。请读取这些标头，以避免达到限制。

<?php
curl_setopt($ch, CURLOPT_HEADER, true);
// Parse headers from the response string

响应缓存

请缓存应用程序接口响应，以避免重复的网络调用。可以将响应存储在 Redis 或 APCu 中，并设置与数据新鲜度要求相匹配的 TTL。

记录应用程序接口调用

请记录请求 URL、方法、状态码和延迟，以便调试并监控生产环境中的应用程序接口健康状况。

将超时视为错误

cURL 超时（CURLE_OPERATION_TIMEDOUT）属于传输错误，而不是 HTTP 错误。请明确处理这种情况。

SSL 证书错误

证书验证失败（CURLE_SSL_CACERT）意味着服务器证书不受信任。请更新 CA 证书包，绝不要禁用验证。

总结

请始终先检查 cURL 错误号，然后检查 HTTP 状态。解析错误正文。将逻辑封装到可复用的函数中。为暂时性故障实现重试。

快速检查

应该先检查哪一个：cURL 错误号还是 HTTP 状态？

常见问题解答

「处理 API 响应与错误」课时是免费的吗？

是的 — 「处理 API 响应与错误」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。

「处理 API 响应与错误」这节课中我会学到什么？

检查 HTTP 状态码，处理错误，并解析 API 负载。你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 PHP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「处理 API 响应与错误」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 PHP Academy 课中编写并运行代码吗？

能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 PHP Academy