一、LibCurl简介

LibCurl是免费的客户端URL传输库，支持FTP,FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, FILE ，LDAP等协议，其主页是http://curl.haxx.se/。Libcurl具备线程安全、IpV6兼容、易于使用的特点。curl也是Linux下一个非常著名的下载库，通过这个库，可以很简单的实现文件的下载等操作

二、LibCurl编程

1) LibCurl编程流程

在基于LibCurl的程序里，主要采用callback function （回调函数）的形式完成传输任务，用户在启动传输前设置好各类参数和回调函数，当满足条件时libcurl将调用用户的回调函数实现特定功能。下面是利用libcurl完成传输任务的流程：

1.       调用curl_global_init()初始化libcurl

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

3.       调用curl_easy_setopt设置传输选项

4.       根据curl_easy_setopt设置的传输选项，实现回调函数以完成用户特定任务

5.       调用curl_easy_perform（）函数完成传输任务

6.       调用curl_easy_cleanup（）释放内存

在整过过程中设置curl_easy_setopt()参数是最关键的，几乎所有的libcurl程序都要使它。

2) 重要函数

1.CURLcode curl_global_init(long flags);

描述：这个函数只能用一次。(其实在调用curl_global_cleanup 函数后仍然可再用)

如果这个函数在curl_easy_init函数调用时还没调用，它讲由libcurl库自动完成。

参数：flags

CURL_GLOBAL_ALL                 //初始化所有的可能的调用。

CURL_GLOBAL_SSL                 //初始化支持 安全套接字层。

CURL_GLOBAL_WIN32            //初始化win32套接字库。

CURL_GLOBAL_NOTHING         //没有额外的初始化。

2 void curl_global_cleanup(void);

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

3 char *curl_version( );

描述: 打印当前libcurl库的版本。

4 CURL *curl_easy_init( );

描述:curl_easy_init用来初始化一个CURL的指针(有些像返回FILE类型的指针一样). 相应的在调用结束时要用curl_easy_cleanup函数清理.

一般curl_easy_init意味着一个会话的开始. 它的返回值一般都用在easy系列的函数中.

5 void curl_easy_cleanup(CURL *handle);

描述:这个调用用来结束一个会话.与curl_easy_init配合着用.

参数:CURL类型的指针.

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

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

1 CURL类型的指针

2 各种CURLoption类型的选项.(都在curl.h库里有定义,man 也可以查看到)

3 parameter 这个参数 既可以是个函数的指针,也可以是某个对象的指针,也可以是个long型的变量.它用什么这取决于第二个参数.CURLoption 这个参数的取值很多.具体的可以查看man手册.

7 CURLcode curl_easy_perform(CURL *handle);

描述:这个函数在初始化CURL类型的指针 以及curl_easy_setopt完成后调用. 就像字面的意思所说perform就像是个舞台.让我们设置的

option 运作起来.参数:CURL类型的指针.

3.3 curl_easy_setopt函数介绍

本节主要介绍curl_easy_setopt中跟http相关的参数。注意本节的阐述都是以libcurl作为主体，其它为客体来阐述的。

1. CURLOPT_URL

设置访问URL

2. CURLOPT_WRITEFUNCTION，CURLOPT_WRITEDATA

回调函数原型为：size_t function( void *ptr, size_t size, size_t nmemb, void *stream); 函数将在libcurl接收到数据后被调用，因此函数多做数据保存的功能，如处理下载文件。CURLOPT_WRITEDATA 用于表明CURLOPT_WRITEFUNCTION函数中的stream指针的来源。

3. CURLOPT_HEADERFUNCTION，CURLOPT_HEADERDATA

回调函数原型为 size_t function( void *ptr, size_t size,size_t nmemb, void *stream); libcurl一旦接收到http 头部数据后将调用该函数。CURLOPT_WRITEDATA 传递指针给libcurl，该指针表明CURLOPT_HEADERFUNCTION 函数的stream指针的来源。

4. CURLOPT_READFUNCTION CURLOPT_READDATA

libCurl需要读取数据传递给远程主机时将调用CURLOPT_READFUNCTION指定的函数，函数原型是：size_t function(void *ptr, size_t size, size_t nmemb,void *stream). CURLOPT_READDATA 表明CURLOPT_READFUNCTION函数原型中的stream指针来源。

