【小沐学C++】libcurl实现HTTP/HTTPS请求
文章目录
- 1、简介
- 2、下载和编译
-
- 2.1 下载
- 2.2 编译
- 2.3 使用
- 3、命令行测试
-
- 3.1 获取文件头Headers
- 3.2 请求内容Request Content
- 3.3 响应内容Response Content
- 3.4 GET请求
- 3.5 POST请求
- 3.6 其他
- 4、代码测试
-
- 3.1 simple.c
- 3.2 url2file.c
- 3.3 simplepost.c
- 3.4 resolve.c
- 3.5 progressfunc.c
- 3.6 http-post.c
- 3.7 https.c
- 3.8 httpcustomheader.c
- 3.9 getinfo.c
- 3.10 getredirect.c
- 3.11 getreferrer.c
- 3.12 执行HTTP的GET请求
- 3.13 执行HTTP的POST请求
- 3.14 获取HTTP报头提取Cookie信息
- 3.15 复杂示例
- 结语
1、简介
https://github.com/curl/curl
https://curl.se/libcurl/
https://curl.se/download.html
libcurl 是一个免费且易于使用的客户端 URL 传输 库，支持DICT，FILE，FTP，FTPS，GOPHER，GOPHERS，HTTP，HTTPS， IMAP， IMAPS， LDAP， LDAPS， MQTT， POPP3， POP3S， RTMP， RTMPS， RTSP， SCP， SFTP， SMB、SMBS、SMTP、SMTPS、TELNET 和 TFTP。libcurl 支持 SSL 证书，HTTP POST，HTTP PUT，FTP 上传，基于 HTTP 表单的上传， 代理、HTTP/2、HTTP/3、cookie、用户+密码身份验证（基本、 摘要，NTLM，协商，Kerberos），文件传输恢复，http代理 隧道等等！
libcurl 是高度可移植的，它可以在众多 平台，包括 Solaris、NetBSD、FreeBSD、OpenBSD、Darwin、HPUX、IRIX、 AIX， Tru64， Linux， UnixWare， HURD， Windows， Amiga， OS/2， BeOs， Mac OS X， Ultrix，QNX，OpenVMS，RISC OS，Novell NetWare，DOS等等…
2、下载和编译
2.1 下载
官网下载地址：
https://curl.se/download.html
- curl executable
您将从此链接获得预构建的“curl”二进制文件（或者在某些情况下，使用此链接带您访问的页面上提供的信息）。您可能会也可能不会将“libcurl”安装为共享库/ DLL。 - libcurl development
这是用于 libcurl 开发的 - 但并不总是包含 libcurl 本身。很可能是头文件和文档。如果你打算编译或构建使用 libcurl 的东西，这很可能是你想要的包。 - libcurl
这是一个纯二进制 libcurl 包，可能包括头文件和文档，但没有命令行工具和其他问题。如果你想让一个使用 libcurl 的程序使用 libcurl，这很可能是你想要的包。 - source code
-您不会从此链接下载预构建的二进制文件。相反，您将获得一个指向带有 curl 源的网站的链接，该链接已针对您的平台进行了调整。您需要设置编译器并努力工作才能从源包构建 curl。
最新源码如下图：
2.2 编译
解压源码压缩包如下：
找到windows代码工程文件，如下：
使用vs2017打开如下：
编译后生成文件如下：
2.3 使用
使用步骤：
- 调用curl_global_init()初始化libcurl
- 调用curl_easy_init()函数得到 easy interface型指针
- 调用curl_easy_setopt()设置传输选项
- 根据curl_easy_setopt()设置的传输选项，实现回调函数以完成用户特定任务
- 调用curl_easy_perform()函数完成传输任务
- 调用curl_easy_getinfo()接口获取网络请求响应信息，
- 调用curl_easy_cleanup()释放内存
- 调用curl_global_cleanup()析构libcurl
3、命令行测试
https://curl.se/docs/manual.html
3.1 获取文件头Headers
-H/--header LINE (H) # 添加请求头, 可添加多个 -H 参数,
# 参数格式: -H "NAME: VALUE"
-A/--user-agen STRING (H) # 请求头的 User-Agent 字段
-e/--referer URL (H) # 请求头的 Referer 字段
-r/--range RANGE (H) # 请求头的 Range 字段
-b/--cookie STRING/FILE (H) # 请求头的 Cookie 字段, 以字符串的形式提供,
# 或从指定 cookie 文件中读取
-c/--cookie-jar FILE (H) # 把响应头中的 cookie 保存到指定文件
-D/--dump-header FILE # 把 headers 信息保存指定文件
-I/--head # 只显示文档信息（只显示响应头）
3.2 请求内容Request Content
# 执行命令, 如果是 HTTP 则是请求方法, 如: GET, POST, PUT, DELETE 等
# 如果是 FTP 则是执行 FTP协议命令
-X/--request COMMAND
# HTTP POST 请求内容（并自动发出 POST 请求）, 例如: aa=bb&cc=dd
-d/--data DATA (H)
# HTTP multipart POST 表单数据,（并自动发出 POST 请求）
# 多个表单字段可添加多个 -H 参数, 如果是文件参数, 路径值前面需要加@
# 参考格式: -F "name1=@/filepath" -F "name2=stringvalue"
-F/--form CONTENT (H)
3.3 响应内容Response Content
-o/--output FILE FILE # 把响应内容输出到指定文件
-O/--remote-name # 以 URL 的文件名作为文件名称保存响应内容到当前目录
-C/--continue-at OFFSET # 断点续传, 从 offset 位置继续传输
3.4 GET请求
curl https://www.baidu.com/ # GET请求, 输出 响应内容
curl -I https://www.baidu.com/ # GET请求, 只输出 响应头
curl -i https://www.baidu.com/ # GET请求, 输出 响应头、响应内容
curl -v https://www.baidu.com/ # GET请求, 输出 通讯过程、头部信息、响应内容等
下载文件
# 指定保存的文件名称下载文件
curl https://www.baidu.com -o baidu.txt
# 使用 URL 指定的资源文件名保存下载文件（URL 必须指向具体的文件名）
curl https://www.baidu.com/index.html -O
# 指定 Usaer-Agent 和 Referer 请求头的值, 下载文件
curl -A "Mozilla/5.0 Chrome/70.0.3538.110 Safari/537.36" \
-e "https://www.baidu.com/" \
https://www.baidu.com/index.html -O
curl -o thatpage.html http://www.example.com/
curl -O http://www.example.com/index.html
curl -O www.haxx.se/index.html -O curl.se/download.html
# 指定Authorization请求头的值, 下载文件
# 参数格式: -H "NAME: VALUE"
curl -H "Authorization: a112121dada" \
https://www.baidu.com/index.html -O
3.5 POST请求
POST 提交 JSON 数据（\表示命令语句还未结束, 换行继续）
curl -H "Content-Type: application/json" \
-d '{"username":"hello", "password":"123456"}' \
http://localhost/login
# POST 提交 表单数据
curl -F "username=hello" \
-F "password=123456" \
-F "[email protected]" \
http://localhost/register
curl -d "name=Rafael%20Sagula&phone=3320780" http://www.where.com/guest.cgi
curl --data-urlencode "name=Rafael Sagula&phone=3320780" http://www.where.com/guest.cgi
curl -d "user=foobar&pass=12345&id=blablabla&ding=submit" http://www.formpost.com/getthis/post.cgi
curl -F "[email protected];type=image/gif,fil2.txt,fil3.html" http://www.post.com/postit.cgi
3.6 其他
-h/--help # 打印帮助信息
-V/--version # 显示版本信息
-s/--silent # 静默模式, 不输出任何内容
-i/--include # 输出包含 headers 信息
-v/--verbose # 输出详细内容
-#/--progress-bar # 以进度条方式显示传输过程
-y/--speed-time SECONDS # 连接 超时时间, 单位: 秒, 默认为 30
-m/--max-time SECONDS # 读取 超时时间, 必须在该时间内传输完数据, 单位: 秒
--limit-rate RATE # 限速传输, 单位: Byte/s
-x/--proxy [PROTOCOL://]HOST[:PORT] # 设置代理
-U/--proxy-user USER[:PASSWORD] # 代理的用户名和密码
-u/--user USER[:PASSWORD][;OPTIONS] # 设置服务器的用户密码和登录选项
--cacert FILE (SSL) # 使用指定的 CA 证书
-P/--ftp-port ADR (F) # 指定 FTP 传输的端口
-T/--upload-file FILE # 上传文件到指定的 URL (http/ftp) 位置,
# 参考格式: -T "file1" 或 -T "{file1,file2}"
-Q/--quote CMD (F/SFTP) # 执行命令, -X 只执行一条命令, -Q 可执行多条,
# 多条命令将按顺序执行,
# 参考格式: -Q "cmd1" -Q "cmd2"
4、代码测试
打开源码的文件夹的测试示例子文件夹如下：
3.1 simple.c
/*
* Download a given URL into a local file named page.out.
*
*/
#include 
3.2 url2file.c
#include "pch.h"
#include
* Download a given URL into a local file named page.out.
*
*/
#include \n" , argv[0]);
return 1;
}
curl_global_init(CURL_GLOBAL_ALL);
/* init the curl session */
curl_handle = curl_easy_init();
/* set URL to get here */
curl_easy_setopt(curl_handle, CURLOPT_URL, argv[1]);
/* Switch on full protocol/debug output while testing */
curl_easy_setopt(curl_handle, CURLOPT_VERBOSE, 1L);
/* disable progress meter, set to 0L to enable it */
curl_easy_setopt(curl_handle, CURLOPT_NOPROGRESS, 1L);
/* send all data to this function */
curl_easy_setopt(curl_handle, CURLOPT_WRITEFUNCTION, write_data);
/* open the file */
pagefile = fopen(pagefilename, "wb");
if (pagefile) {
/* write the page body to this file handle */
curl_easy_setopt(curl_handle, CURLOPT_WRITEDATA, pagefile);
/* get it! */
curl_easy_perform(curl_handle);
/* close the header file */
fclose(pagefile);
}
/* cleanup curl stuff */
curl_easy_cleanup(curl_handle);
curl_global_cleanup();
return 0;
}
编译如下：
运行如下：
下载图片如下：
3.3 simplepost.c
/*
* Very simple HTTP POST
*
*/
#include 3.4 resolve.c
/*
* Use CURLOPT_RESOLVE to feed custom IP addresses for given host name + port
* number combinations.
*
*/
#include 3.5 progressfunc.c
/*
* Use the progress callbacks, old and/or new one depending on available
* libcurl version.
*
*/
#include 3.6 http-post.c
/*
* simple HTTP POST using the easy interface
*
*/
#include 3.7 https.c
/*
* Simple HTTPS GET
*
*/
#include 3.8 httpcustomheader.c
/*
* HTTP request with custom modified, removed and added headers
*
*/
#include 3.9 getinfo.c
/*
* Use getinfo to get content-type after completed transfer.
*
*/
#include 
3.10 getredirect.c
/*
* Show how to extract Location: header and URL to redirect to.
*
*/
#include 3.11 getreferrer.c
/*
* Show how to extract referrer header.
*
*/
#include 3.12 执行HTTP的GET请求
#include 3.13 执行HTTP的POST请求
#include 3.14 获取HTTP报头提取Cookie信息
static size_t writeResponse(void *ptr, size_t size, size_t nmemb, void *userData)
{
std::string* pBuffer = (std::string*)userData;
size_t length = size * nmemb;
pBuffer->append((char*)ptr, length);
return length;
}
int getCookiesData()
{
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "http://127.0.0.1/login");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "cache-control: no-cache");
headers = curl_slist_append(headers, "Content-Type: application/x-www-form-urlencoded");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "username=slny001&password=Hx%40kj%2319&loginType=2&undefined=");
std::string strResponse;
curl_easy_setopt(hnd, CURLOPT_WRITEFUNCTION, Writeresponse);//设置回调函数 //curl_easy_setopt(pCurlHandle, CURLOPT_HEADER, 1);//保存HTTP头部信息到strResponseData
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, &strResponse);//设置回调函数的参数,获取反馈信息
curl_easy_setopt(hnd, CURLOPT_HEADERFUNCTION, Writeresponse);//设置回调函数：输出response headers
string responseHeadBuffer;
curl_easy_setopt(hnd, CURLOPT_HEADERDATA, &responseHeadBuffer);//设置回调函数参数
CURLcode ret = curl_easy_perform(hnd);
if (0 == ret)
{
int nPosOfCookie = responseHeadBuffer.find("Cookie: ", 0);
if (nPosOfCookie > 0)
{
int nPosOfEndCookie = responseHeadBuffer.find(";", nPosOfCookie);
m_cookie = responseHeadBuffer.substr(nPosOfCookie + 7, nPosOfEndCookie - nPosOfCookie - 7);
}
}
curl_slist_free_all(headers);
curl_easy_cleanup(hnd);
return 0;
}
3.15 复杂示例
#define CURL_STATICLIB //如果是静态库方式，需要包含这句
#include "curl\curl.h"
#include
#include 结语
如果您觉得该方法或代码有一点点用处，可以给作者点个赞，或打赏杯咖啡；╮(￣▽￣)╭
如果您感觉方法或代码不咋地//(ㄒoㄒ)//，就在评论处留言，作者继续改进；o_O???
如果您需要相关功能的代码定制化开发，可以留言私信作者；(✿◡‿◡)
感谢各位大佬童鞋们的支持！( ´ ▽´ )ﾉ ( ´ ▽´)っ！！！