libcurl库

1.libcurl简介

libcurl是一个跨平台的网络协议库，支持http、https，ftp，telnet等应用层协议。libcurl同样支持HTTPS证书授权，HTTP POST，HTTP PUT,FTP上传，HTTP基本表单上传，大力cookies和用户认证。

2.libcurl的使用

调用curl_global_init()//初始化libcurl
调用curl_easy_init()得到easy interface型指针（返回一个可以操作的句柄）
调用curl_easy_setop()设置传输选项

根据curl_easy_setop()设置的传输选项，实现回调函数以完成用户特定任务
根据curl_easy_perform()完成传输任务
curl_easy_cleanup()释放内存

3.libcurl的安装

下载地址：https://github.com/curl/curl/releases/tag/curl-7_71_1

下载好以后，发送到虚拟机

Libcurl库等第三方库的通用编译方法

（1）解压下载好的库
tar xvf curl-7.71.1.tar.bz2
（2）进入解压后的文件夹
cd curl-7.71.1/
（3）先看 README，docs 文件夹里的 curl.1 和INSTALL文件
（4）回到/curl-7.71.1目录下，configure --help看看
./configure --help
指定安装目录
指定编译工具

（5）配置：

./configure --prefix=$PWD/_install

配置为：$ 获取当前路径,编译的时候会自动生成_install文件夹，并且把编译生成的东西全部放入这个文件夹。
(6)编译

make

（7）安装

sudo make install

这就是编译后产生的库

这是开发所用到的头文件

（8）修改配置文件

cd curl-7.71.1/_install/lib/
pwd显示当前路径
拷贝路径
把此路径加入到/home/ygl/.bashrc文件中
vi /home/ygl/.bashrc
最后一行加入export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/home/ygl/orangepi/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu/bin:/home/ygl/Desktop/curl-7.71.1/_install/lib
保存退出
source /home/ygl/.bashrc

3.调用libcurl访问百度主页

demo1.c

#include 
#include 
 
typedef unsigned int bool;//数据类型别名用typedef  有分号
#define true 1            //宏定义（替换）用define         无冒号
#define false 0
 
bool getUrl(char *filename)//GET请求
{
        CURL *curl;
        CURLcode res;
        FILE *fp;
        if ((fp = fopen(filename, "w")) == NULL)  // 返回结果用文件存储
                return false;
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Accept: Agent-007");
        curl = curl_easy_init();    // 初始化
        if (curl)
        {
                //curl_easy_setopt(curl, CURLOPT_PROXY, "10.99.60.201:8080");// 代理
                curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);// 改协议头
                curl_easy_setopt(curl, CURLOPT_URL,"http://www.baidu.com");
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp); //将返回的http头输出到fp>指向的文件,
                //即为filename文件，而主函数传入的参数是 /tmp/get.html，即为真正保存在get.html文件中
                
                curl_easy_setopt(curl, CURLOPT_HEADERDATA, fp); //将返回的html主体数据输出到fp指向的文件
                res = curl_easy_perform(curl);   // 执行
                if (res != 0) {
 
                        curl_slist_free_all(headers);  //释放句柄
                        curl_easy_cleanup(curl);
                }
                fclose(fp);
                return true;
        }
}
bool postUrl(char *filename)//POST请求
{
        CURL *curl;
        CURLcode res;
        FILE *fp;
        if ((fp = fopen(filename, "w")) == NULL)
                return false;
        curl = curl_easy_init();
        if (curl)
        {
                curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "/tmp/cookie.txt"); // 指定cookie文件
                curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "&logintype=uid&u=xieyan&psw=xxx86");    // 指定post内容：用户信息 字段之间&连接，尝试登陆新浪邮箱
                //curl_easy_setopt(curl, CURLOPT_PROXY, "10.99.60.201:8080");
                curl_easy_setopt(curl, CURLOPT_URL, " http://mail.sina.com.cn/cgi-bin/login.cgi ");   // 指定url
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
                res = curl_easy_perform(curl);//执行
                curl_easy_cleanup(curl);
        }
        fclose(fp);
        return true;
}
int main(void)
{
        getUrl("/tmp/get.html");
        postUrl("/tmp/post.html");
}
 

在C语言里面并没有Bool类型，在C++里面有，为了实现此类型可以用下列方式。

typedef unsigned int bool;//数据类型别名用typedef  有分号
#define true 1            //宏定义（替换）用define         无冒号
#define false 0

编译

gcc demo1.c -I ./curl-7.71.1/_install/include/ -L ./curl-7.71.1/_install/lib/ -lcurl -o test

运行 ./test
打开 /tmp/get.html

打开/tmp/post.html 里面内容为空 因为账号密码错误

4.libcurl 相关API解读

1.curl_global_init()

CURLcode curl_global_init(long flags);

