libcurl库及curl API的简介

目录

一、libcurl简介

二、curl API简介

三.库安装编译方法

内容来源：Http协议之libcurl实现 - 谢呈勖 - 博客园 (cnblogs.com)

一、libcurl简介

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

libcurl的官网 http://curl.haxx.se/ 

libcurl库下载Release 7.71.1 · curl/curl · GitHub

二、curl API简介

调用curl_global_init()初始化libcurl

调用curl_easy_init()函数得到 easy interface型指针

调用curl_easy_setopt()设置传输选项

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

1.CURLcode curl_global_init(long flags);函数只能用一次。(其实在调用curl_global_cleanup 函数后仍然可再用)

如果这个函数在curl_easy_init函数调用时还没调用，它讲由libcurl库自动调用，所以多线程下最好主动调用该函数以防止在线程中curl_easy_init时多次调用。

注意：虽然libcurl是线程安全的，但curl_global_init是不能保证线程安全的，所以不要在每个线程中都调用curl_global_init，应该将该函数的调用放在主线程中。
参数：flags

#include <curl/curl.h> 
CURLcode  curl_global_init(long flags)
参数：
CURL_GLOBAL_ALL                      //初始化所有的可能的调用。
CURL_GLOBAL_SSL                      //初始化支持 安全套接字层。
CURL_GLOBAL_WIN32            //初始化win32套接字库。
CURL_GLOBAL_NOTHING         //没有额外的初始化。
返回值：CURLcode变量：curl的状态

结束libcurl使用的时候，用来对curl_global_init做的工作清理。类似于close的函数。

注意：虽然libcurl是线程安全的，但curl_global_cleanup是不能保证线程安全的，所以不要在每个线程中都调用curl_global_init，应该将该函数的调用放在主线程中。

void curl_global_cleanup(void);

打印当前libcurl库的版本。 

char *curl_version();
返回值：版本字符串

curl_easy_init用来初始化一个CURL的指针(有些像返回FILE类型的指针一样). 相应的在调用结束时要用curl_easy_cleanup函数清理。
一般curl_easy_init意味着一个会话的开始. 它会返回一个easy_handle(CURL*对象)，一般都用在easy系列的函数中.。

CURL *curl_easy_init();
返回值：CURL的指针(easy_handle：句柄)

这个调用用来结束一个会话，与curl_easy_init配合着用. 
参数：CURL类型的指针 

void curl_easy_cleanup(CURL *handle)

这个函数最重要了，几乎所有的curl 程序都要频繁的使用它，它告诉curl库.程序将有如何的行为. 比如要查看一个网页的html代码等.(这个函数有些像ioctl函数)参数。 

CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);
参数：
    参数1：CURL *handle ：句柄。
    参数2：CURL option：选项。.(都在curl.h库里有定义,man 也可以查看到)
    参数3：value，函数指针，对象指针或curl_off_t。

