PHP curl_getinfo() 函数详解：如何获取 cURL 请求信息

M66 2025-07-15

PHP curl_getinfo() 函数详解：如何获取 cURL 请求信息

在 PHP 中，cURL 是一种强大的工具，用于发送和接收各种协议的数据，如 HTTP、FTP、SMTP 等。在进行 cURL 请求时，往往需要获取一些与请求相关的详细信息，例如请求的 URL、服务器响应的状态码、请求时间等。此时，PHP 提供的 curl_getinfo() 函数就显得尤为重要，它可以帮助我们获取这些信息。

curl_getinfo() 函数概述

curl_getinfo() 函数返回一个包含与 cURL 请求相关信息的关联数组。我们可以通过设置不同的选项来获取特定的信息，以下是一些常用的选项及其含义：

CURLOPT_EFFECTIVE_URL：以字符串形式返回请求的 URL 地址。
CURLOPT_HTTP_CODE：以整数形式返回服务器响应的 HTTP 状态码。
CURLOPT_RESPONSE_CODE：返回服务器响应的 HTTP 状态码（仅限 cURL 版本 7.10.8 及以上）。
CURLOPT_TOTAL_TIME：返回整个请求过程中花费的总时间（秒）。
CURLOPT_CONTENT_LENGTH_DOWNLOAD：返回下载内容的字节数。
CURLOPT_CONTENT_LENGTH_UPLOAD：返回上传内容的字节数。

如何使用 curl_getinfo() 获取请求信息

以下是一个使用 curl_getinfo() 函数的示例代码，演示如何获取 cURL 请求的相关信息：

// 创建一个 cURL 资源
$curl = curl_init();

// 设置请求的 URL 地址
curl_setopt($curl, CURLOPT_URL, "https://www.example.com");

// 执行请求
$response = curl_exec($curl);

// 获取请求的相关信息
$info = curl_getinfo($curl);

// 输出请求的 URL 地址
echo "请求的URL地址：" . $info['url'] . "<br>";

// 输出服务器响应的 HTTP 状态码
echo "HTTP 状态码：" . $info['http_code'] . "<br>";

// 输出整个请求过程花费的总时间
echo "总时间：" . $info['total_time'] . "秒<br>";

// 输出下载内容的字节数
echo "下载内容字节数：" . $info['download_content_length'] . "<br>";

// 输出上传内容的字节数
echo "上传内容字节数：" . $info['upload_content_length'] . "<br>";

// 关闭 cURL 资源
curl_close($curl);

在上述代码中，首先创建了一个 cURL 资源并设置了请求的 URL。然后通过执行请求，使用 curl_getinfo() 获取请求的相关信息，并将信息输出到页面上。最后关闭 cURL 资源。

总结

通过使用 curl_getinfo() 函数，开发者可以方便地获取与 cURL 请求相关的各种信息，无论是开发网页爬虫、调用 API 还是发送 HTTP 请求，掌握这个函数都能大大提高工作效率。

总而言之，curl_getinfo() 函数在 PHP 开发中非常实用，尤其是在使用 cURL 进行数据交互的场景下，它能够帮助我们获得详细的请求信息，从而更好地控制和处理请求。

curl_getinfo