该函数只能调用一次，（其实在调用curl_global_cleanup函数后还可以使用）
如果该函数在调用curl_easy_init时还没有被调用，它将由libcurl库自动调用，所以多线程下最好主动调用curl_global_init,防止在线程中curl_easy_init多次调用。
注意：虽然curl线程是安全的，但是curl_global_init是不能保证安全性的，所以不要在每个线程上都调用curl_global_init,最好把它放在主线程上。
参数：flags
CURL_GLOBAL_ALL //初始化所有的可能的调用。
CURL_GLOBAL_SSL //初始化支持 安全套接字层。
CURL_GLOBAL_WIN32 //初始化win32套接字库。
CURL_GLOBAL_NOTHING //没有额外的初始化。
一般用第一个就可以

2.curl_global_cleanup(void)

void curl_global_cleanup(void)

结束libcurl使用时，用来对curl_global_init的工作进行清理，类似于close操作。
curl_global_cleanup也要放在主线程上。

3.char *curl_version()

打印当前libcurl的版本

4. CURL *curl_easy_init( )

CURL *curl_easy_init( );

该函数用来初始化一个CURL的指针，类似于FILE类型的指针。相应在调用结束时要用curl_easy_cleanup函数去清理。
一般curl_easy_init()意味着一个会话的开始，会返回一个easy_handle(CURL对象),一般用在easy系列的函数中。返回的CURL的指针是一个操作句柄，类似于文件描述符。

5.curl_easy_cleanup()

void curl_easy_cleanup(CURL *handle)

该函数用来结束一个会话，与curl_easy_init配合起来使用。
参数：CURL类型的指针

6.curl_easy_setopt()

CURLcode curl_easy_setopt(CURL *handle,CURLoption option,parameter)

这个函数最为重要，几乎所有的curl程序都要去调用该函数并且频繁的去使用。他告诉curl有如何的行为，比如查看一个网页的html代码等（这个函数有些像ioctl函数）参数：
1.CURL类型的指针
2.各种CURLoption类型的选项。（都在curl.h中，用man 可以查看）
3.parameter，这个参数既可以是函数的指针又可以是某个对象的指针，也可以是个long型的变量，它用什么取决于CLURLoption是什么。
2.1CURLoption常用到的宏
（1）CURLOPT_URL设置访问的网站
（2）CURLOPT_POSTFIELDS
在post请求中：以 & 拼接字符串的形式把参数链接起来，翔云人工智能平台OCRkey和密码就要放在这里传输。

curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "&logintype=uid&u=xieyan&psw=xxx86");    // 指定post内容：用户信息，尝试登陆新浪邮箱

(3)CURLOPT_WRITEFUNCTION，CURLOPT_WRITEDATA
CURLOPT_WRITEFUNCTION:调用回调函数，网页有数据时让回调函数处理，回调函数原型：

 size_t function( void *ptr, size_t size,size_t nmemb, void *stream)

int BufferWriterFunc(char* data,size_t size,size_t nmemb,char *buffer)
{
	strcpy(bufferData,data);//把返回的data数据放在本地的bufferData数组中
	return size*nmemb;
}
 
//配置如下：
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION,BufferWriterFunc);

对上述访问百度代码进行修改，让他把返回的结果用回调函数处理，并打印返回结果。

void readData( void *ptr, size_t size,size_t nmemb, void *stream){
        char buf[10240]={'\0'};
        strncpy(buf,ptr,sizeof(buf));
        printf("===========get============\n");
        printf("%s\n",buf);
}
bool getUrl(char *filename)//GET请求
{
        CURL *curl;
        CURLcode res;
        FILE *fp;
        if ((fp = fopen(filename, "w")) == NULL)  // 返回结果用文件存储
                return false;
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Accept: Agent-007");
        curl = curl_easy_init();    // 初始化
        if (curl)
        {
                //curl_easy_setopt(curl, CURLOPT_PROXY, "10.99.60.201:8080");// 代理
                curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);// 改协议头
                curl_easy_setopt(curl, CURLOPT_URL,"http://www.baidu.com");
                curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, readData); //将返回的数据用回调函数readData去处理,
                //curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp); //将返回的http头输出到fp>指向的文件,
                //即为filename文件，而主函数传入的参数是 /tmp/get.html，即为真正保存在get.html文件中

                //curl_easy_setopt(curl, CURLOPT_HEADERDATA, fp); //将返回的html主体数据输出到fp指向的文件
                res = curl_easy_perform(curl);   // 执行
                if (res != 0) {

                        curl_slist_free_all(headers);  //释放句柄
                        curl_easy_cleanup(curl);
                }
                fclose(fp);
                return true;
        }
}

	CURLOPT_WRITEDATA：把返回的网页数据传递给已经打开的文件指针

FILE *fp;
if ((fp = fopen(filename, "w")) == NULL)//提前打开了一个文件流
        return false;
 
curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);//请求回来的所有数据都放到文件中

6.curl_easy_perform()

CURLcode curl_easy_perform(CURL *handle);

该函数时完成curl_easy_setopt()的所有操作，返回0表示一切ok否则代表发生错误。