curl操作之Get/Post/上传文件 参数设置以及调用细节

原创 已于 2024-10-25 10:42:30 修改 · 4.9k 阅读 · 1 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
标签
#服务器 #c++
于 2022-11-10 14:10:29 首次发布
该博客详细介绍了如何使用C++实现一个HTTP客户端，支持GET、POST和文件上传操作。通过Curl库初始化参数，设置各种HTTP请求选项，包括设置超时、SSL验证、回调函数等。同时，还展示了如何处理进度回调、读写回调以及获取请求的交互时间等信息。此外，还提供了上传文件的核心参数设置和外部调用的示例代码。

        curl 是一个强大的命令行工具，用于与 URL 进行数据传输，支持多种协议。以下是使用 curl 进行 GET、POST 请求和文件上传的详细参数设置和调用细节。

1. GET 请求

        GET 请求用于从服务器获取数据。

示例

   curl -X GET "http://example.com/api/resource?param1=value1&param2=value2"

参数说明
  • -X GET：显式指定使用 GET 方法（通常可以省略，因为 curl 默认使用 GET）。
  • URL：请求的目标 URL，可以附带查询参数。
其他常用选项
  • -H "Authorization: Bearer <token>"：添加请求头，如授权信息。
  • -o output.txt：将响应内容写入文件。

2. POST 请求

        POST 请求用于向服务器提交数据。

示例

   curl -X POST "http://example.com/api/resource" -d "param1=value1&param2=value2"

参数说明
  • -X POST：显式指定使用 POST 方法。
  • -d：后面跟随数据，格式可以是 key=value 的形式。可以多次使用 -d 添加多个参数。
使用 JSON 数据

        如果要发送 JSON 数据，可以使用 -H 选项设置内容类型：curl -X POST "http://example.com/api/resource" -H "Content-Type: application/json" -d '{"param1":"value1", "param2":"value2"}'

3. 上传文件

        上传文件通常使用 POST 请求。curl -X POST "http://example.com/upload" -F "file=@/path/to/file.txt"

参数说明
  • -F：表示表单数据，后面跟随 file=@/path/to/file.txt，其中 @ 表示读取本地文件。
  • 可以同时上传多个文件：curl -X POST "http://example.com/upload" -F "file1=@/path/to/file1.txt" -F "file2=@/path/to/file2.jpg"

4. 其他常用选项

  • -H：添加自定义请求头。
  • -v：显示详细的请求和响应信息，便于调试。
  • -L：跟随重定向。
  • --data-urlencode：对数据进行 URL 编码。

5. 综合示例

以下是一个综合示例，展示如何使用 GET 和 POST 请求、上传文件以及设置请求头：

# GET 请求 curl -X GET "http://example.com/api/resource?param1=value1" # POST 请求 curl -X POST "http://example.com/api/resource" -H "Content-Type: application/json" -d '{"param1":"value1", "param2":"value2"}' # 上传文件 curl -X POST "http://example.com/upload" -F "file=@/path/to/file.txt" -H "Authorization: Bearer <token>"

6. 注意事项

  • 确保 URL 正确，特别是在 POST 和文件上传的情况下。
  • 对于需要认证的 API，确保传递必要的认证信息。
  • 检查返回的状态码和响应内容，以确保请求成功。

        通过合理使用 curl 的各种选项，可以方便地与 HTTP 服务进行交互，进行数据获取、提交和文件上传等操作。