5. CURLOPT_NOPROGRESS，CURLOPT_PROGRESSFUNCTION，CURLOPT_PROGRESSDATA

跟数据传输进度相关的参数。CURLOPT_PROGRESSFUNCTION 指定的函数正常情况下每秒被libcurl调用一次，为了使CURLOPT_PROGRESSFUNCTION被调用，CURLOPT_NOPROGRESS必须被设置为false，CURLOPT_PROGRESSDATA指定的参数将作为CURLOPT_PROGRESSFUNCTION指定函数的第一个参数

6. CURLOPT_TIMEOUT，CURLOPT_CONNECTIONTIMEOUT:

CURLOPT_TIMEOUT 由于设置传输时间，CURLOPT_CONNECTIONTIMEOUT 设置连接等待时间

7. CURLOPT_FOLLOWLOCATION

设置重定位URL

CURLOPT_RANGE: 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，指定你希望开始传递的

偏移量。

8. //CURLOPT_SSL_VERIFYPEER禁 用后cURL将终止从服务端进行验证。

//使用CURLOPT_CAINFO选项设置证书使用CURLOPT_CAPATH选项设置证书目录 如果

//CURLOPT_SSL_VERIFYPEER(默认值为2)被启用，CURLOPT_SSL_VERIFYHOST需要被设置成TRUE否则设置为 FALSE。

 

3.4 curl_easy_perform 函数说明（error 状态码）

该函数完成curl_easy_setopt指定的所有选项，本节重点介绍curl_easy_perform的返回值。返回0意味一切ok，非0代表错误发生。主要错误码说明：

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

读本地文件错误

三、简单例子：

#include <curl/curl.h>

#include <stdio.h>

#include <string.h>

CURL *curl;

CURLcode res;

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

{

if (strlen((char *)stream) + strlen((char *)ptr) > 999999) return 0;

strcat(stream, (char *)ptr);

return size*nmemb;

}

char *down_file(char *filename)

{

static char str[10000000];

strcpy(str, “”);

//return “”;

curl_easy_setopt(curl, CURLOPT_URL, filename); //设置下载地址

curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);//设置超时时间

curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);//设置写数据的函数

curl_easy_setopt(curl, CURLOPT_WRITEDATA, str);//设置写数据的变量

res = curl_easy_perform(curl);//执行下载

str[9999999] = ‘\0′;

if(CURLE_OK != res) return NULL;//判断是否下载成功

return str;

}

int main()

{

char url[200];

curl = curl_easy_init();//对curl进行初始化

 

char *result;

while(fgets(url, 200, stdin)){

result = down_file(url);

if (result) puts(result);

else puts(“Get Error!”);

printf(“\nPlease Input a url:”);

}

curl_easy_cleanup(curl);//释放curl资源

return 0;

}

四、安装使用

编译源码

 

有很多种不同的方式来编译C语言代码。这里使用UNIX平台下的编译方式。即使你使用的是其他的操作系统，你仍然可以通过阅读本文档来获取许多有用的信息。

编译

 

你的编译器必须知道libcurl头文件的位置。所以在编译的时候，你要设置头文件的包含路径。可以使用curl-config工具来获取这方面的信息：

$ curl-config –cflags

链接

 

编译完源码（这时的源代码不是指libcurl的源代码，你是你自己写的程序代码）之后，你还必须把目标文件链接成单个可执行文件。你要链接 libcurl库，以及libcurl所依赖的其他库，例如OpenSLL库。当然可能还需要一些其他的操作系统库。最后你还要设置一些编译选项，当然可 以使用curl-config工具简化操作：

$curl-config –libs

是否使用SSL

定制编译libcurl。与其他库不同的是，libcurl可以定制编译，根据实际需要是否支持某些特性，如是否支持SSL传输，像HTTPS和 FTPS。如果决定需要支持SSL，必须在编译时正确的设置。可以使用’curl-config’来判断libcurl库是否支持SSL：

$ curl-config –feature

autoconf宏

当你编写配置脚本来检测libcurl及其相应设置时，你可以使用预定义宏。文档docs/libcurl/libcurl.m4告诉你如何使用这些宏。

 

跨平台的可移植的代码

libcurl的开发人员花费很大的努力，使libcurl尽可能在大多数平台上正常运行。

全局初始化

