Linux之Libcurl库的牵线及运20170509

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

  1. CURLOPT_WRITEFUNCTION,CURLOPT_WRITEDATA

扭动调函数原型为:size_t function( void *ptr, size_t size, size_t
nmemb, void *stream);
函数将于libcurl接收及数后为调用,因此函数多举行多少保存之功能,如处理下载文件。CURLOPT_WRITEDATA
用于表明CURLOPT_WRITEFUNCTION函数中之stream指针的来自。

  1. 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指针的来。

  1. 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指针来源。

  1. CURLOPT_NOPROGRESS,CURLOPT_PROGRESSFUNCTION,CURLOPT_PROGRESSDATA

及数据传速度相关的参数。CURLOPT_PROGRESSFUNCTION
指定的函数正常情形下各秒为libcurl调用平等不行,为了要CURLOPT_PROGRESSFUNCTION被调用,CURLOPT_NOPROGRESS必须为装也false,CURLOPT_PROGRESSDATA指定的参数将当CURLOPT_PROGRESSFUNCTION指定函数的首先独参数

  1. CURLOPT_TIMEOUT,CURLOPT_CONNECTIONTIMEOUT:

CURLOPT_TIMEOUT 由于设置导时间,CURLOPT_CONNECTIONTIMEOUT
设置连接等时

  1. 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,指定你指望开始传递的

偏移量。

  1. //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响应头信息之字符串。使用这个回调函数,将自行处理响应头信息。响应头信息是通字符串。设置返回值为规范的既写副字符串长度。发生错误时传输线程终止。

 

相关文章