如何正确使用 cURL 获取并解析 JSON API 响应为 PHP 对象-php教程-PHP中文网

如何正确使用 cURL 获取并解析 JSON API 响应为 PHP 对象

使用 cURL 发起 HTTP 请求时，默认返回的是原始 JSON 字符串，必须显式调用 json_decode() 才能将其转换为可访问属性的 PHP 对象（而非 file_get_contents 那样“看似自动”——实则仍需手动解码）。

使用 curl 发起 http 请求时，默认返回的是原始 json 字符串，必须显式调用 `json_decode()` 才能将其转换为可访问属性的 php 对象（而非 `file_get_contents` 那样“看似自动”——实则仍需手动解码）。

cURL 本身不负责解析响应内容，它只负责传输数据。与 file_get_contents() 一样，cURL 返回的始终是字符串（即原始 HTTP 响应体），即使该字符串是合法 JSON 格式。因此，你看到 var_dump($response) 输出 string(3279) "{...}" 是完全正常的——这不是 bug，而是预期行为。真正缺失的一步，是在 curl_exec() 之后主动执行 JSON 解析。

以下是推荐的、健壮且符合现代 PHP 实践的实现方式（兼容 PHP 8.0+）：

private function getFromApi($url): mixed
{
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true); // 自动处理重定向（可选但建议）
    curl_setopt($curl, CURLOPT_TIMEOUT, 15);           // 设置超时，避免无限等待
    curl_setopt($curl, CURLOPT_USERAGENT, 'PHP-cURL/1.0'); // 某些 API 要求 User-Agent

    $response = curl_exec($curl);
    $error = curl_error($curl);
    $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    curl_close($curl);

    if ($error) {
        throw new Exception("cURL request failed: {$error}");
    }

    if ($httpCode !== 200) {
        throw new Exception("HTTP {$httpCode} error received from API");
    }

    // ✅ 关键：将 JSON 字符串解码为对象（stdClass）
    // 使用 JSON_THROW_ON_ERROR 确保解析失败时抛出异常，便于调试
    $object = json_decode($response, flags: JSON_THROW_ON_ERROR);

    if (!isset($object->status) || $object->status !== 'ok') {
        $message = $object->status_message ?? 'Unknown API error';
        throw new Exception("API request failed: {$message}");
    }

    return $object->data;
}

? 注意：json_decode($response) 默认返回 stdClass 对象，支持 $obj->property 访问；若需关联数组，传入第二个参数 true（即 json_decode($response, true)）。

Wjs Reframing Video
用于在保持宽高比倒置的情况下，将视频从横向转换为纵向或反之（例如 16:9 ↔ 9:16，4:3 ↔ 3:4 等）

下载