应用程序在使用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。它们只能被调用一次。

五、使用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 ）：

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回到最原始的状态：

 

六、消息头处理

1.修改消息头

 

HTTP协议提供了消息头，请求消息头用于告诉服务器如何处理请求；响应消息头则告诉浏览器如何处理接收到的数据。在libcurl中，你可以自由的添加这些消息头：

 

struct curl_slist *headers=NULL; /* init to NULL is important */ headers = curl_slist_append(headers, "Hey-server-hey: how are you?"); headers = curl_slist_append(headers, "X-silly-content: yes"); /* pass our list of custom made headers */curl_easy_setopt(easyhandle, CURLOPT_HTTPHEADER, headers); curl_easy_perform(easyhandle); /* transfer http */ curl_slist_free_all(headers); /* free the header list */

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

 

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

2.删除消息头

 

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

 

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

七、curl_easy_getinfo

curl_easy_getinfo() 函数原型声明如下：

#include <curl/curl.h>

CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... );

使用该函数可以在请求求 curl 会话中的相关信息。注意，第 3 个参数必须是一个 long 型，或char型，或curl_slist型，抑或是double型的指针。函数所请求信息只有在函数返回 CURLE_OK 时才会被有效填充，该函数一般用在 perform 函数(如 curl_easy_perform() )之后。

 

第 2 个参数有众多选项，每个选项都有其相应的含义：

CURLINFO_SIZE_DOWNLOAD

使用该选项时要求第 3 个参数是个 double 型的指针，这样在一次传输成功后会将本次传输所下载的字节数赋值到指针所指向的 double 型变量中。注意，这个字节数只能反映最近一次的下载。

 

CURLINFO_SPEED_DOWNLOAD

该选项要求传递一个 double 型参数指针，用以接收下载的平均速度，这个速度不是即时速度，而是下载完成后的速度，单位是 字节/秒 。

 

CURLINFO_TOTAL_TIME

该选项要求传递一个 double 指针到函数中，double 型变量指示了传输的总耗时(单位为秒)，这个总的时间里包括了域名解析，以及 TCP 连接过程中所需要的时间。

 

CURLINFO_CONTENT_TYPE

该选项获得 HTTP 中从服务器端收到的头部中的 Content-Type 信息。

$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

 

我们期望的状态码是200，而且HTTP标准也对其它状态码做了一些定义。

总体范围	已定义类别	类别
100~199	100~101	信息
200~299	200~206	成功
300~399	300~305	重定向
400~499	400~415	客户端错误
500~599	500~505	服务端错误

原文:http://www.cnblogs.com/jikexianfeng/p/6055024.html

    http://blog.csdn.net/followingturing/article/details/7851425

 

实际示例:

