libcurl教程

约定不等于承诺〃 2022-09-23 14:59 210阅读 0赞

###  转自[http://blog.csdn.net/JGood/archive/2009/11/09/4787670.aspx][http_blog.csdn.net_JGood_archive_2009_11_09_4787670.aspx] ###

libcurl在VC下编译主要有以下几步

1. 下载msvc平台的libcurl，压缩包中有一些头文件，dll文件，lib文件

2.  新建一个项目，把解压出来的头文件全部放进去，在项目-设置-link标签页中，把"libcurl.lib"加入modules

3.  把libcurl.lib文件拷贝到项目所在文件夹

4.  编译一下这个项目，会生成debug目录，将libcurl.dll文件放入debug目录

5.  再编译一下，会发现需要一个叫zlib1.dll的库文件，这是因为libcurl用到了zlib这一开源的压缩编码库，所以你需要自己从网上下载这个文件，放在debug目录中

6. 此后要发布自己编译的程序，一定要记住把libcurl.dll和zlib1.dll这两个文件一起拷贝到程序目录下

### 全局初始化 ###

应用程序在使用libcurl之前，必须先初始化libcurl。libcurl只需初始化一次。可以使用以下语句进行初始化：

curl_global_init();

curl\_global\_init()接收一个参数，告诉libcurl如何初始化。参数*CURL\_GLOBAL\_ALL* 会使libcurl初始化所有的子模块和一些默认的选项，通常这是一个比较好的默认参数值。还有两个可选值：

##### CURL\_GLOBAL\_WIN32 #####

只能应用于Windows平台。它告诉libcurl初始化winsock库。如果winsock库没有正确地初始化，应用程序就不能使用socket。在应用程序中，只要初始化一次即可。

##### CURL\_GLOBAL\_SSL #####

如果libcurl在编译时被设定支持SSL，那么该参数用于初始化相应的SSL库。同样，在应用程序中，只要初始化一次即可。

libcurl有默认的保护机制，如果在调用curl\_easy\_perform时它检测到还没有通过curl\_global\_init进行初始化，libcurl会根据当前的运行时环境，自动调用全局初始化函数。但必须清楚的是，让系统自已初始化不是一个好的选择。

当应用程序不再使用libcurl的时候，应该调用curl\_global\_cleanup来释放相关的资源。

在程序中，应当避免多次调用curl\_global\_init和curl\_global\_cleanup。它们只能被调用一次。

### 使用easy interface ###

首先介绍libcurl中被称为easy interface的api函数，所有这些函数都是有相同的前缀：curl\_easy 。

要使用easy interface，首先必须创建一个easy handle，easy handle用于执行每次操作。基本上，每个线程都应该有自己的easy handle用于数据通信（如果需要的话）。千万不要在多线程之间共享同一个easy handle。下面的函数用于获取一个easy handle ：

CURL \*easy\_handle = curl\_easy\_init();

在easy handle上可以设置属性和操作(action)。easy handle就像一个逻辑连接，用于接下来要进行的数据传输。

使用curl\_easy\_setopt函数可以设置easy handle的属性和操作，这些属性和操作控制libcurl如何与远程主机进行数据通信。一旦在easy handle中设置了相应的属性和操作，它们将一直作用该easy handle。也就是说，重复使用easy hanle向远程主机发出请求，先前设置的属性仍然生效。

easy handle的许多属性使用字符串(以\\0结尾的字节数组)来设置。通过curl\_easy\_setopt函数设置字符串属性时，libcurl内部会自动拷贝这些字符串，所以在设置完相关属性之后，字符串可以直接被释放掉（如果需要的话）。

easy handle最基本、最常用的属性是URL。你应当通过CURLOPT\_URL属性提供适当的URL：

curl\_easy\_setopt(easy\_handle, CURLOPT\_URL, "http://blog.csdn.net/JGood ");

假设你要获取URL所表示的远程主机上的资源。你需要写一段程序用来完成数据传输，你可能希望直接保存接收到的数据而不是简单的在输出窗口中打印它们。所以，你必须首先写一个回调函数用来保存接收到的数据。回调函数的原型如下：

size\_t write\_data(void \*buffer, size\_t size, size\_t nmemb, void \*userp);

可以使用下面的语句来注册回调函数，回调函数将会在接收到数据的时候被调用：

curl\_easy\_setopt(easy\_handle, CURLOPT\_WRITEFUNCTION, write\_data);

