libcurl简单接口的使用

来源:互联网 发布:js股票实时数据获取 编辑:程序博客网 时间:2024/05/22 10:51

一. 文件传输协议(File Transfer Protocol)是进行文件传输的一套标准协议,属于TCP/IP协议的一部分。FTP服务一般在20和21两个端口。其中20用于数据连接,21用于控制连接。FTP有两种使用模式:主动模式和被动模式。主动模式安全性高,要求服务端和客户端各打开一个端口并监听以建立连接,但客户端的防火墙可能阻碍主动模式,因此创建了被动模式。被动模式由客户端向服务端发出需要监听的端口,由服务端在该端口监听等待连接。

二. libcurl是一个为网络客户端提供数据传输功能的函数库,支持HTTP,HTTPS,FTP,TELNET等协议和各种SSL安全认证。

 libcurl是开源项目,可以在其官网下载:http://curl.haxx.se/libcurl/

三. 基于libcurl的程序里主要用回调函数形式完全成任务,用户在启动传输前先设好各类参数和回调函数,当条件满足时libcurl再调用用户的回调实现特定功能。libcurl工作模式主要有两种:简单接口和多线程接口。简单接口可以实现同步、快速的文件传输;多线程接口则可生成多个连接线程以异步方式进行文件传输。

四. 使用简单接口的工作流程

五. 主要函数

1. CURLcode curl_global_init(long flags);

这个函数只能使用一次,如果在程序中没有显式调用,第一次调用curl_easy_init()时会自动调用它。因此在多线程接口中,要在主函数中显式调用。参数flags用于指定初始化状态,可选范围:

  CURL_GLOBAL_ALL:初始化所有可能的调用

  CURL_GLOBAL_SSL:初始化支持安全套接字的调用

  CURL_GLOBAL_WIN32:初始化WIN32套接字库

  CURL_GLOBAL_NOTHING:没有额外的初始化要求

结束libcurl调用时,可使用curl_global_init()清理内存

2. CURL *curl_easy_init();

获得一个CURL操作符,类似文件操作中FILE *fp = fopen(...)

3. void curl_easy_cleanup(CURL *handle);

CRUL操作符使用完后,使用它进行内存清理

4. CURL curl_easy_setopt(CURL *handle, CURLoption, parameter);

进行数据传输前必须告诉libcurl如何工作,使用这个函数指定工作方式。CURLoption有大量的可选值,不同可选值的参数也不相同。下一节专门说这个。

5. CURLcode curl_easy_perform(CURL *handle);

设好工作方式后,调用该函数执行相关操作

六. 一个例子

int ftp_log(CURL *curl, curl_infotype type, char *str, size_t size, void* stream){    //打印CURLINFO_TEXT信息    if ( CURLINFO_TEXT == type )    {        fwrite(str, 1, size, (FILE *)stream);    }}int main(void){    CURL        *curl;    CURLcode     res;    char         error_buff[CURL_ERROR_SIZE];    FILE         *resource_file_fp, *log_file_fp;   char        user_name[255] = "xxxx";    char        password[255] = "xxxx";    char         log_file_name[255] = "ftp.log";        char        file_name[255] = "/home/ls/hello.txt";    //源文件路径    char        ftp_url[1024] = "ftp://192.168.0.169//home/zyh/test.txt";    struct curl_slist     *slist = NULL;    //打开日志文件    if (NULL == (log_file_fp = fopen(log_file_name, "a+")) )    {        return -1;    }    //打开源文件    if (NULL == (resource_file_fp = fopen(file_name, "r")) )    {        fclose(log_file_fp);        return -1;    }    //获取源文件大小    fseek(resource_file_fp, 0, SEEK_END);    gint resource_file_size = ftell(resource_file_fp);    if (resource_file_size < 0)    {        fclose(log_file_fp);        fclose(resource_file_fp);        return -1;    }    fseek(resource_file_fp, 0, SEEK_SET);    //初始化libcurl    if ( (res = curl_global_init(CURL_GLOBAL_ALL)) != 0 )    {        fclose(log_file_fp);        fclose(resource_file_fp);        return -1;    }    //创建libcurl标识符    if((curl = curl_easy_init()) == NULL)    {        fclose(log_file_fp);        fclose(resource_file_fp);        curl_global_cleanup();        return -1;    }    snprintf(login_str, 255, "%s:%s", user_name,password);    //设置各类选项    curl_easy_setopt(curl, CURLOPT_URL, ftp_url);    curl_easy_setopt(curl, CURLOPT_USERPWD, login_str);    curl_easy_setopt(curl, CURLOPT_VERBOSE, 1);    curl_easy_setopt(curl, CURLOPT_DEBUGDATA, log_file_fp);    curl_easy_setopt(curl, CURLOPT_READDATA, resource_file_fp); //没有专门写读源文件回调函数,CURLOPT_READDATA会自动读取    curl_easy_setopt(curl, CURLOPT_UPLOAD, 1);    curl_easy_setopt(curl, CURLOPT_INFILESIZE, resource_file_size);    curl_easy_setopt(curl, CURLOPT_FTP_CREATE_MISSING_DIRS, 1);    curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, ftp_log);    //curl运行    res = curl_easy_perform(curl);    if (0 != res)    {        printf("res: %d \n", res);        fclose(resource_file_fp);        fclose(log_file_fp)        curl_easy_cleanup(curl);        curl_global_cleanup();        return -1;    }    curl_easy_cleanup(curl);    fclose(resource_file_fp);    fclose(log_file_fp);    curl_global_cleanup();    return 0;}


0 0