c++开发之网络篇curl

libcurl 是一个功能强大的库，常用于在 C 和 C++ 程序中执行 HTTP 请求、处理 URL 资源。下面是关于如何在 C++ 中使用 libcurl 的详细指南，以及一个基础的示例代码。

1. 安装 `libcurl`

在使用之前，确保你已经安装了 libcurl 库。根据操作系统，安装方式不同：

Ubuntu / Debian:

sudo apt-get install libcurl4-openssl-dev

CentOS / RHEL:

sudo yum install libcurl-devel

Windows: 可以使用 vcpkg 进行安装。

2. 编译 C++ 代码时链接 `libcurl`

编译时需要链接 libcurl，可以在编译时添加 -lcurl 选项。

g++ your_program.cpp -o your_program -lcurl

3. 基本的 HTTP 请求操作

GET 请求

GET 请求是最常见的 HTTP 操作，用来从服务器获取资源。下面是一个 GET 请求的简单例子：

#include <iostream>
#include <curl/curl.h>// 回调函数，libcurl会将服务器的响应传递给这个函数
size_t WriteCallback(void *contents, size_t size, size_t nmemb, void *userp)
{((std::string*)userp)->append((char*)contents, size * nmemb);return size * nmemb;
}int main()
{CURL *curl;CURLcode res;std::string response_string;// 初始化curl环境curl_global_init(CURL_GLOBAL_DEFAULT);// 初始化curl句柄curl = curl_easy_init();if (curl){// 设置目标URLcurl_easy_setopt(curl, CURLOPT_URL, "http://example.com");// 将响应数据写入到response_stringcurl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response_string);// 执行GET请求res = curl_easy_perform(curl);// 检查返回的状态码if (res != CURLE_OK){std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;}else{// 打印响应std::cout << "Response: " << response_string << std::endl;}// 清理curl句柄curl_easy_cleanup(curl);}// 全局清理curl_global_cleanup();return 0;
}

关键步骤说明：

curl_easy_init()：初始化一个 CURL 句柄。
curl_easy_setopt()：设置 CURL 请求的各种选项，例如 URL、回调函数等。
curl_easy_perform()：执行请求并接收服务器响应。
curl_easy_cleanup()：释放 CURL 句柄。
curl_global_init() 和 curl_global_cleanup()：在整个程序中只需要调用一次，分别用于全局初始化和清理。

POST 请求

POST 请求用于将数据提交到服务器，例如表单数据提交。下面是一个 POST 请求的例子：

#include <iostream>
#include <curl/curl.h>size_t WriteCallback(void *contents, size_t size, size_t nmemb, void *userp)
{((std::string*)userp)->append((char*)contents, size * nmemb);return size * nmemb;
}int main()
{CURL *curl;CURLcode res;std::string response_string;curl_global_init(CURL_GLOBAL_DEFAULT);curl = curl_easy_init();if (curl){// 设置URLcurl_easy_setopt(curl, CURLOPT_URL, "http://example.com/login");// 指定为POST请求curl_easy_setopt(curl, CURLOPT_POST, 1L);// 设置POST字段curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "username=user&password=pass");// 设置写回调函数curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response_string);// 执行POST请求res = curl_easy_perform(curl);if (res != CURLE_OK){std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;}else{std::cout << "Response: " << response_string << std::endl;}curl_easy_cleanup(curl);}curl_global_cleanup();return 0;
}

关键步骤说明：

curl_easy_setopt(curl, CURLOPT_POST, 1L)：指定 POST 请求。
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "data")：设置 POST 字段。

4. 常用 `libcurl` 选项

CURLOPT_URL：设置请求的 URL。
CURLOPT_WRITEFUNCTION：指定响应回调函数，用于处理服务器返回的数据。
CURLOPT_WRITEDATA：指定传递给回调函数的用户数据。
CURLOPT_POST：将请求设置为 POST。
CURLOPT_POSTFIELDS：设置 POST 请求的数据。
CURLOPT_HTTPHEADER：设置自定义 HTTP 头部。
CURLOPT_TIMEOUT：设置请求的超时时间。
CURLOPT_FOLLOWLOCATION：自动跟踪重定向。

5. 处理 HTTP 头部

可以通过 CURLOPT_HTTPHEADER 来设置自定义的 HTTP 头部。例如，添加 Content-Type: application/json 头部。

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

6. SSL 支持

如果你想使用 HTTPS 连接，可以使用以下选项来忽略 SSL 证书验证（不推荐在生产环境中使用）：

curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);

7. 完整编译示例

g++ example.cpp -o example -lcurl

8. 使用 `libcurl` 时的常见问题

没有链接 libcurl：编译时如果忘记了 -lcurl 会导致链接错误。
SSL 问题：在处理 HTTPS 请求时，需要安装相应的 SSL 库，并确保 SSL 证书的正确性。
响应回调未正确处理：确保 CURLOPT_WRITEFUNCTION 正确设置，且回调函数能正确处理数据。

结论

libcurl 是一个强大的库，能够简便地实现 HTTP GET 和 POST 请求。它的功能非常全面，支持重定向、SSL、cookie、文件上传、身份验证等复杂功能。