7. 工程代码实例

  • Curl初始化参数
    // 这个接口里面设置的参数选项已经完全覆盖了 Get、Post、HttpPost(文件上传)操作    
    int HttpClient::initCurl(const HttpClientUrlArgs &urlArgs) {
        auto headers = urlArgs.headers;
        std::vector<std::string> ips;
        if (XXX::XXX::GetInstance().GetProxyConfigInfo().m_httpDnsEnable) {
            ips = XXX::XXX::GetInstance().GetIpsByHostName(urlArgs.hostName);
        }

        if (ips.empty()) {
            m_requestUrl = XXX::SplicingUrl(urlArgs.protocol, urlArgs.hostName, urlArgs.port, urlArgs.url, urlArgs.args);
        } else {
            m_requestUrl = XXX::SplicingUrl(urlArgs.protocol, ips[RandomNum()%ips.size()], urlArgs.port, urlArgs.url, urlArgs.args);
            headers.emplace("Host", urlArgs.hostName);
        }

        if (m_pCurl != nullptr) {
            curl_easy_cleanup(m_pCurl);
            m_pCurl = nullptr;
        }
        if (m_pHeadList != nullptr) {
            curl_slist_free_all(m_pHeadList);
            m_pHeadList = nullptr;
        }

        m_pCurl = curl_easy_init();
        if (m_pCurl == nullptr) {
            return -1;
        }

        curl_easy_setopt(m_pCurl, CURLOPT_URL, m_requestUrl.c_str()); // 请求地址
        curl_easy_setopt(m_pCurl, CURLOPT_ACCEPT_ENCODING, "");
        curl_easy_setopt(m_pCurl, CURLOPT_NOSIGNAL, 1L);
        curl_easy_setopt(m_pCurl, CURLOPT_TIMEOUT, 10L);
        curl_easy_setopt(m_pCurl, CURLOPT_SSL_VERIFYHOST, 0L);
        curl_easy_setopt(m_pCurl, CURLOPT_SSL_VERIFYPEER, false);
        curl_easy_setopt(m_pCurl, CURLOPT_WRITEFUNCTION, HttpClientOnWriteCallback); // 写回调：如Post、HttpPost
        curl_easy_setopt(m_pCurl, CURLOPT_WRITEDATA, this);
        curl_easy_setopt(m_pCurl, CURLOPT_READFUNCTION, HttpClientOnReadCallback); // 读回调：如Get
        curl_easy_setopt(m_pCurl, CURLOPT_READDATA, this);
        curl_easy_setopt(m_pCurl, CURLOPT_MAXREDIRS, 10L);
        curl_easy_setopt(m_pCurl, CURLOPT_FOLLOWLOCATION, 1L);
        curl_easy_setopt(m_pCurl, CURLOPT_NOPROGRESS, 0L);
        curl_easy_setopt(m_pCurl, CURLOPT_DNS_USE_GLOBAL_CACHE, 0L);
        curl_easy_setopt(m_pCurl, CURLOPT_PROGRESSDATA, this);
        curl_easy_setopt(m_pCurl, CURLOPT_PROGRESSFUNCTION, HttpClientOnProgressCallback);
        curl_easy_setopt(m_pCurl, CURLOPT_FAILONERROR, 1L);

        m_pHeadList = curl_slist_append(m_pHeadList, "Expect:");
        if (!headers.empty()) {
            for (const auto& it : headers) {
                auto tmp = it.first + ": " + it.second;
                m_pHeadList = curl_slist_append(m_pHeadList, tmp.c_str());
            }
        }

        curl_easy_setopt(m_pCurl, CURLOPT_HTTPHEADER, m_pHeadList);
        return 0;
    }
  • 上传文件核心参数
    int HttpClient::OnProgressCallback(double dt, double dn, double ult, double uln) {
        if (m_isExit != nullptr && m_isExit()) {
            return -1;
        }
        return 0;
    }
    
    // 读回调
    size_t HttpClient::OnReadCallback(void *buffer, size_t size, size_t nmemb, void *arg){
        return nmemb*size;
    }

    // 写回调
    size_t HttpClient::OnWriteCallback(void *buffer, size_t size, size_t nmemb, void *arg) {
        if (buffer != nullptr && size > 0 && nmemb > 0) {
            m_result.append((char*)buffer, size*nmemb);
        }
        return size*nmemb;
    }

    // 获取必要的参数 具体看需求
    void HttpClient::UpdateInfo() {
        if (m_pCurl == nullptr) {
            return;
        }
        double dnsTime = 0;
        if (curl_easy_getinfo(m_pCurl, CURLINFO_NAMELOOKUP_TIME, &dnsTime) == CURLE_OK) {
            m_iDnsTime = dnsTime*1000;
        }
        long code = 0;
        if (curl_easy_getinfo(m_pCurl, CURLINFO_RESPONSE_CODE, &code) == CURLE_OK) {
            m_iCurlCode = code;
        }
        char *ip = nullptr;
        if ((curl_easy_getinfo(m_pCurl, CURLINFO_PRIMARY_IP, &ip) == CURLE_OK) && (ip != nullptr)) {
            m_remoteIp = ip;
        }
        double temp = 0.0;
        const unsigned int k_dwThousand = 1000;
        if (curl_easy_getinfo(m_pCurl, CURLINFO_TOTAL_TIME, &temp) == CURLE_OK) {
            m_interactionTime.dwTotalTime = (uint32_t)(temp * k_dwThousand);
        }
        if (curl_easy_getinfo(m_pCurl, CURLINFO_NAMELOOKUP_TIME, &temp) == CURLE_OK) {
            m_interactionTime.dwNameLookupTime = (uint32_t)(temp * k_dwThousand);
        }
        if (curl_easy_getinfo(m_pCurl, CURLINFO_CONNECT_TIME, &temp) == CURLE_OK) {
            m_interactionTime.dwConnectTime = (uint32_t)(temp * k_dwThousand);
        }
        if (curl_easy_getinfo(m_pCurl, CURLINFO_PRETRANSFER_TIME, &temp) == CURLE_OK) {
            m_interactionTime.dwPretransferTime = (uint32_t)(temp * k_dwThousand);
        }
        if (curl_easy_getinfo(m_pCurl, CURLINFO_FILETIME, &m_interactionTime.lFileTime) == CURLE_OK) {
            
        }
        if (curl_easy_getinfo(m_pCurl, CURLINFO_STARTTRANSFER_TIME, &temp) == CURLE_OK) {
            m_interactionTime.dwStartTransferTime = (uint32_t)(temp * k_dwThousand);
        }
        if (curl_easy_getinfo(m_pCurl, CURLINFO_REDIRECT_TIME, &temp) == CURLE_OK) {
            m_interactionTime.dwRedirectTime = (uint32_t)(temp * k_dwThousand);
        }
        if (curl_easy_getinfo(m_pCurl, CURLINFO_APPCONNECT_TIME, &temp) == CURLE_OK) {
            m_interactionTime.dwAppconnetTime = (uint32_t)(temp * k_dwThousand);
        }
    }

    // Get操作
    int HttpClient::GetData(std::string &result, const HttpClientUrlArgs &urlArgs) {
        if (initCurl(urlArgs) != 0) {
            xerror2(TSF"init curl error!");
            return -1;
        }

        m_result.clear();
        auto res = curl_easy_perform(m_pCurl);
        if (res != CURLE_OK) {
            xerror2(TSF"url: %_, res: %_", m_requestUrl.c_str(), res);
        }

        result.clear();
        result = std::move(m_result);
        UpdateInfo();
        return res;
    }

    // Post操作
    int HttpClient::PostData(std::string &result, const HttpClientUrlArgs &urlArgs, const std::string &content) {
        result.clear();
        if (initCurl(urlArgs) != 0) {
            xerror2(TSF"init curl error!");
            return -1;
        }
        curl_easy_setopt(m_pCurl, CURLOPT_POST, true);
        curl_easy_setopt(m_pCurl, CURLOPT_POSTFIELDS, content.c_str());
        m_result.clear();
        auto res = curl_easy_perform(m_pCurl);
        if (res != CURLE_OK) {
            xerror2(TSF"url: %_, res: %_", m_requestUrl.c_str(), res);
        }
        result = std::move(m_result);
        UpdateInfo();
        return res;
    }

    // 上传文件操作
    int HttpClient::PostBinaryData(std::string &result, const HttpClientUrlArgs &urlArgs, const std::string &filePath, const std::string &fileName) {
                if (initCurl(urlArgs) != 0) {
            xerror2(TSF"init curl error!");
            return -1;
        }

        if (m_pFormpost != nullptr) {
            curl_formfree(m_pFormpost);
            m_pFormpost = nullptr;
        }

        struct curl_httppost *lastPtr = nullptr;
        // 注意参数顺序, 这块踩过坑; 之前因为参数顺序问题查了好久
        curl_formadd(&m_pFormpost, &lastPtr, CURLFORM_PTRNAME, "log_file", CURLFORM_FILENAME, fileName.c_str(), CURLFORM_FILE, filePath.c_str(), CURLFORM_END);
        
        // 跟服务端定 需要什么字段, 就如下写法加什么字段
        curl_formadd(&m_pFormpost, &lastPtr, CURLFORM_PTRNAME, "client_id", CURLFORM_PTRCONTENTS, XXX.c_str(), CURLFORM_END);
        curl_easy_setopt(m_pCurl, CURLOPT_HTTPPOST, m_pFormpost);


        m_result.clear();
        auto res = curl_easy_perform(m_pCurl);
        if (res != CURLE_OK) {
            xerror2(TSF"curl easy perform error, url: %_, res: %_", m_requestUrl.c_str(), res);
            return res;
        }

        // 获取WriteCallBack中的结果信息来判断这次执行是否成功以及查询出错原因
        result = std::move(m_result);
        UpdateInfo();
        return 0;
    }
  • 外部调用核心参数
    // 上传文件部分调用核心代码
    HttpClientUrlArgs urlArgs;
    ...
    // Content-Type格式——上传文件
    urlArgs.headers["Content-Type"] = "multipart/form-data";

    // Content-Type格式——Post字符串
    urlArgs.headers["Content-Type"] = "text/plain"; // 一般是内存中字符串, 如日志上传
    urlArgs.headers["Content-Type"] = "application/json"; // 默认的json格式

    // Content-Type格式——Get操作
    urlArgs.headers["Content-Type"] = 可以不指定这个字段, 走默认"application/json";
    
    // 注意: Curl提供了客户线程退出标识检查机制(新版本废弃)
    int HttpClient::OnProgressCallback(double dt, double dn, double ult, double uln) {
        if (m_isExit != nullptr && m_isExit()) {
            return -1;
        }
        return 0;
    }
    
    // 如下设置回调isExit标识当前线程是否退出
    ...
    std::shared_ptr<HttpClient> httpClient = std::make_shared<HttpClient>(XXX::bind(&XXX::isExit, this));
    ...

