VS2019利用Curl库实现HTTP网络通信（C++）

        C++实现HTTP网络通信，一般采用两种方式，熟悉TCP协议的大哥可能不需要查这方面的知识；还有一种方式就是使用第三方库，Qt环境下可以用QNetworkRequest实现很方便，再就是Curl了，Curl是个独立的第三方库，不依赖于qt环境，可以实现GET和POST方式通信。

​         先说环境，VS2019；

一、Curl环境搭建

​         调用Curl的静态库/动态库是需要自己编译的；

1.1 文件下载

​         打开下载地址（curl - Download）下载对应版本的curl压缩包，本文下载7.65.0版本（也尝试了新版的7.8.0，但下一步编译未成功）；

1.2 编译

​         下载好的文件解压缩到指定文件夹，然后双击运行【../curl-7.65.0/buildconf.bat】，一闪而过就结束了;

        ​ 在开始菜单的VS中找到【x64 Native Tools Command Prompt for VS 2019】，点击打开；

        进入到【../curl-7.65.0/winbuild】目录下，执行【nmake /f Makefile.vc mode=static VC=15 MACHINE=x64 DEBUG=no】；

        ​ 参数含义：

nmake /f Makefile.vc mode=static 		// 静态编译，也可mode=dll
						VC=15 		  // vc版本
						MACHINE=x64    // 64或32位
						DEBUG=no       // 改成yes就是Debug

         等待两三分钟，编译完成进入【../curl-7.65.0/builds】可见以下文件，第一个就是我们需要的，至此编译完成；

1.3 Curl开发环境配置

        新建一个测试工程，由于名字太长，将1.2步骤编译生成的文件夹重命名为【curl】，内含如下文件夹；

         右键工程属性，在VC++选项卡内，分别设置包含目录【../curl/include】库目录【../curl/lib】;

         C/C++选项卡，预处理器添加【CURL_STATICLIB】；

 链接器/输入选项卡，附加依赖项添加

libcurl_a.lib
Ws2_32.lib
Wldap32.lib
winmm.lib
Crypt32.lib
Normaliz.lib

         至此环境搭建完成，后续就可以在项目中正常使用了。

二、利用Curl库实现HTTP网络通信

2.1 测试

        ​ 测试代码如下：

#include <curl/curl.h>    

void testCurlFunc() {
	CURL* curl = 0;
	CURLcode res;
	curl = curl_easy_init();
	if (curl != 0) {
		// 设置url
		curl_easy_setopt(curl, CURLOPT_URL, "https://www.baidu.com");
		//www.baidu.com 可能会跳转，所以设置为跟随跳转
		curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
		// 发出请求
		res = curl_easy_perform(curl);
		// 返回状态检查
		if (res != CURLE_OK) {
			fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
		}
		// 任务完成，清理工作
		curl_easy_cleanup(curl);
	}
}

        打印信息如下所示，表明成功：

2.2 关于打印信息乱码

        ​ 可以看到其中中文是乱码，这是由于返回的响应数据是utf编码方式，而debug或cout打印是GBK，可以在cout前面加一句【SetConsoleOutputCP(CP_UTF8);】，将打印编码设置为utf8就不乱码了，效果如下；

三、使用CURL发送GET请求

​         代码如下：

#include<curl\curl.h>
using namespace std;

//get请求和post请求数据响应函数
size_t req_reply(void *ptr, size_t size, size_t nmemb, void *stream)
{
	//在注释的里面可以打印请求流，cookie的信息
	//cout << "----->reply" << endl;
	string *str = (string*)stream;
	//cout << *str << endl;
	(*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 = curl_easy_init();
	// curl返回值 
	CURLcode res;
	if (curl)
	{
		//设置curl的请求头,表头类型可能不同
		struct curl_slist* header_list = NULL;
		header_list = curl_slist_append(header_list, "Content-Type:application/json");
		curl_easy_setopt(curl, CURLOPT_HTTPHEADER, header_list);

		//不接收响应头数据0代表不接收 1代表接收
		curl_easy_setopt(curl, CURLOPT_HEADER, 0);

		//设置请求的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);

		//CURLOPT_VERBOSE的值为1时，会显示详细的调试信息
		curl_easy_setopt(curl, CURLOPT_VERBOSE, 0);

		curl_easy_setopt(curl, CURLOPT_READFUNCTION, NULL);

		//设置数据接收函数
		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_CONNECTTIMEOUT, 6); // set transport and time out time  
		curl_easy_setopt(curl, CURLOPT_TIMEOUT, 6);

		// 开启请求  
		res = curl_easy_perform(curl);
	}
	// 释放curl 
	curl_easy_cleanup(curl);
	return res;
}

