使用C++和libcurl库实现HTTP请求（GET、POST、文件上传）

已于 2024-11-06 09:41:55 修改
阅读量1.9k 收藏 12
点赞数 5
CC 4.0 BY-SA版权
文章标签： c++ http 网络
于 2024-11-06 09:40:38 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/dubochao_xinxi/article/details/143559336

在现代软件开发中，与外部API服务进行通信已成为常见需求。本文将展示如何使用C++和libcurl库实现基本的HTTP请求，包括GET请求、POST请求（带JSON数据）以及包含文件上传的POST请求。

准备工作

首先，需要确保已安装libcurl库，并正确链接到项目中。如果还没有安装libcurl，可以在libcurl官网找到安装方法。使用CMake构建项目时，可以在CMakeLists.txt中指定库路径，确保CURL能够找到：

# set(CMAKE_PREFIX_PATH "${CMAKE_SOURCE_DIR}/libcurl/share/curl")  # 替换为 CURL 安装的实际路径
find_package(CURL REQUIRED)
target_link_libraries(your_project_name PRIVATE CURL::libcurl)

基本结构

代码的核心是三个函数，分别用于GET请求、带JSON的POST请求和包含文件上传的POST请求。每个函数使用了libcurl的不同配置来处理具体需求。

代码结构和功能实现

1. req_reply：处理请求响应的函数

这个函数是libcurl的回调函数，用于处理从服务器返回的数据，将数据写入到指定的字符串流中。

size_t req_reply(void *ptr, size_t size, size_t nmemb, void *stream) {
    string *str = (string *) stream;
    (*str).append((char *) ptr, size * nmemb);
    return size * nmemb;
}
2. GET 请求

GET请求是最常用的请求类型，用于从服务器获取资源。curl_get_req函数实现了GET请求，通过curl_easy_setopt函数来设置URL和请求参数。

CURLcode curl_get_req(const std::string &url, std::string &response) {
    CURL *curl = curl_easy_init();
    CURLcode res;
    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);  // 忽略SSL证书验证
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, req_reply);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *) &response);
        curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);
        res = curl_easy_perform(curl);
        curl_easy_cleanup(curl);
    }
    return res;
}
3. 发送带JSON数据的POST请求

POST请求通常用于将数据发送到服务器，尤其是RESTful API。curl_post_json函数可以发送包含JSON数据的POST请求，代码通过设置Content-Type头为application/json来指定数据类型。

CURLcode curl_post_json(const string &url, const string &jsonData, string &response) {
    CURL *curl = curl_easy_init();
    CURLcode res;
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Content-Type: application/json");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_POST, 1);
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, jsonData.c_str());
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, req_reply);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *) &response);
        res = curl_easy_perform(curl);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return res;
}
4. 发送包含JSON和文件的POST请求

在某些情况下，我们可能需要同时发送JSON数据和文件。这里用curl_mime实现多部分表单上传。curl_mime允许将JSON数据和文件字段一起打包并发送给服务器。

CURLcode curl_post_with_file(const string &url, const string &jsonData, const string &filePath, string &response) {
    CURL *curl = curl_easy_init();
    CURLcode res;
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Content-Type: multipart/form-data");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        // 创建 MIME 表单
        curl_mime *form = curl_mime_init(curl);

        // 添加 JSON 数据字段
        curl_mimepart *jsonField = curl_mime_addpart(form);
        curl_mime_name(jsonField, "json");
        curl_mime_data(jsonField, jsonData.c_str(), CURL_ZERO_TERMINATED);
        curl_mime_type(jsonField, "application/json");

        // 添加文件字段
        curl_mimepart *fileField = curl_mime_addpart(form);
        curl_mime_name(fileField, "file");
        curl_mime_filedata(fileField, filePath.c_str());
        curl_mime_type(fileField, "image/png");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_MIMEPOST, form);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, req_reply);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *) &response);
        res = curl_easy_perform(curl);

        curl_mime_free(form);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return res;
}

测试用例

最后，我们在main函数中展示了三个测试用例，分别是GET请求、带JSON数据的POST请求和带文件的POST请求。

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

using namespace std;

// 请求的回复处理函数
size_t req_reply(void *ptr, size_t size, size_t nmemb, void *stream) {
    string *str = (string *) stream;
    (*str).append((char *) ptr, size * nmemb);
    return size * nmemb;
}