CURL发送POST请求
我的博客
02-25 7055
发送 POST 请求的数据体，区别在于会自动将发送的数据进行 URL 编码。-I 向服务器发出 HEAD 请求，然会将服务器返回的 HTTP 标头打印出来。-L 让 HTTP 请求跟随服务器的重定向。-O 将服务器回应保存成文件，并将 URL 的最后部分当作文件名。用来限制 HTTP 请求和回应的带宽，模拟慢网速的环境。-i 打印出服务器回应的 HTTP 标头。-A 指定客户端的用户代理标头，即。-H 添加 HTTP 请求的标头。-x 指定 HTTP 请求的代理。-X 指定 HTTP 请求的方法。
curl实现文件上传、下载
wyw0000的博客
06-15 2320
curl实现文件上传、下载
文件上传及文件包含
最新发布
2401_88683072的博客
05-15 361
当程序员在写代码时，对于一些他们会经常使用到的代码或函数，他们就会将这段代码或函数写入一个文件，当要使用这段代码时，就会使用文件包含函数来调用这个文件，以PHP为例，常见的文件包含函数有 include()，require()，include_once()，require_once()既然这些包含函数会包含并运行指定文件，因此如果用户使用文件包含函数包含了一个恶意文件，如果这个文件的内容没有被检测而直接被包含函数包含，那么这个恶意文件就会被执行，这就是文件包含漏洞，文件包含漏洞又分本地文件和远程文件。
curl命令 – 文件传输工具
01101
02-25 1649
curl命令来自于英文词组”CommandLine URL“的缩写，其功能是用于在Shell终端界面中基于URL规则进行的文件传输工作。curl是一款综合的传输工具，可以上传也可以下载，支持HTTP、HTTPS、FTP等三十余种常见协议。-u 通过服务端配置的用户名和密码授权访问。-b 设置用户cookie信息。-s 静默模式，不输出任何信息。-I 打印HTTP响应头信息。-O 保留远程文件的原始名。-u 指定登录账户密码信息。-A 设置用户代理标头信息。-o 指定新的本地文件名。
CURL命令 : GET、POST请求、文件下载等常用命令
Guizy
08-14 3万+
curl命令, post, get, put, delete, 文件下载
CURL 发送POST请求
微赚淘客系统开发者博客
01-29 2万+
CURL是一个命令行工具和库，用于传输数据，支持众多协议，包括HTTP、HTTPS、FTP、FTPES等。它是开源且跨平台的，广泛应用于网络开发中。通过学习CURL发送POST请求的基本用法，我们可以在命令行中轻松地进行HTTP请求，方便地与各种API进行交互。
PHP CURL实现GET、POST请求
UFO00001的博客
07-05 1843
PHP 使用CURL实现GET和POST请求
PHP中使用CURL实现GET和POST请求的方法
徊忆羽菲
05-29 674
PHP中使用CURL实现GET和POST请求的方法PHP建立CURL请求的基本步骤CURL实现GET和POSTGET方式实现POST方式实现封装的一个函数 CURL 是一个利用URL语法规定来传输文件和数据的工具，支持很多协议，如HTTP、FTP、TELNET等。最爽的是，PHP也支持 CURL 库。使用PHP的CURL 库可以简单和有效地去抓网页。你只需要运行一个脚本，然后分析一下你所抓取的网页...
PHP中使用CURL实现GET和POST请求
苏公子的博客
01-08 362
CURL 是一个利用URL语法规定来传输文件和数据的工具，支持很多协议，如HTTP、FTP、TELNET等。 最爽的是，PHP也支持 CURL 库。 使用PHP的CURL 库可以简单和有效地去抓网页。你只需要运行一个脚本，然后分析一下你所抓取的网页，然后就可以以程序的方式得到你想要的数据了。 无论是你想从从一个链接上取部分数据，或是取一个XML文件并把其导入数据库，哪怕就是简单的获取网页内容...
php curl实现get请求,PHP中使用CURL实现GET和POST请求
weixin_35964787的博客
03-19 853
CURL 是一个利用URL语法规定来传输文件和数据的工具，支持很多协议，如HTTP、FTP、TELNET等。最爽的是，PHP也支持 CURL 库。使用PHP的CURL 库可以简单和有效地去抓网页。你只需要运行一个脚本，然后分析一下你所抓取的网页，然后就可以以程序的方式得到你想要的数据了。无论是你想从从一个链接上取部分数据，或是取一个XML文件并把其导入数据库，那怕就是简单的获取网页内容，CURL ...
php中获取get和post请求,PHP中使用CURL实现GET和POST请求
weixin_42298645的博客
04-08 535
CURL 是一个利用URL语法规定来传输文件和数据的工具，支持很多协议，如HTTP、FTP、TELNET等。最爽的是，PHP也支持 CURL 库。使用PHP的CURL 库可以简单和有效地去抓网页。你只需要运行一个脚本，然后分析一下你所抓取的网页，然后就可以以程序的方式得到你想要的数据了。无论是你想从从一个链接上取部分数据，或是取一个XML文件并把其导入数据库，那怕就是简单的获取网页内容，CURL ...
php curl处理get和post请求
diaoyu9204的博客
12-12 268
CURL 是一个利用URL语法规定来传输文件和数据的工具，支持很多协议，如HTTP、FTP、TELNET等。最爽的是，PHP也支持 CURL 库。使用PHP的CURL 库可以简单和有效地去抓网页。你只需要运行一个脚本，然后分析一下你所抓取的网页，然后就可以以程序的方式得到你想要的数据了。无论是你想从从一个链接上取部分数据，或是取一个XML文件并把其导入数据库，那怕就是简单的获取网页内...
使用 curl 发送 POST 请求的几种方式
JineD的博客
08-14 3万+
HTTP 的 POST 请求通常是用于提交数据，可以通过这篇文章来了解各种提交方式：四种常见的 POST 提交数据方式。做 Web 后端开发时，不可避免地要自己给自己发请求来调试接口，这里要记录的内容是如何使用命令行工具curl来进行各种方式的 POST 请求。 application/x-www-form-urlencoded 最常见的一种 POST 请求，用 curl 发起这种请求也很简单。 1 $ curl localhost:3000/api/basic..
curl_formadd()在http文件上传中的使用
格物致知的专栏 [音视频编解码 网络协议 计算机视觉 计算机图形学 图像理解 语音识别 机器学习 模拟电路 传感器]
11-10 1万+
本文转自https://curl.haxx.se/libcurl/c/curl_formadd.html   curl_formadd - add a section to a multipart/formdata HTTP POST NAME curl_formadd - add a section to a multipart/formdata HTTP POST SYNOPSI...
使用 curl 命令发送 POST 请求的几种方式
热门推荐
rui15111的博客
08-16 8万+
HTTP 的 POST 请求通常是用于提交数据，可以通过这篇文章来了解各种提交方式：四种常见的 POST 提交数据方式。做 Web 后端开发时，不可避免地要自己给自己发请求来调试接口，这里要记录的内容是如何使用命令行工具 curl 来进行各种方式的 POST 请求。 1、application/x-www-form-urlencoded 最常见的一种 POST 请求，用 curl 发起这种请求也很简单。 curl localhost:3000/api/basic -X POST -d 'hello=worl
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

ปรัชญา แค้วคำมูล

你的鼓励将是我创作的最大动力！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值