curl_global_init(CURL_GLOBAL_ALL);//初始化所有的可能的调用。

    if(!(curl = curl_easy_init()))//curl_easy_init用来初始化一个CURL的指针(有些像返回FILE类型的指针一样). 相应的在调用结束时要用curl_easy_cleanup函数清理

    {

        return NULL;

    }

 

    //文件上传时间为60s

   if(curl_easy_setopt(curl, CURLOPT_TIMEOUT, 60) != CURLE_OK

        || !(pEventUrl = (EVENT_URL_S *)malloc(sizeof(EVENT_URL_S))))

    {

        DebugPrintf("set post file time out err!\n");

        curl_easy_cleanup(curl);

        curl_global_cleanup();

        return NULL;

    }

    //CURLOPT_SSL_VERIFYPEER禁 用后cURL将终止从服务端进行验证。

    //使用CURLOPT_CAINFO选项设置证书使用CURLOPT_CAPATH选项设置证书目录 如果

    //CURLOPT_SSL_VERIFYPEER(默认值为2)被启用，CURLOPT_SSL_VERIFYHOST需要被设置成TRUE否则设置为 FALSE。

    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);

    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);

   

    curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_MD5,

         CURLFORM_COPYCONTENTS, pEventMsg->pMD5, CURLFORM_END);

         

    curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_TOKEN,

         CURLFORM_COPYCONTENTS, token, CURLFORM_END);

         

    curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_WIDTH,

         CURLFORM_COPYCONTENTS, pEventMsg->pWidth , CURLFORM_END);

         

    curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_HEIGH,

         CURLFORM_COPYCONTENTS, pEventMsg->pHeight, CURLFORM_END);

         

    curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_PATH,

         CURLFORM_FILE, pEventMsg->pFilePath, CURLFORM_END);

         

    curl_formadd(&formpost, &lastptr, CURLFORM_COPYNAME, POST_FILE_THUMBNAIL,

         CURLFORM_COPYCONTENTS, "1", CURLFORM_END);

         

    headerlist = curl_slist_append(headerlist, "Expect:");  //对于一个已经存在的消息头，设置它的内容为空，libcurl在发送请求时就不会同时提交该消息头：

    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headerlist);

    curl_easy_setopt(curl, CURLOPT_URL, gpCC->ccArg.pUploadUrl);

    curl_easy_setopt(curl, CURLOPT_HTTPPOST, formpost);

    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, &SaveHttpResponse);   // 设置回调函数

    curl_easy_setopt(curl, CURLOPT_WRITEDATA, resMsg);  //  设置保存数据区

 

    //DebugPrintf("EventPostFile, token: %s\n", token);

    //DebugPrintf("EventPostFile, md5: %s\n", pEventMsg->pMD5);

    while(count < 3)

    {  

        resMsg[0] = '\0';

        //DebugPrintf("upload start: %lld\n", GetSysRunSec());

        res = curl_easy_perform(curl);

        //DebugPrintf("upload end: %lld\n", GetSysRunSec());

        curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &httpRetCode);//取得response code

        DebugPrintf("res: %d, httpRetCode: %d, count: %d\n", res, httpRetCode, count + 1);

        if(resMsg[0] != '\0')

        {

            DebugPrintf("Server response: %s\n", resMsg);

        }

        if(CURLE_OK == res)

        {  

            if(httpRetCode == 200)//我们期望的状态码是200，而且HTTP标准也对其它状态码做了一些定义。

            {//200表示成功

                if((pHttpResBody = json_tokener_parse(resMsg))

                    && (pResCode = json_object_object_get(pHttpResBody, K_RESULT_CODE))

                    && (strcasecmp(json_object_get_string(pResCode), V_RC_SUCCESS) == 0))

                {

                    break;

                }

                else

                {

                    FREE_JSON_OBJ(pHttpResBody);

                }

            }

        }

        else

        {

            DebugPrintf("post file err: %d, rc: %d\n", count + 1, res);

        }

        ++count;

    }

   

    curl_easy_cleanup(curl);

    curl_slist_free_all (headerlist); 

    curl_formfree(formpost);

    curl_global_cleanup();

 

附录：

url选项列表进行了详细的分析介绍，需要的朋友参考下  

　　第一类：

对于下面的这些option的可选参数，value应该被设置一个bool类型的值：

选项

可选value值

备注

CURLOPT_AUTOREFERER

当根据Location:重定向时，自动设置header中的Referer:信息。

CURLOPT_BINARYTRANSFER

在启用CURLOPT_RETURNTRANSFER的时候，返回原生的（Raw）输出。

CURLOPT_COOKIESESSION

启用时curl会仅仅传递一个session cookie，忽略其他的cookie，默认状况下cURL会将所有的cookie返回给服务端。session cookie是指那些用来判断服务器端的session是否有效而存在的cookie。

CURLOPT_CRLF

启用时将Unix的换行符转换成回车换行符。

CURLOPT_DNS_USE_GLOBAL_CACHE

启用时会启用一个全局的DNS缓存，此项为线程安全的，并且默认启用。

CURLOPT_FAILONERROR

显示HTTP状态码，默认行为是忽略编号小于等于400的HTTP信息。

CURLOPT_FILETIME

启用时会尝试修改远程文档中的信息。结果信息会通过 curl_getinfo()函数的CURLINFO_FILETIME选项返回。curl_getinfo().

CURLOPT_FOLLOWLOCATION

启用时会将服务器服务器返回的"Location: "放在header中递归的返回给服务器，使用CURLOPT_MAXREDIRS可以限定递归返回的数量。

CURLOPT_FORBID_REUSE

在完成交互以后强迫断开连接，不能重用。

CURLOPT_FRESH_CONNECT

强制获取一个新的连接，替代缓存中的连接。

CURLOPT_FTP_USE_EPRT

