libcurl easy接口使用说明

使用libcurl

cURL的easy接口是一个简单的同步API，能控制数据移动过程（使用回调）

示例：

#include 
#include "curl/curl.h"

struct TransFile {
    const char *filename;
    FILE *stream;
};

size_t write_data( void *buffer, size_t size, size_t nmemb, void *stream);

int main()
{
    CURL *curl;
    CURLcode ret;
    struct TransFile transfile = {
        "example.pdf",
        NULL
    };

    curl_global_init(CURL_GLOBAL_DEFAULT);

    curl = curl_easy_init();//初始化一个curl指针
    if (!curl) {
        printf("couldn't init curl\n");
        return 0;
    }

    //设置要下载的文件的URL
    curl_easy_setopt(curl,CURLOPT_URL,"http://www.mysite.com/example.pdf");
    
    /*执行写入文件流操作*/
    curl_easy_setopt( curl, CURLOPT_WRITEFUNCTION, write_data);//调用回调函数
    curl_easy_setopt( curl,CURLOPT_WRITEDATA, &transfile);//传入回调函数需要的结构体的指针

    curl_easy_setopt( curl, CURLOPT_VERBOSE, 1L);
    curl_easy_setopt( curl, CURLOPT_USERPWD, "SUREN:SUREN");

    //写入文件
    ret = curl_easy_perform(curl);

    //释放curl对象
    curl_easy_cleanup(curl);

    if(ret != CURLE_OK) {
        fprintf(stderr,"%d",ret);
    }

    //关闭文件流
    if(transfile.stream) {
        fclose(transfile.stream);
    }

    //释放全局curl对象
    curl_global_cleanup();

    return 0;
}

size_t write_data( void *buffer, size_t size, size_t nmemb, void *stream)
{
    struct TransFile *out = (struct TransFile *)stream;
    printf("2.1\n");
    if(out && (!out->stream)) {
        printf("2.2\n");
        out->stream = fopen(out->filename, "wb");
        printf("2.3\n");
        if(!out -> stream) {
            printf("fopen failed!\n");
            return -1;
        }
    }

    return fwrite(buffer,size,nmemb,out->stream);
}

编译上面的程序，通过它下载文件（当然你需要修改程序中的url）来和通过浏览器下载直接对比，结果见https://www.jianshu.com/p/50a620d08bc9

接口说明

这些接口通过手册之类的都可以查到详细信息

curl_easy_init()

创建一个简单的句柄。

curl_easy_setopt()

为句柄设置属性和选项，控制即将进行的转移和转移方式。例如：curl_easy_setopt(curl,option,value);

属性说明：

属性说明：

• CURLOPT_URL：提供请求中使用的URL

• CURLOPT_TIMEOUT：设置允许libcurl传输操作花费的最大时间

  curl_easy_setopt(curl, CURLOPT_TIMEOUT, 20L);
  

• CURLOPT_HTTP_VERSION：设置HTTP协议版本，value可选：

  • CURL_HTTP_VERSION_NONE
  • CURL_HTTP_VERSION_1_0
  • CURL_HTTP_VERSION_1_1
  • CURL_HTTP_VERSION_2_0
  • CURL_HTTP_VERSION_2TLS
  • CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE

• CURLOPT_CONNECTTIMEOUT：

• CURLOPT_NOPROGRESS：关闭程序meter

  curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 0L);
  

• CURLOPT_NOBODY：发送不带body的请求

  curl_easy_setopt（curl，CURLOPT_NOBODY，1L）;
  

• CURLOPT_HEADERFUNCTION：使用回调函数

  当收到头信息的时，调用回调函数

  static size_t header_callback(char *buffer, size_t size,
                                size_t nitems, void *userdata)
  {
    /* received header is nitems * size long in 'buffer' NOT ZERO TERMINATED */
    /* 'userdata' is set with CURLOPT_HEADERDATA */
    return nitems * size;
  }
   
  CURL *curl = curl_easy_init();
  if(curl) {
    curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
   
    curl_easy_setopt(curl, CURLOPT_HEADERFUNCTION, header_callback);
   
    curl_easy_perform(curl);
  }
  

• CURLOPT_WRITEHEADER

• CURLOPT_WRITEDATA：传递给写回调的自定义指针

  如果已经设置了CURLOPT_WRITEFUNCTION选项，该指针就是传递给写回调的第4个参数

• CURLOPT_URL

curl_easy_cleanup()