1.CURLOPT_URL:设置访问URL(获取/放置的完整URL).
  2.CURLOPT_WRITEFUNCTION、CURLOPT_WRITEDATA
    CURLOPT_WRITEFUNCTION:设定一个回调函数，执行libcurl在接受到数据后用户想进行的操作，通常函数多做数据保存的功能，如处理下载文件。
    CURLOPT_WRITEDATA:用于表明CURLOPT_WRITEFUNCTION中的stream指针的来源，即：设定回调函数的第四个参数的数据类型。【若不写该函数则标准输出到屏幕上，若单使用该函数则使用默认回调函数将接受到数据简单标准输出】
    回调函数原型为：size_t function( void *ptr, size_t size, size_t nmemb, void *stream)【以fwrite()函数语法为准】
  3.CURLOPT_HEADERFUNCTION
    CURLOPT_HEADERFUNCTION:设定一个回调函数，执行libcurl在接受到http头数据后用户想进行的操作。
    CURLOPT_WRITEDATA:用于表明CURLOPT_WRITEFUNCTION中的stream指针的来源，即：设定回调函数的第四个参数的数据类型。【若不写该函数则标准输出到屏幕上，若单使用该函数则使用默认回调函数将接受到数据简单标准输出】
    回调函数原型为：size_t function( void *ptr, size_t size, size_t nmemb, void *stream)【以fwrite()函数语法为准】
  4.CURLOPT_HEADERDATA
    发送FILE *或void *存储头，如果你使用回调，它只是简单地传递回调未修改。
    会直接输出到屏幕上。
  5.CURLOPT_READFUNCTION、 CURLOPT_READDATA
    CURLOPT_READFUNCTION设定一个回调函数，读取数据传递给远程主机时将调用CURLOPT_READFUNCTION指定的函数，函数原型是：size_t function(void *ptr, size_t size, size_t nmemb,void *stream) 【以fread()函数语法为准】
     CURLOPT_READDATA表明CURLOPT_READFUNCTION函数原型中的stream指针来源，即：设定回调函数的第四个参数的数据类型。
  6.CURLOPT_NOPROGRESS、CURLOPT_PROGRESSFUNCTION、CURLOPT_PROGRESSDATA
    跟数据传输进度相关的参数。CURLOPT_PROGRESSFUNCTION指定的函数正常情况下每秒被libcurl调用一次，为了使CURLOPT_PROGRESSFUNCTION被调用，CURLOPT_NOPROGRESS必须被设置为false，CURLOPT_PROGRESSDATA指定的参数将作为 CURLOPT_PROGRESSFUNCTION指定函数的第一个参数
  7.CURLOPT_TIMEOUT、CURLOPT_CONNECTIONTIMEOUT
    CURLOPT_TIMEOUT用于设置传输时间.
    CURLOPT_CONNECTIONTIMEOUT设置连接等待时间
  8.CURLOPT_FOLLOWLOCATION:设置重定位URL
     CURLOPT_RESUME_FROM:断点续传相关设置。
    CURLOPT_RANGE指定char *参数传递给libcurl，用于指明http域的RANGE头域，例如：
        表示头500个字节：bytes=0-499
        表示第二个500字节：bytes=500-999
        表示最后500个字节：bytes=-500
        表示500字节以后的范围：bytes=500-
        第一个和最后一个字节：bytes=0-0,-1
        同时指定几个范围：bytes=500-600,601-999
    CURLOPT_RESUME_FROM传递一个long参数给libcurl，指定你希望开始传递的偏移量。
  9.CURLOPT_UPLOAD：
    如果第三个参数被设置为1的话，就是让libcurl做好上传的准备。如果传输协议是http的话，uoload就是发送put。
  10. CURLOPT_SSL_VERIFYPEER:
    第三个参数的缺省值为1.该函数多用于设定curl忽略对网站证书的检查（不管忽略不忽略，curl都是检查的）。
  11.CURLOPT_VERBOSE
    相当厉害的一个参数，可以向控制台（默认）输出curl接受和发送的数据，输出流可以重定向。
  12.CURLOPT_HTTPGET
    将curl向服务器交互数据的方式改变为get

在初始化CURL类型的指针 以及curl_easy_setopt完成后调用，就像字面的意思所说perform就像是个舞台，让我们设置的option 运作起来。

CURLcode curl_easy_perform(CURL *handle);
1.CURLE_OK								//任务完成一切都好
2.CURLE_UNSUPPORTED_PROTOCOL			//不支持的协议，由URL的头部指定
3.CURLE_COULDNT_CONNECT					//不能连接到remote 主机或者代理
4.CURLE_REMOTE_ACCESS_DENIED			//访问被拒绝
5.CURLE_HTTP_RETURNED_ERROR				//Http返回错误
6.CURLE_READ_ERROR						//读本地文件错误
返回值：CURLcode变量：curl的状态

三.库安装编译方法

1.从GitHub上下载完之后，对文件进行解压

tar xvf curl-7.71.1.tar.bz2

2.阅读README文件或docs文件，这里会提示一些API的使用方法。

 3.阅读INSTALL文件，这里会告诉你编译的具体方法

 4.了解过编译过程之后，就可以进行下面的编译了

配置后后把所以的文件放到当前目录下的_install文件夹下：

./configure --prefix=$PWD/_install

此时还并未生成_install文件夹，输入make进行编译

 安装：make install

此时生成成功，就可以结合libcurl库编程使用了。