启用时当FTP下载时，使用EPRT (或 LPRT)命令。设置为FALSE时禁用EPRT和LPRT，使用PORT命令 only.

CURLOPT_FTP_USE_EPSV

启用时，在FTP传输过程中回复到PASV模式前首先尝试EPSV命令。设置为FALSE时禁用EPSV命令。

CURLOPT_FTPAPPEND

启用时追加写入文件而不是覆盖它。

CURLOPT_FTPASCII

CURLOPT_TRANSFERTEXT的别名。

CURLOPT_FTPLISTONLY

启用时只列出FTP目录的名字。

CURLOPT_HEADER

启用时会将头文件的信息作为数据流输出。

CURLINFO_HEADER_OUT

启用时追踪句柄的请求字符串。

从 PHP 5.1.3 开始可用。CURLINFO_前缀是故意的(intentional)。

CURLOPT_HTTPGET

启用时会设置HTTP的method为GET，因为GET是默认是，所以只在被修改的情况下使用。

CURLOPT_HTTPPROXYTUNNEL

启用时会通过HTTP代理来传输。

CURLOPT_MUTE

启用时将cURL函数中所有修改过的参数恢复默认值。

CURLOPT_NETRC

在连接建立以后，访问~/.netrc文件获取用户名和密码信息连接远程站点。

CURLOPT_NOBODY

启用时将不对HTML中的BODY部分进行输出。

CURLOPT_NOPROGRESS

启用时关闭curl传输的进度条，此项的默认设置为启用。

Note:

PHP自动地设置这个选项为TRUE，这个选项仅仅应当在以调试为目的时被改变。

CURLOPT_NOSIGNAL

启用时忽略所有的curl传递给php进行的信号。在SAPI多线程传输时此项被默认启用。

cURL 7.10时被加入。

CURLOPT_POST

启用时会发送一个常规的POST请求，类型为：application/x-www-form-urlencoded，就像表单提交的一样。

CURLOPT_PUT

启用时允许HTTP发送文件，必须同时设置CURLOPT_INFILE和CURLOPT_INFILESIZE。

CURLOPT_RETURNTRANSFER

将 curl_exec()获取的信息以文件流的形式返回，而不是直接输出。

CURLOPT_SSL_VERIFYPEER

禁 用后cURL将终止从服务端进行验证。使用CURLOPT_CAINFO选项设置证书使用CURLOPT_CAPATH选项设置证书目录 如果CURLOPT_SSL_VERIFYPEER(默认值为2)被启用，CURLOPT_SSL_VERIFYHOST需要被设置成TRUE否则设置为 FALSE。

自cURL 7.10开始默认为TRUE。从cURL 7.10开始默认绑定安装。

CURLOPT_TRANSFERTEXT

启用后对FTP传输使用ASCII模式。对于LDAP，它检索纯文本信息而非HTML。在Windows系统上，系统不会把STDOUT设置成binary模式。

CURLOPT_UNRESTRICTED_AUTH

在使用CURLOPT_FOLLOWLOCATION产生的header中的多个locations中持续追加用户名和密码信息，即使域名已发生改变。

CURLOPT_UPLOAD

启用后允许文件上传。

CURLOPT_VERBOSE

启用时会汇报所有的信息，存放在STDERR或指定的CURLOPT_STDERR中。

第二类：

对于下面的这些option的可选参数，value应该被设置一个integer类型的值：

选项

可选value值

备注

CURLOPT_BUFFERSIZE

每次获取的数据中读入缓存的大小，但是不保证这个值每次都会被填满。

在cURL 7.10中被加入。

CURLOPT_CLOSEPOLICY

不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST，还存在另外三个CURLCLOSEPOLICY_，但是cURL暂时还不支持。

CURLOPT_CONNECTTIMEOUT

在发起连接前等待的时间，如果设置为0，则无限等待。

CURLOPT_CONNECTTIMEOUT_MS

尝试连接等待的时间，以毫秒为单位。如果设置为0，则无限等待。

在cURL 7.16.2中被加入。从PHP 5.2.3开始可用。

CURLOPT_DNS_CACHE_TIMEOUT

设置在内存中保存DNS信息的时间，默认为120秒。

CURLOPT_FTPSSLAUTH

