C++：Http Post请求（附带源码）

最新推荐文章于 2025-06-11 09:47:22 发布

原创最新推荐文章于 2025-06-11 09:47:22 发布 · 1.1k 阅读

22 ·

CC 4.0 BY-SA版权

文章标签：

#http #网络协议 #网络

c、c++实战项目专栏收录该内容

516 篇文章

订阅专栏

C++ 实现 HTTP POST 请求

1. 项目实现思路

HTTP POST请求是HTTP协议中的一种请求方法，通常用于将数据发送到服务器，以创建或更新资源。在C++中，我们可以使用第三方库（如libcurl）来实现发送HTTP POST请求。

本项目的目标是：

使用libcurl库发起一个HTTP POST请求。
发送数据（例如JSON、表单数据等）到指定的服务器。
获取服务器的响应。

2. 项目步骤

2.1 安装 libcurl 库

libcurl是一个流行的C库，它支持多种协议，包括HTTP、HTTPS、FTP等。在使用它之前，我们需要确保系统已安装libcurl库。

Linux安装：

sudo apt-get install libcurl4-openssl-dev

Windows安装：

通过libcurl官网下载并安装libcurl库。

2.2 发送 HTTP POST 请求

我们将使用libcurl的API来实现HTTP POST请求。POST请求可以发送数据给服务器，数据可以是：

表单数据：以键值对的形式发送数据。
JSON数据：发送格式化的JSON字符串。

2.3 设置HTTP POST请求的参数

URL：指定服务器的地址。
请求头：如果发送JSON数据，需要设置Content-Type为application/json。
POST数据：指定发送的数据内容。

3. 实现代码

以下是C++中使用libcurl库实现HTTP POST请求的代码示例。

3.1 使用`libcurl`发送POST请求

#include <iostream>
#include <string>
#include <curl/curl.h>

// 回调函数，用于处理服务器的响应数据
size_t WriteCallback(void* contents, size_t size, size_t nmemb, void* userp) {
    size_t totalSize = size * nmemb;
    std::string* response = (std::string*)userp;
    response->append((char*)contents, totalSize);
    return totalSize;
}

int main() {
    CURL* curl;
    CURLcode res;
    std::string readBuffer;

    // 初始化libcurl
    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if (curl) {
        // 设置POST请求的目标URL
        const std::string url = "http://example.com/api"; // 替换为实际URL

        // POST请求的内容
        const std::string postData = "{\"name\":\"John\", \"age\":30}";

        // 设置URL
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());

        // 设置POST数据
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());

        // 设置请求头，指定Content-Type为application/json
        struct curl_slist* headers = nullptr;
        headers = curl_slist_append(headers, "Content-Type: application/json");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        // 设置响应回调函数
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);

        // 执行POST请求
        res = curl_easy_perform(curl);

        // 检查请求是否成功
        if (res != CURLE_OK) {
            std::cerr << "Request failed: " << curl_easy_strerror(res) << std::endl;
        } else {
            // 输出服务器响应
            std::cout << "Response: " << readBuffer << std::endl;
        }

        // 清理请求头
        curl_slist_free_all(headers);

        // 清理libcurl
        curl_easy_cleanup(curl);
    }

    // 清理全局库
    curl_global_cleanup();

    return 0;
}

4. 代码解读

4.1 需要包含的头文件

curl/curl.h：这是libcurl的头文件，提供了CURL的各种API接口。

4.2 回调函数 `WriteCallback`

WriteCallback是一个回调函数，它在libcurl接收到响应数据时被调用。我们将服务器的响应数据存储在readBuffer中，并在每次回调时将数据追加到该字符串中。

4.3 初始化和设置`libcurl`

初始化libcurl：通过curl_global_init()初始化libcurl库。
创建CURL句柄：通过curl_easy_init()创建一个CURL句柄，该句柄用于设置请求参数并执行请求。

4.4 设置POST请求的参数

目标URL：通过curl_easy_setopt(curl, CURLOPT_URL, url.c_str())设置要请求的URL。
设置POST数据：通过curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str())设置POST请求的内容。
设置请求头：使用curl_slist_append添加Content-Type: application/json头，告知服务器请求体为JSON格式。

4.5 执行请求

执行请求：通过curl_easy_perform(curl)执行POST请求。
获取响应数据：服务器响应会被WriteCallback函数处理，并存储在readBuffer中。

4.6 清理工作

清理请求头：通过curl_slist_free_all(headers)释放请求头。
清理CURL句柄：通过curl_easy_cleanup(curl)释放CURL句柄。
清理全局libcurl：通过curl_global_cleanup()清理全局libcurl状态。

5. 项目总结

通过这个项目，我们实现了一个简单的C++程序，使用libcurl库发送HTTP POST请求。这个示例可以扩展以支持不同类型的数据（如表单数据、文件上传等）以及更复杂的HTTP请求（如带认证的请求、GET请求等）。

扩展功能

表单数据提交：如果需要发送表单数据，可以使用curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "key1=value1&key2=value2");来设置表单字段。
文件上传：可以使用CURLOPT_UPLOAD和CURLOPT_READDATA来实现文件上传。
SSL/TLS加密请求：对于HTTPS请求，可以通过设置CURLOPT_SSL_VERIFYPEER等选项来处理SSL/TLS连接。
错误处理：可以根据HTTP响应代码（如404、500等）来执行错误处理。

通过libcurl，我们能够高效且灵活地处理HTTP请求，使得C++程序能够与Web服务器进行数据交互。