可以给回调函数提供一个自定义参数，libcurl不处理该参数，只是简单的传递：

curl\_easy\_setopt(easy\_handle, CURLOPT\_WRITEDATA, &internal\_struct);

如果你没有通过CURLOPT\_WRITEFUNCTION属性给easy handle设置回调函数，libcurl会提供一个默认的回调函数，它只是简单的将接收到的数据打印到标准输出。你也可以通过CURLOPT\_WRITEDATA属性给默认回调函数传递一个已经打开的文件指针，用于将数据输出到文件里。

下面是一些平台相关的注意点。在一些平台上，libcurl不能直接操作由应用程序打开的文件。所以，如果使用默认的回调函数，同时通过CURLOPT\_WRITEDATA属性给easy handle传递一个文件指针，应用程序可能会执行失败。如果你希望自己的程序能跑在任何系统上，你必须避免出现这种情况。

如果以win32动态连接库的形式来使用libcurl，在设置CURLOPT\_WRITEDATA属性时，你必须**同时** 使用CURLOPT\_WRITEFUNCTION来注册回调函数。否则程序会执行失败（笔者尝试只传递一个打开的文件指针而不显式设置回调函数，程序并没有崩溃。可能是我使用的方式不正确。）。

当然，libcurl还支持许多其他的属性，在接下来的篇幅里，你将会逐步地接触到它们。调用下面的函数，将执行真正的数据通信：

success = curl\_easy\_perform(easy\_handle);

curl\_easy\_perfrom将连接到远程主机，执行必要的命令，并接收数据。当接收到数据时，先前设置的回调函数将被调用。libcurl可能一次只接收到1字节的数据，也可能接收到好几K的数据，libcurl会尽可能多、及时的将数据传递给回调函数。回调函数返回接收的数据长度。如果回调函数返回的数据长度与传递给它的长度不一致（即返回长度 != size \* nmemb），libcurl将会终止操作，并返回一个错误代码。

当数据传递结束的时候，curl\_easy\_perform将返回一个代码表示操作成功或失败。如果需要获取更多有关通信细节的信息，你可以设置CURLOPT\_ERRORBUFFER属性，让libcurl缓存许多可读的错误信息。

easy handle在完成一次数据通信之后可以被重用。这里非常建议你重用一个已经存在的easy handle。如果在完成数据传输之后，你创建另一个easy handle来执行其他的数据通信，libcurl在内部会尝试着重用上一次创建的连接。

对于有些协议，下载文件可能包括许多复杂的子过程：日志记录、设置传输模式、选择当前文件夹，最后下载文件数据。使用libcurl，你不需要关心这一切，你只需简单地提供一个URL，libcurl会给你做剩余所有的工作。

下面的这个例子演示了如何获取网页源码，将其保存到本地文件，并同时将获取的源码输出到控制台上。

size_t process_data(void *buffer, size_t size, size_t nmemb, void *user_p) { FILE *fp = (FILE *)user_p; size_t return_size = fwrite(buffer, size, nmemb, fp); cout << (char *)buffer << endl;

return return_size; }
    
    int main(int argc, char **argv) { // 初始化libcurl CURLcode return_code; return_code = curl_global_init(CURL_GLOBAL_WIN32); if (CURLE_OK != return_code) { cerr << "init libcurl failed." << endl;return -1; }
    
    // 获取easy handle CURL *easy_handle = curl_easy_init();
    if (NULL == easy_handle)
    {
    cerr << "get a easy handle failed." << endl;
    curl_global_cleanup();

return -1;
    }
    FILE *fp = fopen("data.html", "ab+"); // // 设置easy handle属性 curl_easy_setopt(easy_handle, CURLOPT_URL,http://blog.csdn.net/JGood);
    curl_easy_setopt(easy_handle, CURLOPT_WRITEFUNCTION, &process_data);
    curl_easy_setopt(easy_handle, CURLOPT_WRITEDATA, fp);
    
    // 执行数据请求 curl_easy_perform(easy_handle); 
    // 释放资源 
    fclose(fp);
    curl_easy_cleanup(easy_handle);
    curl_global_cleanup();
    
    return 0;
    }

## ##

上传数据到远程站点

libcurl提供协议无关的方式进行数据传输。所以上传一个文件到FTP服务器，跟向HTTP服务器提交一个PUT请求的操作方式是类似的：

