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)
    {
        // 设置目标URL
        curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

        // 将响应数据写入到response_string
        curl_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)
    {
        // 设置URL
        curl_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、文件上传、身份验证等复杂功能。