// HTTP GET 请求
CURLcode curl_get_req(const std::string &url, std::string &response) {
    CURL *curl = curl_easy_init();
    CURLcode res;
    if (curl) {
        // 设置 URL 地址
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        // 设置忽略 SSL 证书验证
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);
        curl_easy_setopt(curl, CURLOPT_VERBOSE, 1);
        // 设置回复处理函数
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, req_reply);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *) &response);
        curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);
        curl_easy_setopt(curl, CURLOPT_HEADER, 1);
        // 设置连接和响应超时时间
        curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);
        res = curl_easy_perform(curl);  // 执行 GET 请求
        curl_easy_cleanup(curl);  // 清理 curl 资源
    }
    return res;
}

// 发送带有 JSON 数据的 HTTP POST 请求
CURLcode curl_post_json(const string &url, const string &jsonData, string &response) {
    CURL *curl = curl_easy_init();
    CURLcode res;
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Content-Type: application/json"); // 设置 JSON 类型头部
        //    headers = curl_slist_append(headers, ("appcode: " + appcode).c_str());
        //    headers = curl_slist_append(headers, ("User-Agent: " + agent).c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        // 设置 POST 请求参数
        curl_easy_setopt(curl, CURLOPT_POST, 1);
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, jsonData.c_str());
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);
        curl_easy_setopt(curl, CURLOPT_VERBOSE, 1);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, req_reply);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *) &response);
        curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);
        curl_easy_setopt(curl, CURLOPT_HEADER, 1);
        curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);
        res = curl_easy_perform(curl);  // 执行 POST 请求

        curl_slist_free_all(headers); // 释放头部内存
        curl_easy_cleanup(curl);  // 清理 curl 资源
    }
    return res;
}

// 发送包含 JSON 数据和文件的 POST 请求
CURLcode curl_post_with_file(const string &url, const string &jsonData, const string &filePath, string &response) {
    CURL *curl = curl_easy_init();
    CURLcode res;
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Content-Type: multipart/form-data"); // 设置多部分表单头部
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        // 创建 MIME 表单
        curl_mime *form = curl_mime_init(curl);

        // 添加 JSON 数据字段
        curl_mimepart *jsonField = curl_mime_addpart(form);
        curl_mime_name(jsonField, "json");
        curl_mime_data(jsonField, jsonData.c_str(), CURL_ZERO_TERMINATED);
        curl_mime_type(jsonField, "application/json");

        // 添加文件字段
        curl_mimepart *fileField = curl_mime_addpart(form);
        curl_mime_name(fileField, "file");
        curl_mime_filedata(fileField, filePath.c_str());
        curl_mime_type(fileField, "image/png");  // 设置文件类型为 image/png

        // 设置 CURL 参数
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_MIMEPOST, form);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, req_reply);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *) &response);
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10);

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

        // 清理 MIME 表单和头部
        curl_mime_free(form);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return res;
}

int main() {
    curl_global_init(CURL_GLOBAL_ALL);

    // 测试 GET 请求
    string getUrlStr = "http://cn.bing.com/images/trending?form=Z9LH";
    string getResponseStr;
    auto res = curl_get_req(getUrlStr, getResponseStr);
    if (res != CURLE_OK)
        cerr << "GET 请求失败: " + string(curl_easy_strerror(res)) << endl;
    else
        cout << getResponseStr << endl;

    // JSON POST 请求
    string postUrlStr = "https://api.example.com/endpoint";
    string jsonData = R"({"key1": "value1", "key2": "value2"})";
    string postResponseStr;
    res = curl_post_json(postUrlStr, jsonData, postResponseStr);
    if (res != CURLE_OK)
        cerr << "POST 请求失败: " + string(curl_easy_strerror(res)) << endl;
    else
        cout << postResponseStr << endl;

    // JSON 和文件的 POST 请求
    string postfileStr = "https://api.example.com/upload";
    string filePath = "path/to/image.png";  // 指定上传的文件路径

    res = curl_post_with_file(postfileStr, jsonData, filePath, postResponseStr);
    if (res != CURLE_OK)
        cerr << "文件 POST 请求失败: " + string(curl_easy_strerror(res)) << endl;
    else
        cout << "服务器响应:\n" << postResponseStr << endl;
    // 清空
    curl_global_cleanup();
    system("pause");
    return 0;
}

总结

使用libcurl实现HTTP请求是与外部API或服务器进行通信的强大工具。本文展示了如何发送GET请求、带JSON数据的POST请求以及包含文件的POST请求，涵盖了许多实际应用中的需求。通过合理配置libcurl选项，可以轻松实现高效且可靠的网络请求。