1. 创建easy handle或者重用先前创建的easy handle。

2. 设置CURLOPT\_URL属性。

3. 编写回调函数。在执行上传的时候，libcurl通过回调函数读取要上传的数据。（如果要从远程服务器下载数据，可以通过回调来保存接收到的数据。）回调函数的原型如下：

size_t function(char *bufptr, size_t size, size_t nitems, void *userp);

bufptr指针表示缓冲区，用于保存要上传的数据，size \* nitems是缓冲区数据的长度，userp是一个用户自定义指针，libcurl不对该指针作任何操作，它只是简单的传递该指针。可以使用该指针在应用程序与libcurl之间传递信息。

4. 注册回调函数，设置自定义指针。语法如下：

// 注册回调函数 curl_easy_setopt(easy_handle, CURLOPT_READFUNCTION, read_function); // 设置自定义指针curl_easy_setopt(easy_handle, CURLOPT_READDATA, &filedata);

5. 告诉libcurl，执行的是上传操作。

curl_easy_setopt(easy_handle, CURLOPT_UPLOAD, 1L);

有些协议在没有预先知道上传文件大小的情况下，可能无法正确判断上传是否结束，所以最好预先使用CURLOPT\_INFILESIZE\_LARGE属性：告诉它要上传文件的大小：

curl_easy_setopt(easy_handle, CURLOPT_INFILESIZE_LARGE, file_size);

6. 调用curl\_easy\_perform。

接下来，libcurl将会完成剩下的所有工作。在上传文件过程中，libcurl会不断调用先前设置的回调函数，用于将要上传的数据读入到缓冲区，并执行上传。

下面的例子演示如何将文件上传到FTP服务器。笔者使用的是IIS自带的FTP服务，同时在FTP上设置了可写权限。

size_t read_data(void *buffer, size_t size, size_t nmemb, void *user_p) { return fread(buffer, size, nmemb, (FILE *)user_p); } 
    int main(int argc, char **argv) { // 初始化libcurl CURLcode code;
    code = curl_global_init(CURL_GLOBAL_WIN32); if (code != CURLE_OK) { cerr << "init libcurl failed." << endl;return -1; } 
    FILE *fp = fopen("a.html", "rb"); if (NULL == fp) {
    cout << "can't open file." << endl; curl_global_cleanup(); return -1; }
    
    // 获取文件大小 fseek(fp, 0, 2);
    int file_size = ftell(fp); rewind(fp); 
    // 获取easy handle 
    CURL *easy_handle = NULL; easy_handle = curl_easy_init(); if (NULL == easy_handle) { cerr << "get a easy handle failed." << endl; fclose(fp); curl_global_cleanup(); return -1;
    }
    
    // 设置eash handle属性 curl_easy_setopt(easy_handle, CURLOPT_URL, ftp://127.0.0.1/upload.html); curl_easy_setopt(easy_handle, CURLOPT_UPLOAD, 1L); curl_easy_setopt(easy_handle, CURLOPT_READFUNCTION, &read_data); curl_easy_setopt(easy_handle, CURLOPT_READDATA, fp); curl_easy_setopt(easy_handle, CURLOPT_INFILESIZE_LARGE, file_size); 
    // 执行上传操作 code = curl_easy_perform(easy_handle); if (code == CURLE_OK) { cout << "upload successfully." << endl; }
    
    // 释放资源 fclose(fp);
    curl_easy_cleanup(easy_handle);
    curl_global_cleanup();
    
    return 0; }

## ##

### 关于密码 ###

客户端向服务器发送请求时，许多协议都要求提供用户名与密码。libcurl提供了多种方式来设置它们。

一些协议支持在URL中直接指定用户名和密码，类似于： protocol://user:password@example.com/path/。libcurl能正确的识别这种URL中的用户名与密码并执行相应的操作。如果你提供的用户名和密码中有特殊字符，首先应该对其进行URL编码。

也可以通过CURLOPT\_USERPWD属性来设置用户名与密码。参数是格式如 “user:password ”的字符串：

curl_easy_setopt(easy_handle, CURLOPT_USERPWD, "user_name:password");

（下面这几段文字我理解地模模糊糊）有时候在访问代理服务器的时候，可能时时要求提供用户名和密码进行用户身份验证。这种情况下，libcurl提供了另一个属性CURLOPT\_PROXYUSERPWD：

