一、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。

在初始化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的状态