dbcccccsds
关注
libCurl的文件上传
阿伦的专栏
10-11 1万+
最近在需要使用curl的上传功能，使用libCurl来实现。因此，先使用curl命令操作，然后再使用libCurl实现。 基于Http协议的文件上传的标准方法是： 基于POST Form的文件上传  RFC1867。 这个方法使用非常广泛，这个RFC规定了FORM上传
“使用libcurl实现C++中HTTP POST与GET请求”
最新发布
06-24
在CSDN博客中，作者详细介绍了一种基于libcurl库实现HTTP GET和POST请求的方法，并将这两种请求封装为http_get和http_post函数，使得调用过程极为简便，仅需一行代码即可完成相应的网络请求操作。 具体来说，作者...
libcurl post带参数请求
洛的博客
07-22 3781
1、参数特殊字符转换   curl_easy_escape函数及curl_escape函数都可以将参数中的所有不符合URL规定的字符转化为其对应的%XX 形式。   curl_escape函数是旧的API，其内部调用的是curl_easy_escape函数只不过handle设置为NULL了。 两个函数调用返回的字符串都要调用curl_free或free函数释放。 2、设置post参数   使用CURLOPT_POSTFIELDS添加post参数 CURL *curl; CURLcode res;
使用libcurl进行上传文件
keke20120623的博客
07-13 259
使用libcurl进行上传文件 #上传文件 传统的使用socket协议上传文件，比较复杂，任何一步出现问题就不能正常上传，使用libcurl上传，只用把参数拼接好，写好上传模式就可以上传文件了，具体上传参看代码： int CHttpOperate::CurlUploadFile(string picpath,string filename, string filercode, string strmd5, string strTimeStap, string strserverurl,string &am
QT中使用libcurl库实现到ftp服务器的上传和下载
qq_45059758的博客
06-05 501
本文分享了使用libcurl库实现FTP文件上传下载的实践经验。记录了从零开始搭建FTP服务的过程，提供了已编译的libcurl库下载链接（夸克网盘）。对于下载功能，展示了获取FTP目录文件列表的实现方案，包括writeCallback回调函数和parseFileList解析方法。文中还详细说明了常见问题解决方案，如上传路径必须包含文件名、被动模式设置等注意事项，为初学者提供了完整的代码示
libcurl 上传文件
10-20
vc6 工程 ，上传文件到web服务器
c++使用libcurl上传文件
qianbo042311的博客
06-11 2089
使用libculr上传文件，使用nodejs做一个测试服务端
curl post表单上传文件(C++)
热门推荐
Andy Tools
09-19 1万+
最近测试如何上传文件到服务器。原来传照片一致通过binary 形式传文件，或者把图片base64编码传图片。一致没有用form-data 表单形式发送数据,今天尝试下如何使用libcurl提供的API上传文件。 Sample code： #include &amp;amp;amp;lt;iostream&amp;amp;amp;gt; #include &amp;amp;amp;lt;curl/curl.h&amp;amp;amp;gt; #include &
c++使用libcurl上传和下载资源
06-11
本篇文章将深入探讨如何在C++中使用`libcurl`进行文件的上传和下载，并结合`nodejs`测试服务端来验证实现。 `libcurl`是一个免费的开源库，用于在各种协议（包括HTTP、HTTPS、FTP等）下进行文件传输。它提供了丰富...
C++ http post get请求，第三方库，调试的时候，使用wireshark抓包，对比
02-21
本篇文章将深入探讨如何在C++中实现HTTP POST和GET请求，并介绍在调试过程中使用第三方库libcurl以及网络封包分析工具Wireshark。 1. **C++中的HTTP GET和POST请求** - **GET请求**：在C++中，GET请求可以通过直接...
libcurl 作为ftp客户端上传文件
05-19
libcurl 作为ftp客户端上传文件，VS2008 QT4.7
window C++ libcurl 访问https demo
04-23
2019年4月23日 在window 10 64bit ，visual studio 2013环境下编译了curl-7.64.1 库，整合了openssl-1.0.2m。 本测试程序使用libcurl 加载https://www.baidu.com,返回结果后转码ASCII打印。 便于window C++开发者直接使用。
c++文件post上传服务器
12-25
好不容易找到的，现在已经把它加在我的代码里了，很好用，高手一看就明白了。我是用HttpWatch来获取上传的参数的，把它替换掉代码里的参数就可以了！很经典。vc6.0编译通过！
C++ libcurl ftp上传文件
05-19
C++ libcurl ftp上传文件
http 文件 上传 C++ 版本
11-19
略做修改可以下载文件 使用前 请对HTTP协议有个基本理解
C++实现HTTP GET，POST请求
04-17
本篇文章将详细探讨如何使用C++来实现HTTP GET和POST请求，以及涉及HTTPS的安全连接。 HTTP GET请求是HTTP协议中最基础的操作之一，主要用于从服务器获取资源。GET请求的所有参数都包含在URL中，因此它是透明且可...
基于libcurl的c++ http POST 和 GET
01-07
将GET和POST整理成http_get和http_post两个函数方便使用，一句话即可调用。详细使用方式：https://blog.csdn.net/suiyingy/article/details/122365449
c++ 实现 http 上传和下载
weixin_34233618的博客
02-16 1509
代码下载地址:   http://download.csdn.net/detail/mtour/8243527         最近写了个程序需要用到http通讯，由于flash空间比较小，没有考虑 libcurl库，用c++封装了一个http类，实现了http  文件上传和下载          [cpp] view plain copy     #include...
java后端请求gpt接口 打字机效果响应给前端
04-01
### 实现 Java 后端调用 GPT 接口并返回带有打字机效果的响应 为了实现这一功能，可以分为以下几个部分来描述解决方案： #### 1. 调用 GPT API 的后端逻辑 在 Java 中可以通过 HTTP 客户端库（如 `HttpClient` 或 `OkHttp`）向 GPT 提供的 RESTful API 发送请求。以下是基于 OpenAI GPT-3 API 的示例代码[^1]。 ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class GptApiCaller { private static final String OPENAI_API_KEY = "your-api-key"; private static final String ENDPOINT_URL = "https://api.openai.com/v1/completions"; public String callGpt(String prompt) throws Exception { HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(ENDPOINT_URL)) .header("Authorization", "Bearer " + OPENAI_API_KEY) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(""" {"model":"text-davinci-003","prompt":"%s","max_tokens":50} """.formatted(prompt))) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); return parseResponse(response.body()); // 解析 JSON 响应中的实际文本数据 } private String parseResponse(String responseBody) { // 使用 JSON 库解析字符串 (e.g., Jackson or Gson)，提取 'choices.text' return null; // 返回处理后的文本 } } ``` 上述代码展示了如何通过 POST 请求发送提示给 GPT 并获取其完成的结果[^2]。 --- #### 2. 将结果以流的形式传输至前端 为了让前端能够实时接收到字符级的数据更新，可以采用 WebSocket 技术或者 Server-Sent Events (SSE)[^3] 来实现实时通信。这里提供一种 SSE 方法作为例子： ##### 配置 Spring Boot 控制器支持 SSE 输出 如果使用的是 Spring Boot，则可以在控制器方法上启用事件流模式如下所示： ```java import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.servlet.mvc.method.annotation.SseEmitter; @RestController @RequestMapping("/stream") public class TypewriterController { @GetMapping(value = "/gpt-typewriter", produces = "text/event-stream") public SseEmitter streamTypewriterEffect() { SseEmitter emitter = new SseEmitter(); try { StringBuilder sb = new StringBuilder(); // 存储完整的 GPT 响应 // 模拟逐字符推送过程 char[] chars = getGptResponse().toCharArray(); // 获取来自 GPT 的完整响应 for (char c : chars) { Thread.sleep(75); // 创建延迟模拟打字速度 sb.append(c); emitter.send(SseEmitter.event().data(sb.toString())); // 发送当前累积的内容 } emitter.complete(); // 结束流 } catch (Exception e) { emitter.completeWithError(e); // 处理错误情况 } return emitter; } private String getGptResponse() throws Exception { // 这里调用之前定义好的 GptApiCaller 类的方法 return new GptApiCaller().callGpt("Your Prompt Here"); } } ``` 此片段实现了服务器端将 GPT 文本逐步推送给客户端的功能[^4]。 --- #### 3. 前端接收与展示 最后，在前端页面中订阅该事件源即可显示动态加载的效果。下面是一个简单的 HTML 和 JavaScript 片段用于演示目的： ```html <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>GPT Typewriter</title> </head> <body> <div id="output"></div> <script type="text/javascript"> const eventSource = new EventSource('/stream/gpt-typewriter'); eventSource.onmessage = function(event) { document.getElementById('output').innerText = event.data; }; // 错误处理机制可选加入 eventSource.onerror = () => console.error('Event Source Failed'); </script> </body> </html> ``` 这样就完成了整个流程的设计和实施说明[^5]。 ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值