curl_easy_setopt(easy_handle, CURLOPT_PROXYUSERPWD, "user_name:password");

在UNIX平台下，访问FTP的用户名和密码可能会被保存在$HOME/.netrc文件中。libcurl支持直接从这个文件中获取用户名与密码：

curl_easy_setopt(easy_handle, CURLOPT_NETRC, 1L);

在使用SSL时，可能需要提供一个私钥用于数据安全传输，通过CURLOPT\_KEYPASSWD来设置私钥：

curl_easy_setopt(easy_handle, CURLOPT_KEYPASSWD, "keypassword");

## ##

### HTTP验证 ###

上一章介绍了如何在libcurl中，对需要身份验证的URL设置用户名与密码。在使用HTTP协议时，客户端有很多种方式向服务器提供验证信息。默认的HTTP验证方法是"Basic”，它将用户名与密码以明文的方式、经Base64编码后保存在HTTP请求头中，发往服务器。当然这不太安全。

当前版本的libcurl支持的验证方法有：basic, Digest, NTLM, Negotiate, GSS-Negotiate and SPNEGO。（译者感叹：搞Web这么多年，尽然不知道这些Http的验证方式，实在惭愧。）可以通过CURLOPT\_HTTPAUTH属性来设置具体的验证方式：

curl_easy_setopt(easy_handle, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);

向代理服务器发送验证信息时，可以通过CURLOPT\_PROXYAUTH设置验证方式：

curl_easy_setopt(easy_handle, CURLOPT_PROXYAUTH, CURLAUTH_NTLM);

也可以同时设置多种验证方式（通过按位与），使用‘CURLAUTH\_ANY‘将允许libcurl可以选择任何它所支持的验证方式。通过CURLOPT\_HTTPAUTH或CURLOPT\_PROXYAUTH属性设置的多种验证方式，libcurl会在运行时选择一种它认为是最好的方式与服务器通信：

curl_easy_setopt(easy_handle, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST|CURLAUTH_BASIC); 
    // curl_easy_setopt(easy_handle, CURLOPT_HTTPAUTH, CURLAUTH_ANY);

## ##

### HTTP Post ###

这一章介绍如何使用libcurl以Post方式向HTTP服务器提交数据。

方法一，也是最简单的方式，就像html中使用<form>标签提交数据一样，只需向libcurl提供一个包含数据的字符串即可。下面是笔者学习过程中的一个demo程序：