FTP验证方式：CURLFTPAUTH_SSL (首先尝试SSL)，CURLFTPAUTH_TLS (首先尝试TLS)或CURLFTPAUTH_DEFAULT (让cURL自动决定)。

在cURL 7.12.2中被加入。

CURLOPT_HTTP_VERSION

CURL_HTTP_VERSION_NONE (默认值，让cURL自己判断使用哪个版本)，CURL_HTTP_VERSION_1_0 (强制使用 HTTP/1.0)或CURL_HTTP_VERSION_1_1 (强制使用 HTTP/1.1)。

CURLOPT_HTTPAUTH

使用的HTTP验证方法，可选的值有：CURLAUTH_BASIC、CURLAUTH_DIGEST、CURLAUTH_GSSNEGOTIATE、CURLAUTH_NTLM、CURLAUTH_ANY和CURLAUTH_ANYSAFE。

可以使用|位域(或)操作符分隔多个值，cURL让服务器选择一个支持最好的值。

CURLAUTH_ANY等价于CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.

CURLAUTH_ANYSAFE等价于CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.

CURLOPT_INFILESIZE

设定上传文件的大小限制，字节(byte)为单位。

CURLOPT_LOW_SPEED_LIMIT

当传输速度小于CURLOPT_LOW_SPEED_LIMIT时(bytes/sec)，PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输。

CURLOPT_LOW_SPEED_TIME

当传输速度小于CURLOPT_LOW_SPEED_LIMIT时(bytes/sec)，PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输。

CURLOPT_MAXCONNECTS

允许的最大连接数量，超过是会通过CURLOPT_CLOSEPOLICY决定应该停止哪些连接。

CURLOPT_MAXREDIRS

指定最多的HTTP重定向的数量，这个选项是和CURLOPT_FOLLOWLOCATION一起使用的。

CURLOPT_PORT

用来指定连接端口。（可选项）

CURLOPT_PROTOCOLS

CURLPROTO_* 的位域指。如果被启用，位域值会限定libcurl在传输过程中有哪些可使用的协议。这将允许你在编译libcurl时支持众多协议，但是限制只是用它们 中被允许使用的一个子集。默认libcurl将会使用全部它支持的协议。参见CURLOPT_REDIR_PROTOCOLS.

可用的协议选项 为：CURLPROTO_HTTP、CURLPROTO_HTTPS、CURLPROTO_FTP、CURLPROTO_FTPS、 CURLPROTO_SCP、CURLPROTO_SFTP、CURLPROTO_TELNET、CURLPROTO_LDAP、 CURLPROTO_LDAPS、CURLPROTO_DICT、CURLPROTO_FILE、CURLPROTO_TFTP、 CURLPROTO_ALL

在cURL 7.19.4中被加入。

CURLOPT_PROXYAUTH

HTTP代理连接的验证方式。使用在CURLOPT_HTTPAUTH中的位域标志来设置相应选项。对于代理验证只有CURLAUTH_BASIC和CURLAUTH_NTLM当前被支持。

在cURL 7.10.7中被加入。

CURLOPT_PROXYPORT

代理服务器的端口。端口也可以在CURLOPT_PROXY中进行设置。

CURLOPT_PROXYTYPE

不是CURLPROXY_HTTP (默认值) 就是CURLPROXY_SOCKS5。

在cURL 7.10中被加入。

CURLOPT_REDIR_PROTOCOLS

CURLPROTO_* 中的位域值。如果被启用，位域值将会限制传输线程在CURLOPT_FOLLOWLOCATION开启时跟随某个重定向时可使用的协议。这将使你对重定向 时限制传输线程使用被允许的协议子集默认libcurl将会允许除FILE和SCP之外的全部协议。这个和7.19.4预发布版本种无条件地跟随所有支持 的协议有一些不同。关于协议常量，请参照CURLOPT_PROTOCOLS。

在cURL 7.19.4中被加入。

CURLOPT_RESUME_FROM

在恢复传输时传递一个字节偏移量（用来断点续传）。

CURLOPT_SSL_VERIFYHOST

1 检查服务器SSL证书中是否存在一个公用名(common name)。译者注：公用名(Common Name)一般来讲就是填写你将要申请SSL证书的域名 (domain)或子域名(sub domain)。2 检查公用名是否存在，并且是否与提供的主机名匹配。

CURLOPT_SSLVERSION

