Libcurl 安装及使用(C++)

libcurl是一个跨平台的网络协议库,支持http,https,ftp,gopher,telnet,dict,file和ldap协议.libcurl同样支持HTTPS证书授权,HTTP POST,HTTP PUT,FTP上传,HTTP基本表单上传,代理和用户认证。

本文主要记录的是使用libcurl编写嵌入式平台调用开发平台提供restful API所需的posts get这两个接口。
(180920)后续未验证的code是后续使用遇到的,从可用code截取出来,但并没有在文中sample code编译过,所以未验证只是示意。前面的code是亲自编过了的。

具体代码可直接看第三节,详细的libcurl知识可参考第四节参考链接。

文章目录

  • 1 安装
    • 1.1 环境
    • 1.2 安装
  • 2 使用
    • 2.1 一些基础的函数
    • 2.2 curl_easy_setopt()常用的参数
    • 2.3 编程模型
  • 3 代码
  • 4 参考链接

1 安装

1.1 环境

libcurl版本:7.58.0
openssl版本:1.0.2g
安装环境:Linux x64

libcurl和openssl版本很重要,有一个匹配关系。

1.2 安装

./configure --prefix=/home/jw.li/work/face/libcurl/curl --with-ssl=/home/jw.li/code/save/ssl
Make  
Make intall

最后在安装目录下的到lib 和include

2 使用

2.1 一些基础的函数

curl_global_init()               //初始化libcurl
curl = curl_easy_init();    //得到curl的指针  
curl_easy_setopt()           //设置http参数 重要
curl_easy_perform(curl); //执行http请求
curl_easy_cleanup(curl); //回收curl指针

2.2 curl_easy_setopt()常用的参数

CURLOPT_URL            http访问的url
CURLOPT_WRITEFUNCTION  回调函数原型为:size_t function( void *ptr, size_t size, size_t nmemb, void *stream)
CURLOPT_WRITEDATA      用于表明CURLOPT_WRITEFUNCTION函数中的stream指针的来源
CURLOPT_COOKIE         字符串类型,设置http头中的cookie信息。
CURLOPT_POSTFIELDS     字符串类型,提交http的post操作字符串数据。
CURLOPT_HTTPHEADER     选项自定义请求头信息
CURLOPT_POSTFIELDSIZE  指定post长度

2.3 编程模型

 curl = curl_easy_init(); 初始化
 curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());     设置相应http参数
 curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)response); 设置响应内容写入buffer
 ret = curl_easy_perform(curl);                          //执行请求 得到结果
 long response_code = 0;
 curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &response_code);//获取http 状态码
  

3 代码

#include 
#include 
#include 
#include 

using namespace std;

//回调函数  得到响应内容
int write_data(char* buffer, size_t size, size_t nmemb, void* userp){
    std::string * str = dynamic_cast((std::string *)userp);
    str->append((char *)buffer, size * nmemb);
    return nmemb;
}

int posts(string url, string &body,  string* response);
int get(string url, string* response);



int main(int argc, char** argv){
	std::map data;
	std::string body;

	std::string response;
    int status_code = get("http://www.baidu.com", &response);
	if (status_code != CURLcode::CURLE_OK) {
			return -1;
	}
	cout << response << endl;
	cout << "*********************************"  << endl;

    status_code = posts("https://www.zhihu.com", body, &response);
	if (status_code != CURLcode::CURLE_OK) {
			return -1;
	}
	cout << response << endl;

	return 0;
}

int get(string url, string* response)
{
    CURL *curl;
    CURLcode ret;
    struct curl_slist *headers = NULL;
    headers = curl_slist_append(headers, "Accept: Agent-007");
    curl = curl_easy_init();    // 初始化
    
    if (curl)
    {
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);        //改协议头
        curl_easy_setopt(curl, CURLOPT_URL, (char *)url.c_str());   // 指定url
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)response);
        int status_code = curl_easy_perform(curl);   // 执行


         ret = curl_easy_perform(curl);                          //执行请求
        if(ret == 0){
            curl_slist_free_all(headers);
            curl_easy_cleanup(curl);    
            return status_code;
        }
        else{
            return ret;
        }
    }
    else{
        return -1;
    }
}
//POST 处理x-www-form-urlencoded格式数据 如下
//{id: 'SEA2HHHH',
//  time: '2018-12-27T21:43:41.604Z',
//  image: 'haha' }
//则    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());           //指定post内容中
//body内容为:
//id=SEA2HHHH&image='haha&time=2019-01-02+14:22:41

