libcurl中curl_easy_setopt()和curl_easy_perform()函数使用中文详解

我会带着你远行 2022-09-23 15:00 186阅读 0赞

原：http://blog.sina.com.cn/s/blog\_7e0127220100zfbf.html

libcurl里主要用到的函数有curl\_easy\_init(),curl\_easy\_setopt()和curl\_easy\_perform().

顾名思义，curl\_easy\_init()是用来初始化libcurl库的（不知道对不对，就这么理解吧），  
curl\_easy\_setopt()是用来设置各种curl参数的，setopt就是set option，  
curl\_easy\_perform()是用来执行curl的各种操作的，并且通过分析其返回值，可以判断curl执行的情况。  
1）curl\_easy\_setopt函数介绍

本节主要介绍curl\_easy\_setopt中跟http相关的参数。注意本节的阐述都是以libcurl作为主体，其它为客体来阐述的。  
1.CURLOPT\_URL  
设置访问URL  
2.CURLOPT\_WRITEFUNCTION，CURLOPT\_WRITEDATA  
通过设定一个回调函数，执行libcurl在接受到数据后用户想进行的操作，通常函数多做数据保存的功能，如处理下载文件。CURLOPT\_WRITEDATA 用于表明CURLOPT\_WRITEFUNCTION函数中的stream指针的来源，说白了就是设定回调函数的第四个参数的数据类型。回调函数原型为：size\_t function( void \*ptr, size\_t size, size\_t nmemb, void \*stream);  
3.CURLOPT\_HEADERFUNCTION，CURLOPT\_HEADERDATA  
通过设定一个回调函数，执行libcurl在接受到http头数据后用户想进行的操作。CURLOPT\_WRITEDATA 传递指针给libcurl，该指针表明CURLOPT\_HEADERFUNCTION 函数的stream指针的来源。回调函数原型为 size\_t function( void \*ptr, size\_t size,size\_t nmemb, void \*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\_UPLOAD：  
如果第三个参数被设置为1的话，就是让libcurl做好上传的准备。如果传输协议是http的话，uoload就是发送put。  
9. CURLOPT\_SSL\_VERIFYPEER:  
第三个参数的缺省值为1.该函数多用于设定curl忽略对网站证书的检查（不管忽略不忽略，curl都是检查的）。  
10.CURLOPT\_VERBOSE  
相当厉害的一个参数，可以向控制台（默认）输出curl接受和发送的数据，输出流可以重定向。  
11.CURLOPT\_HTTPGET  
将curl向服务器交互数据的方式改变为get

2）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  
读本地文件错误

3）curl\_easy\_getinfo函数说明

1.CURLINFO\_RESPONSE\_CODE  
获得http返回的状态码，如400，200