使用的SSL版本(2 或 3)。默认情况下PHP会自己检测这个值，尽管有些情况下需要手动地进行设置。

CURLOPT_TIMECONDITION

如 果在CURLOPT_TIMEVALUE指定的某个时间以后被编辑过，则使用CURL_TIMECOND_IFMODSINCE返回页面，如果没有被修改 过，并且CURLOPT_HEADER为true，则返回一个"304 Not Modified"的header， CURLOPT_HEADER为false，则使用CURL_TIMECOND_IFUNMODSINCE，默认值为 CURL_TIMECOND_IFUNMODSINCE。

CURLOPT_TIMEOUT

设置cURL允许执行的最长秒数。

CURLOPT_TIMEOUT_MS

设置cURL允许执行的最长毫秒数。

在cURL 7.16.2中被加入。从PHP 5.2.3起可使用。

CURLOPT_TIMEVALUE

设置一个CURLOPT_TIMECONDITION使用的时间戳，在默认状态下使用的是CURL_TIMECOND_IFMODSINCE。

第三类：

对于下面的这些option的可选参数，value应该被设置一个string类型的值：

选项

可选value值

备注

CURLOPT_CAINFO

一个保存着1个或多个用来让服务端验证的证书的文件名。这个参数仅仅在和CURLOPT_SSL_VERIFYPEER一起使用时才有意义。 .

CURLOPT_CAPATH

一个保存着多个CA证书的目录。这个选项是和CURLOPT_SSL_VERIFYPEER一起使用的。

CURLOPT_COOKIE

设定HTTP请求中"Cookie: "部分的内容。多个cookie用分号分隔，分号后带一个空格(例如， "fruit=apple; colour=red")。

CURLOPT_COOKIEFILE

包含cookie数据的文件名，cookie文件的格式可以是Netscape格式，或者只是纯HTTP头部信息存入文件。

CURLOPT_COOKIEJAR

连接结束后保存cookie信息的文件。

CURLOPT_CUSTOMREQUEST

使 用一个自定义的请求信息来代替"GET"或"HEAD"作为HTTP请求。这对于执行"DELETE" 或者其他更隐蔽的HTTP请求。有效值如"GET"，"POST"，"CONNECT"等等。也就是说，不要在这里输入整个HTTP请求。例如输 入"GET /index.html HTTP/1.0rnrn"是不正确的。

Note:

在确定服务器支持这个自定义请求的方法前不要使用。

CURLOPT_EGDSOCKET

类似CURLOPT_RANDOM_FILE，除了一个Entropy Gathering Daemon套接字。

CURLOPT_ENCODING

HTTP请求头中"Accept-Encoding: "的值。支持的编码有"identity"，"deflate"和"gzip"。如果为空字符串""，请求头会发送所有支持的编码类型。

在cURL 7.10中被加入。

CURLOPT_FTPPORT

这个值将被用来获取供FTP"POST"指令所需要的IP地址。"POST"指令告诉远程服务器连接到我们指定的IP地址。这个字符串可以是纯文本的IP地址、主机名、一个网络接口名（UNIX下）或者只是一个'-'来使用默认的IP地址。

CURLOPT_INTERFACE

网络发送接口名，可以是一个接口名、IP地址或者是一个主机名。

CURLOPT_KRB4LEVEL

KRB4 (Kerberos 4) 安全级别。下面的任何值都是有效的(从低到高的顺序)："clear"、"safe"、"confidential"、"private".。如果字符串 和这些都不匹配，将使用"private"。这个选项设置为NULL时将禁用KRB4 安全认证。目前KRB4 安全认证只能用于FTP传输。

CURLOPT_POSTFIELDS

全 部数据使用HTTP协议中的"POST"操作来发送。要发送文件，在文件名前面加上@前缀并使用完整路径。这个参数可以通过urlencoded后的字符 串类似'para1=val1¶2=val2&...'或使用一个以字段名为键值，字段数据为值的数组。如果value是一个数 组，Content-Type头将会被设置成multipart/form-data。

CURLOPT_PROXY

HTTP代理通道。

CURLOPT_PROXYUSERPWD

一个用来连接到代理的"[username]:[password]"格式的字符串。

CURLOPT_RANDOM_FILE

一个被用来生成SSL随机数种子的文件名。

CURLOPT_RANGE

