本文主要是介绍libcurl简单接口的使用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
一. 文件传输协议(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);//初始化libcurlif ( (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;
}
这篇关于libcurl简单接口的使用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!