int posts(string url, string &body,  string* response)
{
    CURL *curl;
    CURLcode ret;
    curl = curl_easy_init();
    long response_code = 0;
    if (curl)
    {
         curl_easy_setopt(curl, CURLOPT_POSTFIELDS, body.c_str());           //指定post内容
        curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, body.size());         //指定post长度
        curl_easy_setopt(curl, CURLOPT_HEADER, 0);                          //设置协议头
        // curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);             
        curl_easy_setopt(curl, CURLOPT_URL, (char *)url.c_str());           //指定url
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);          //绑定相应
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)response);        //绑定响应内容的地址
        ret = curl_easy_perform(curl);                          //执行请求
        if(ret == 0){
            curl_easy_cleanup(curl);   
            curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &response_code);//获取http 状态码 
            return 0;  
        }
        else{
			curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &response_code);//获取http 状态码
            return ret;
        }
    }
	else{
        return -1;
	}
}



//***************put for c(180727) 下列code未验证***************//
//put 函数用于上传数据
size_t read_data(char* buffer, size_t size, size_t nitems, void* instream){
    size_t sizes = fread(buffer, size, nitems, (FILE *)instream); 
    return nitems;
}
//put 文件, 即 raw bin 类型数据在node中接受需要使用 res.on('data')方式,在json编码数据可以使用req.body
int put(char* url, FILE* fd,  int fsize, char* response)//put 地址,put 文件句柄, 文件大小, 接受响应存储位置
{
    CURL *curl;
    CURLcode ret;
    curl = curl_easy_init();
    struct curl_slist *headers = NULL;
    headers = curl_slist_append(headers, "expect: "); //将值置为空,可以屏蔽该头
    //headers = curl_slist_append(headers, "content-length: ");//put 不能省略这个头content-length
    headers = curl_slist_append(headers, "test: put");//设置put http header头
    // printf("\n%s %d\n", body, fsize);
    if (curl)
    { 
        curl_easy_setopt(curl,CURLOPT_URL, url);//配置url
        curl_easy_setopt(curl,CURLOPT_UPLOAD, 1);//设置为上传模式 PUT
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);//改协议头
        curl_easy_setopt(curl, CURLOPT_READFUNCTION, &read_data);//配置上传内容函数处理
        curl_easy_setopt(curl, CURLOPT_READDATA, fd);//向处理函数传递 文件指针
        curl_easy_setopt(curl, CURLOPT_INFILE, fd); //定位作为上传的输入文件 
        curl_easy_setopt(curl, CURLOPT_INFILESIZE, fsize);//上传文件字节数
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);//用于接受响应回调函数
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)response);//传递接受响应内容的存储地址
        ret = curl_easy_perform(curl);                          //执行请求
        if(ret == 0){
            curl_easy_cleanup(curl);    
            return 0;  
        }
        else{
            return ret;
        }
    }
	else{
        return -1;
	}
}

//***************post(180920) 下列code未验证 普通post ****************//
int post(string url, string &body,  string* response)
{
    CURL *curl;
    curl = curl_easy_init();

    if (curl)
    {
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, (char *)body.c_str());    // 指定post内容
        curl_easy_setopt(curl, CURLOPT_URL, (char *)url.c_str());   // 指定url
        curl_easy_perform(curl);
        curl_easy_cleanup(curl);
    }
	else{
		// cout << "error" << endl;
	}

    return 0;
}

//***************(180920) 下列code未验证 post body请求参数构造****************//
void makeUrlencodedForm(map const & params, string * content)
{
	content->clear();
	map::const_iterator it;
	for(it=params.begin(); it!=params.end(); it++)
	{
		char * key = curl_escape(it->first.c_str(), (int) it->first.size());
		char * value = curl_escape(it->second.c_str(),(int) it->second.size());
		*content += key;
		*content += '=';
		*content += value;
		*content += '&';
		curl_free(key);
		curl_free(value);
	}
}
//***************post中 boy参数得到sample****************//
    //string body;
  	// map data;
    // data["file"] = "file bin";
    // data["group_id"] = "deviceinfo";
	// makeUrlencodedForm(data, &body);
//************************************************************//

编译:

g++ -I../libcurl/include  -std=c++11  ./test_main.cpp   -L../libcurl/lib -lcurl -lssl -lcrypto  -O2 -ldl  -o sample_X86_64

4 参考链接

https://www.cnblogs.com/moodlxs/archive/2012/10/15/2724318.html
https://www.cnblogs.com/lidabo/p/4583061.html

你可能感兴趣的:(C/C++,网络,linux)