int main(int argc, char **argv) { code = curl_global_init(CURL_GLOBAL_WIN32); CURL *easy_handle = curl_easy_init(); 
    curl_easy_setopt(easy_handle, CURLOPT_URL, http://localhost:2210/Default.aspx); // 单个域post curl_easy_setopt(easy_handle, CURLOPT_POSTFIELDS, "name=jgood&address=hangzhou");
    code = curl_easy_perform(easy_handle);
    curl_easy_cleanup(easy_handle);
    curl_global_cleanup();
    
    return 0; }

上面的代码够简单吧~\_~ 有时候，我们需要提交一些二进制数据到HTTP服务器，使用方法一就不行了，因为方法一中实际提交的是一个字符串，字符串遇到\\0就表示结束了。所以在上传二进制数据的时候，必须明确的告诉libcurl要提交的数据的长度。在上传二进制数据的时候，还应该设置提交的Content-Type头信息。下面的示例代码：

int main(int argc, char **argv) { curl_global_init(CURL_GLOBAL_WIN32);
    CURL *easy_handle = curl_easy_init();
    
    // 上传二进制数据 char data[] = { 1, 0, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0 }; curl_slist *http_headers = NULL; http_headers = curl_slist_append(http_headers, "Content-Type: text/xml");
    curl_easy_setopt(easy_handle, CURLOPT_HTTPHEADER, http_headers);
    curl_easy_setopt(easy_handle, CURLOPT_URL, http://localhost:2210/Default.aspx); curl_easy_setopt(easy_handle, CURLOPT_POSTFIELDS, data); curl_easy_setopt(easy_handle, CURLOPT_POSTFIELDSIZE, sizeof(data)); 
    curl_easy_perform(easy_handle); 
    curl_slist_free_all(http_headers); curl_easy_cleanup(easy_handle); curl_global_cleanup();
    
    return 0; }

上面介绍的两种方式，可以完成大部分的HTTP POST操作。但上面的两种方式都不支持multi-part formposts。Multi-part formposts被认为是提交二进制数据(或大量数据)的更好方法，可以在RFC1867, RFC2388中找到他们的定义。何为Multi-part？其实，就我理解，就是在Post提交的时候，有不同的数据单元，每个单元有自己的名称与内容，内容可以是文本的，也可以是二进制的。同时，每个数据单元都可以有自己的消息头，MIME类型，这些数据单元组成一个链表，提交到HTTP服务器。libcurl提供了方便的api用于支持multi-part formposts。使用curl\_formadd函数，可以添加不同的数据数据单元，然后提交到服务器。下面是一个multi-part formposts的例子（更详细的使用，请参考：[http://curl.haxx.se/libcurl/c/curl\_formadd.html][http_curl.haxx.se_libcurl_c_curl_formadd.html] ）：

int main() {

curl\_global\_init(CURL\_GLOBAL\_WIN32);   
               CURL \*easy\_handle = curl\_easy\_init();

// 使用multi-parts form post curl_easy_setopt(easy_handle, CURLOPT_URL, http://localhost:2210/Default.aspx);
    curl_httppost *post = NULL;
    curl_httppost *last = NULL; 
    // 文本数据 curl_formadd(&post, &last, CURLFORM_COPYNAME, "name", CURLFORM_COPYCONTENTS, "JGood", CURLFORM_END);
    curl_formadd(&post, &last, CURLFORM_COPYNAME, "address", CURLFORM_COPYCONTENTS, "HangZhou", CURLFORM_END);
    // 文本文件中的数据 curl_formadd(&post, &last, CURLFORM_COPYNAME, "file", CURLFORM_FILECONTENT, "ReadMe.txt", CURLFORM_END); curl_easy_setopt(easy_handle, CURLOPT_HTTPPOST, post); curl_easy_perform(easy_handle);
    curl_formfree(post); curl_easy_cleanup(easy_handle); curl_global_cleanup(); 
    return 0; }

最后要说明的是，所有在easy handle上设置的属性都是”sticky”的，什么意思？就是说在easy handle上设置的属性都将被保存，即使执行完curl\_easy\_perform之后，这些属性值仍然存在。通过将CURLOPT\_HTTPGET设为1可以使easy handle回到最原始的状态：

curl_easy_setopt(easy_handle, CURLOPT_HTTPGET, 1L);

## ##

### 显示进度 ###

libcurl支持通信过程中的进度控制。通过将CURLOPT\_NOPROCESS设置为0开启进度支持。该选项默认值为1。对大多数应用程序，我们需要提供一个进度显示回调。libcurl会不定期的将当前传输的进度通过回调函数告诉你的程序。回调函数的原型如下：

int progress_callback(void *clientp, double dltotal, double dlnow, double ultotal, double ulnow);

通过CURLOPT\_PROGRESSFUNCTION注册该回调函数。参数clientp是一个用户自定义指针，应用程序通过CURLOPT\_PROCESSDATA属性将该自定义指定传递给libcurl。libcurl对该参数不作任何处理，只是简单将其传递给回调函数。

### 在C++中使用libcurl ###

在C++中使用libcurl跟在C语言中没有任何区别，只有一个地方要注意：回调函数不能是类的非静态成员函数。例如：

class AClass { static size_t write_data(void *ptr, size_t size, size_t nmemb, void *ourpointer) { } }

## ##

### 代理 ###

什么是代理？Merrian-Webster的解释是：一个通过验证的用户扮演另一个用户。今天，代理已经被广泛的使用。许多公司提供网络代理服务器，允许员工的网络客户端访问、下载文件。代理服务器处理这些用户的请求。

libcurl支持SOCKS和HTTP代理。使用代理，libcurl会把用户输入的URL提交给代理服务器，而不是直接根据URL去访问远程资源。

当前版本的libcurl并不支持SOCKS代理的所有功能。

对于HTTP代理来说，即使请求的URL不是一个合法的HTTP URL（比方你提供了一个ftp的url），它仍然会先被提交到HTTP代理。

##### 代理选项 #####

CURLOPT\_PROXY属性用于设置libcurl使用的代理服务器地址：

curl_easy_setopt(easy_handle, CURLOPT_PROXY, "proxy-host.com:8080");

可以把主机名与端口号分开设置：

curl_easy_setopt(easy_handle, CURLOPT_PROXY, "proxy-host.com"); curl_easy_setopt(easy_handle, CURLOPT_PROXYPORT, "8080"); // 端口号是用字符串还是整数？？

有些代理服务器要求用户通过验证之后才允许接受其请求，此时应该先提供验证信息：

curl_easy_setopt(easy_handle, CURLOPT_PROXYUSERPWD, "user:password");

还要告诉libcurl使用的代理类型（如果没有提供，libcurl会认为是HTTP代理）：

curl_easy_setopt(easy_handle, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS4);

#### ####

##### 环境变量 #####

对于有些协议，libcurl会自动检测并使用一些环境变量，并根据这些环境变量来确定要使用的代理服务器。这些环境变量的名称格式一般是"\[protocol\]\_proxy"（注意小写）。例如输入一个HTTP的URL，那么名称为"http\_proxy"的环境变量就会被检测是否存在，如果存在，libcurl会使用该环境变量指定的代理。相同的规则也适用于FTP。

这些环境变量的值的格式必须是这样的："\[protocol://\]\[user:password@\]machine\[:port\]"。libcurl会忽略掉\[protocol://\]，如果没有提供端口号，libcurl使用该协议的默认端口。

有两个比较特殊的环境变量：'all\_proxy'与'no\_proxy'。如果一个URL所对应的协议，它的环境变量没有设置，那么'all\_proxy'指定的代理将被使用。'no\_proxy'则指定了一个不应被使用的代理主机的列表。例如：no\_proxy的值是'192.168.1.10'，即使存在http\_proxy，它的值也是'192.168.1.10'，'192.168.1.10'也不会被作为代理。no\_proxy=”\*”表示不允许使用任何代理。

显式地将CURLOPT\_PROXY属性设置为空，可以禁止libcurl检查并使用环境变量来使用代理。

##### SSL和代理 #####

SSL为点到点通信提供安全保障。它包含一些强壮的加密措施和其他安全检测，这使得上面讲到的代理方式不适用于SSL。除非代理服务器提供专用通道，对进出该代理服务器的数据不作任何检测或禁止。通过HTTP代理服务器打开SSL连接，意味着代理服务器要直接连接到目标主机的指定端口。因为代理服务器对在专用通道上传输的数据的类型毫无所知，所以它往往会使某些机制失效，如缓存机制。许多组织只允许在443端口上创建这种类型的数据通道。

##### 代理通道(Tunneling Through Proxy) #####

正如上面讲到的，要使SSL工作必须在代理服务器创建专用数据通道，通常专用通道只被限制应用于HTTPS。通过HTTP代理在应用程序与目标之间创建一个专用数据通道，应该预防在该专有通道上执行非HTTP的操作，如进行FTP上传或执行FTP命令。代理服务器管理员应该禁止非法的操作。

通过CURLOPT\_HTTPPROXYTUNNEL属性来告诉libcurl使用代理通道：

curl_easy_setopt(easy_handle, CURLOPT_HTTPPROXYTUNNEL, 1L);

有时候你想通过代理通道执行平常的HTTP操作，而实际上却可能使你不经过代理服务器而直接与远程主机进行交互。libcurl不会代替这种新引入的行为。

##### 自动配置代理 #####

许多浏览器支持自动配置代理，例如NetScape。libcurl并不支持这些。

### 持久化的好处(Persistence Is The Way to Happiness) ###

当需要发送多次请求时，应该重复使用easy handle。

每次执行完curl\_easy\_perform，licurl会继续保持与服务器的连接。接下来的请求可以使用这个连接而不必创建新的连接（如果目标主机是同一个的话）。这样可以减少网络开销。   
    即使连接被释放了，libcurl也会缓存这些连接的会话信息，这样下次再连接到目标主机上时，就可以使用这些信息，从而减少重新连接所需的时间。

FTP连接可能会被保存较长的时间。因为客户端要与FTP服务器进行频繁的命令交互。对于有访问人数上限的FTP服务器，保持一个长连接，可以使你不需要排除等待，就直接可以与FTP服务器通信。

libcurl会缓存DNS的解析结果。

在今后的libcurl版本中，还会添加一些特性来提高数据通信的效率。   
    每个easy handle都会保存最近使用的几个连接，以备重用。默认是5个。可以通过CURLOPT\_MAXCONNECTS属性来设置保存连接的数量。

如果你不想重用连接，将CURLOPT\_FRESH\_CONNECT属性设置为1。这样每次提交请求时，libcurl都会先关闭以前创建的连接，然后重新创建一个新的连接。也可以将CURLOPT\_FORBID\_REUSE设置为1，这样每次执行完请求，连接就会马上关闭。

### libcurl使用的HTTP消息头 ###

当使用libcurl发送http请求时，它会自动添加一些http头。我们可以通过CURLOPT\_HTTPHEADER属性手动替换、添加或删除相应的HTTP消息头。

##### Host #####

http1.1（大部分http1.0)版本都要求客户端请求提供这个信息头。

##### Pragma #####

"no-cache"。表示不要缓冲数据。

##### Accept #####

"\* headers = curl\_slist\_append(headers, "Hey-server-hey: how are you?"); headers = curl\_slist\_append(headers, "X-silly-content: yes"); curl\_easy\_setopt(easyhandle, CURLOPT\_HTTPHEADER, headers); curl\_easy\_perform(easyhandle); curl\_slist\_free\_all(headers);

对于已经存在的消息头，可以重新设置它的值：

headers = curl_slist_append(headers, "Accept: Agent-007"); headers = curl_slist_append(headers, "Host: munged.host.line");

#### ####

##### 删除消息头 #####

对于一个已经存在的消息头，设置它的内容为空，libcurl在发送请求时就不会同时提交该消息头：

headers = curl_slist_append(headers, "Accept:");

## ##

### 强制分块传输(Enforcing chunked transfer-encoding) ###

（这段文字理解可能有误码）以非GET的方式提交HTTP请求时，如果设置了自定义的消息头”Transfer-Encoding:chunked”，libcurl会分块提交数据，即使要上传的数据量已经知道。在上传数据大小未知的情况下，libcurl自动采用分块上传数据。（译者注：非GET方式提交请求，提交的数据量往往比较大。）

### HTTP版本 ###

每一次http请求，都包含一个表示当前使用http版本的消息头。libcurl默认使用HTTP 1.1。可以通过CURLOPT\_HTTP\_VERSION属性来设置具体的版本号：

curl_easy_setopt(easy_handle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);

## ##

### FTP自定义命令 ###

并不是所以的协议都像HTTP那样，通过消息头来告诉服务器如何处理请求。对于FTP，你就要使用另外的方式来处理。

发送自定义的命令到ftp服务器，意味着你发送的命令必须是能被ftp服务器理解的命令（FTP协议中定义的命令，参考rfc959）。

下面是一个简单的例子，在文件传输操作操作之前删除指定文件：

headers = curl_slist_append(headers, "DELE file-to-remove");
    
    curl_easy_setopt(easyhandle, CURLOPT_QUOTE, headers);
    // curl_easy_setopt(easyhandle, CURLOPT_POSTQUOTE, headers); // 在数据传输之后操行删除操作

curl_easy_perform(easyhandle); curl_slist_free_all(headers);

FTP服务器执行命令的顺序，同这些命令被添加到列表中顺序是一致的。发往服务器的命令列表中，只要有一个命令执行失败，ftp服务器就会返回一个错误代码，此时libcurl将直接返回CURLE\_QUOTE\_ERROR，不再执行剩余的FTP命令。

将CURLOPT\_HEADER设置为1，libcurl获取目标文件的信息，并以HTTP消息头的样式来输出消息头。

##### FTP自定义CUSTOMREQUEST #####

使用CURLOPT\_CUSTOMREQUEST属性，可以向FTP服务器发送命令。"NLST"是ftp默认的列出文件列表的命令。下面的代码用于列出FTP服务器上的文件列表：

int main(int argc, char **argv) { curl_global_init(CURL_GLOBAL_WIN32);
    CURL *easy_handle = curl_easy_init(); curl_easy_setopt(easy_handle, CURLOPT_URL, "ftp://127.0.0.1/"); curl_easy_setopt(easy_handle, CURLOPT_CUSTOMREQUEST, "NLST");

curl_easy_perform(easy_handle);
    curl_easy_cleanup(easy_handle); curl_global_cleanup(); 
    return 0;
    }

[http_blog.csdn.net_JGood_archive_2009_11_09_4787670.aspx]: http://blog.csdn.net/JGood/archive/2009/11/09/4787670.aspx
[http_curl.haxx.se_libcurl_c_curl_formadd.html]: http://curl.haxx.se/libcurl/c/curl_formadd.html