int test_curl_get_req()
{
	string getUrlStr = "https://www.baidu.com/";
	string getResponseStr;
	auto res = curl_get_req(getUrlStr, getResponseStr);
	if (res == CURLE_OK)
	{
		cout << getResponseStr << endl;
	}
	getchar();
	return 0;
}

        打印信息如下：

四、使用CURL发送POST请求传递JSON数据

​         代码如下：

#include<iostream>
#include<string>
#include<curl\curl.h>
using namespace std;

//get请求和post请求数据响应函数
size_t req_reply(void *ptr, size_t size, size_t nmemb, void *stream)
{
	//在注释的里面可以打印请求流，cookie的信息
	//cout << "----->reply" << endl;
	string *str = (string*)stream;
	//cout << *str << endl;
	(*str).append((char*)ptr, size*nmemb);
	return size * nmemb;
}

//http POST请求  
CURLcode curl_post_req(const string &url, const string &postParams, string &response)
{
	// curl初始化  
	CURL *curl = curl_easy_init();
	// curl返回值 
	CURLcode res;
	if (curl)
	{
		// set params
		//设置curl的请求头
		struct curl_slist* header_list = NULL;
		header_list = curl_slist_append(header_list, "User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko");
		header_list = curl_slist_append(header_list, "Content-Type:application/json; charset=UTF-8");
		curl_easy_setopt(curl, CURLOPT_HTTPHEADER, header_list);

		//不接收响应头数据0代表不接收 1代表接收
		curl_easy_setopt(curl, CURLOPT_HEADER, 0);

		//设置请求为post请求
		curl_easy_setopt(curl, CURLOPT_POST, 1);

		//设置请求的URL地址
		curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
		//设置post请求的参数
		curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postParams.c_str());

		//设置ssl验证
		curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);
		curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);

		//CURLOPT_VERBOSE的值为1时，会显示详细的调试信息
		curl_easy_setopt(curl, CURLOPT_VERBOSE, 0);

		curl_easy_setopt(curl, CURLOPT_READFUNCTION, NULL);

		//设置数据接收和写入函数
		curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, req_reply);
		curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)&response);

		curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);

		//设置超时时间(单位：s)
		curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 10);
		curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10);

		// 开启post请求
		res = curl_easy_perform(curl);
	}
	//释放curl 
	curl_easy_cleanup(curl);
	return res;
}

void test_curl_post_req()
{
	string url_post = "http://httpbin.org/post";	//设置URL

	Json::FastWriter writerinfo;
	Json::Value  writevalueinfo;
    writevalueinfo["username"] = "000001";
    writevalueinfo["password"] = "123456";
    string paramsLogin = writerinfo.write(writevalueinfo);	//设置post的json数据
	
	string resPost;	//返回值
	
	auto res3 = curl_post_req(url_post, paramsLogin, resPost);
	if (res3 == CURLE_OK)
	{
		cout << resPost << endl;
	}
}

        打印结果如下：

五、其他

5.1 传递参数包含中文情况

        ​ 一般地，本地端采用GBK编码方式，服务器端采用utf-8方式编码；当GET url参数含有中文字符时，除了设置utf8编码外，还需要对其额外进行特殊处理；

 string input; // 此处的input必须是utf-8编码格式
 // 对请求参数中的中文和特殊字符（如空格等）进行处理，方可使用
 char * escape_control = curl_escape(input.c_str(), input.size());
 input = escape_control;
 curl_free(escape_control);
 // 接下来就可以把input传入url了；

5.2 关于时间戳

​         网络通信传输数据多见有时间戳属性，一并整理：

// 日期转时间戳函数
time_t convert_str_to_tm(const char * str_time)
{
	struct tm tt;
	memset(&tt, 0, sizeof(tt));
	tt.tm_year = atoi(str_time) - 1900;
	tt.tm_mon = atoi(str_time + 5) - 1;
	tt.tm_mday = atoi(str_time + 8);
	tt.tm_hour = atoi(str_time + 11);
	tt.tm_min = atoi(str_time + 14);
	tt.tm_sec = atoi(str_time + 17);
	return mktime(&tt);
}

// 测试：日期转时间戳,再转为字符串
string date = "2023-02-07 09:56:40";
time_t timeStamp = convert_str_to_tm(date.c_str());
std::string strTimeStamp = "";
stringstream ss;
ss << timeStamp;
strTimeStamp = ss.str();
cout << "Time Stamp:" << timeStamp<<"\t"<< strTimeStamp << endl;

六、参考链接

Visual Studio(VS2017/VS2019)编译并配置C/C++-libcurl开发环境

Visual Stdio2019下配置Libcurl的详细教程

Curl（C++）使用教程

C++使用curl发送get请求

C++使用curl发送post请求

C++使用CURL库POST请求向服务器发送JSON数据

C++ MFC 时间戳与日期格式相互转换

CTime 转 时间戳