以"X-Y"的形式，其中X和Y都是可选项获取数据的范围，以字节计。HTTP传输线程也支持几个这样的重复项中间用逗号分隔如"X-Y,N-M"。

CURLOPT_REFERER

在HTTP请求头中"Referer: "的内容。

CURLOPT_SSL_CIPHER_LIST

一个SSL的加密算法列表。例如RC4-SHA和TLSv1都是可用的加密列表。

CURLOPT_SSLCERT

一个包含PEM格式证书的文件名。

CURLOPT_SSLCERTPASSWD

使用CURLOPT_SSLCERT证书需要的密码。

CURLOPT_SSLCERTTYPE

证书的类型。支持的格式有"PEM" (默认值), "DER"和"ENG"。

在cURL 7.9.3中被加入。

CURLOPT_SSLENGINE

用来在CURLOPT_SSLKEY中指定的SSL私钥的加密引擎变量。

CURLOPT_SSLENGINE_DEFAULT

用来做非对称加密操作的变量。

CURLOPT_SSLKEY

包含SSL私钥的文件名。

CURLOPT_SSLKEYPASSWD

在CURLOPT_SSLKEY中指定了的SSL私钥的密码。

Note:

由于这个选项包含了敏感的密码信息，记得保证这个PHP脚本的安全。

CURLOPT_SSLKEYTYPE

CURLOPT_SSLKEY中规定的私钥的加密类型，支持的密钥类型为"PEM"(默认值)、"DER"和"ENG"。

CURLOPT_URL

需要获取的URL地址，也可以在 curl_init()函数中设置。

CURLOPT_USERAGENT

在HTTP请求中包含一个"User-Agent: "头的字符串。

CURLOPT_USERPWD

传递一个连接中需要的用户名和密码，格式为："[username]:[password]"。

第四类

对于下面的这些option的可选参数，value应该被设置一个数组：

选项

可选value值

备注

CURLOPT_HTTP200ALIASES

200响应码数组，数组中的响应吗被认为是正确的响应，否则被认为是错误的。

在cURL 7.10.3中被加入。

CURLOPT_HTTPHEADER

一个用来设置HTTP头字段的数组。使用如下的形式的数组进行设置： array('Content-type: text/plain', 'Content-length: 100')

CURLOPT_POSTQUOTE

在FTP请求执行完成后，在服务器上执行的一组FTP命令。

CURLOPT_QUOTE

一组先于FTP请求的在服务器上执行的FTP命令。

　　对于下面的这些option的可选参数，value应该被设置一个流资源 （例如使用 fopen()）：

选项 

可选value值

CURLOPT_FILE

设置输出文件的位置，值是一个资源类型，默认为STDOUT (浏览器)。

CURLOPT_INFILE

在上传文件的时候需要读取的文件地址，值是一个资源类型。

CURLOPT_STDERR

设置一个错误输出地址，值是一个资源类型，取代默认的STDERR。

CURLOPT_WRITEHEADER

设置header部分内容的写入的文件地址，值是一个资源类型。

对于下面的这些option的可选参数，value应该被设置为一个回调函数名：

选项

可选value值

CURLOPT_HEADERFUNCTION

设置一个回调函数，这个函数有两个参数，第一个是cURL的资源句柄，第二个是输出的header数据。header数据的输出必须依赖这个函数，返回已写入的数据大小。

CURLOPT_PASSWDFUNCTION

设置一个回调函数，有三个参数，第一个是cURL的资源句柄，第二个是一个密码提示符，第三个参数是密码长度允许的最大值。返回密码的值。

CURLOPT_PROGRESSFUNCTION

设置一个回调函数，有三个参数，第一个是cURL的资源句柄，第二个是一个文件描述符资源，第三个是长度。返回包含的数据。

CURLOPT_READFUNCTION

拥有两个参数的回调函数，第一个是参数是会话句柄，第二是HTTP响应头信息的字符串。使用此函数，将自行处理返回的数据。返回值为数据大小，以字节计。返回0代表EOF信号。

CURLOPT_WRITEFUNCTION

拥有两个参数的回调函数，第一个是参数是会话句柄，第二是HTTP响应头信息的字符串。使用此回调函数，将自行处理响应头信息。响应头信息是整个字符串。设置返回值为精确的已写入字符串长度。发生错误时传输线程终止。