Linux下使用libcurl实现FTP单个文件上传下载功能

1.前言

1.1声明

文章中的文字可能存在语法错语以及标点错误，请谅解；

如果在文章中发现代码错误或其它问题请告知，感谢！

2.关于libcurl

2.1简介

libcurl是一个提供数据传输功能的函数库，主要功能就是通过其使用不同的协议连接不同类型的服务器。当前libcurl支持的协议主要有http, https, ftp, gopher, telnet, dict, file, 和ldap等协议和各种SSL安全认证。
在基于libcurl的程序里，使用libcurl提供的库函数完成特定任务。开发者在启动传输任务之前写好回调函数以及设置各类参数，当满足条件时，libcurl调用回调函数实现功能任务。
当然，官网上有其详细的介绍：
https://curl.haxx.se/libcurl/features.html

2.2libcurl功能实现逻辑

一般情况下，libcurl的实现逻辑如下：

2.3主要函数

1.CURLcode curl_global_init(long falgs);
该函数在程序中只能够使用一次，若这个函数在curl_easy_init函数调用时还没调用，它讲由libcurl库自动完成。该函数需要用到的参数如下：
　　CURL_GLOBAL_ALL：初始化所有可能的调用

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

　　CURL_GLOBAL_WIN32：初始化WIN32套接字库

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

2.CURL* curl_easy_init();
用来初始化一个curl指针。在该指针调用结束后需要使用curl_easy_cleanup函数清理。
通常来说当使用curl_easy_init()产生一个curl指针后，基本上只会被curl库中easy系列函数中调用，可以参见下例理解。

3.CURLcode curl_easy_setopt(CURL* handle,CURLoption option,parameter);
用来告诉curl库程序需要该库做何等行为。CURL* handle为操作符，CURLoption option代表各类选项，option parameter 这个参数既可以是个函数的指针,也可以是某个对象的指针,也可以是个long型的变量.它用什么这取决于第二个参数.。

4.CURLcode curl_easy_perform(CURL* handle);
设置好curl_easy_setopt工作方式后，调用该函数开始运行会话。CURL* handle为操作符。

5.void curl_easy_cleanup(CURL*handle);
用来结束一个libcurl会话，与curl_easy_init配合使用。CURL* handle为操作符。

6.void curl_global_cleanup(void);
用该函数结束所有有关libcurl使用，类似于close（）的函数。

要是对libcur库中所有函数进行一个详细的了解，可以参考libcurl官网：
https://curl.haxx.se/libcurl/c/

3.FTP功能实现

3.1linux下编译安装libcurl

1.首先在终端中输入指令：git clone https://github.com/curl/curl.git ，下载libcurl源码：

2.tar解压后，进入curl工程目录输入指令：./buidconf，产生configure脚本：

注意：在输入指令后可能会出现“buildconf: autoconf not found.”错误，此时输入指令：apt-get install autoconf安装必要的文件，然后再次输入./buidconf指令即可。
3.输入指令： ./configure –enable-debug 执行configure脚本：

4.输入指令：make

5.输入指令：make install，完成安装

3.2代码实现

我在win10上搭建了一个FTP服务器作为测试用，搭建步骤可以参考网上例程，该服务器网址在搭建的时候设置为：ftp://192.168.1.116/ ，里面预先传送了几个文件，下面的FTP上传下载功能将在这个FTP服务器进行。

接着将Linux主机和FTP服务器连接到同一个局域网，然后互ping一下检查是否能够互相通信成功。

3.2.1FTP上传

该FTP上传代码为官网上的demo例程代码，若要为己所用，只需将宏定义修改并准备一个要上传的文件即可。当然，该函数只能上传一个文件至FTP服务器，若要上传多个文件，可以在此例程上进行修改。

#include 
#include 

#include 
#include 
#include 
#include 
#include 
#ifdef WIN32
#include 
#else
#include 
#endif

#define LOCAL_FILE      "/home/dlri/Desktop/uploadthis.txt" //要上传的文件
#define UPLOAD_FILE_AS  "while-uploading.txt"
#define REMOTE_URL      "ftp://192.168.1.116/"  UPLOAD_FILE_AS //FTP服务器地址
#define RENAME_FILE_TO  "renamed-and-fine.txt"

static size_t read_callback(void *ptr, size_t size, size_t nmemb, void *stream)
{
  curl_off_t nread;

  size_t retcode = fread(ptr, size, nmemb, stream);

  nread = (curl_off_t)retcode;

  fprintf(stderr, " We read %" CURL_FORMAT_CURL_OFF_T
          " bytes from file\n", nread);
  return retcode;
}

int main(void)
{
  CURL *curl;
  CURLcode res;
  FILE *hd_src;
  struct stat file_info;
  curl_off_t fsize;

  struct curl_slist *headerlist = NULL;
  static const char buf_1 [] = "RNFR " UPLOAD_FILE_AS;
  static const char buf_2 [] = "RNTO " RENAME_FILE_TO;

  /* 获得上传文件的大小 */ 
  if(stat(LOCAL_FILE, &file_info)) {
    printf("Couldn't open '%s': %s\n", LOCAL_FILE, strerror(errno));
    return 1;
  }
  fsize = (curl_off_t)file_info.st_size;

  printf("Local file size: %" CURL_FORMAT_CURL_OFF_T " bytes.\n", fsize);

  /* 获得FILE类型变量 */ 
  hd_src = fopen(LOCAL_FILE, "rb");

  /* 初始化 */ 
  curl_global_init(CURL_GLOBAL_ALL);

  /* 获得curl操作符 */ 
  curl = curl_easy_init();
  if(curl) {
    /*建立一个传递给libcurl的命令列表 */ 
    headerlist = curl_slist_append(headerlist, buf_1);
    headerlist = curl_slist_append(headerlist, buf_2);

    /* 使用curl提供的Read功能 */ 
    curl_easy_setopt(curl, CURLOPT_READFUNCTION, read_callback);

    /* 上传使能 */ 
    curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);

    /* 设置特定目标 */ 
    curl_easy_setopt(curl, CURLOPT_URL, REMOTE_URL);

    /* 传递最后一个FTP命令以在传输后运行 */ 
    curl_easy_setopt(curl, CURLOPT_POSTQUOTE, headerlist);

    /*指定上传文件 */ 
    curl_easy_setopt(curl, CURLOPT_READDATA, hd_src);

    /*设置要上传的文件的大小（可选） */ 
    curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE,
                     (curl_off_t)fsize);

    /* 运行 */ 
    res = curl_easy_perform(curl);
    /* 容错处理 */ 
    if(res != CURLE_OK)
      fprintf(stderr, "curl_easy_perform() failed: %s\n",
              curl_easy_strerror(res));

    /* 清除FTP命令列表 */ 
    curl_slist_free_all(headerlist);

    /*释放所有curl资源 */ 
    curl_easy_cleanup(curl);
  }
  fclose(hd_src); /*关闭本地文件 */ 

  /*释放所有curl资源 */ 
  curl_global_cleanup();
  return 0;
}

保存代码，文件名命名为“ftptest.c”，并在/home/dlri/Desktop文件夹中准备“uploadthis.txt”文件（即代码中指定的要上传的文件名），使用gcc编译，编译指令：gcc -o ftptest ftptest.c -lcurl

编译成功后，运行：

此时查看FTP服务器：

打开文件，对比Linux中的“uploadthis.txt”文件：


上传功能完成。

3.2.2FTP下载

同样，该FTP下载代码为官网上的demo例程代码，若要为己所用，只需将宏定义修改并指定一个要下载的文件即可。当然，该函数只能下载一个文件至FTP客户端，若要下载多个文件，可以在此例程上进行修改。

#include 

#include 

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

static size_t my_fwrite(void *buffer, size_t size, size_t nmemb, void *stream)
{
  struct FtpFile *out = (struct FtpFile *)stream;
  if(out && !out->stream) {
    /* 打开文件以进行写操作 */ 
    out->stream = fopen(out->filename, "wb");
    if(!out->stream)
      return -1; /* failure, can't open file to write */ 
  }
  return fwrite(buffer, size, nmemb, out->stream);
}


int main(void)
{
  CURL *curl;
  CURLcode res;
  struct FtpFile ftpfile = {
    "curl.txt", /* 若FTP下载成功，名命下载后的文件为"curl.txt" */ 
    NULL
  };

  curl_global_init(CURL_GLOBAL_DEFAULT);

  curl = curl_easy_init();
  if(curl) {
    curl_easy_setopt(curl, CURLOPT_URL,
                     "ftp://192.168.1.116/a.txt");//下载指定的文件
    /* 定义回调函数，以便在需要写入数据时进行调用 */ 
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, my_fwrite);
    /*设置一个指向我们的结构的指针传递给回调函数*/ 
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &ftpfile);

    /* 打开完整的协议/调试输出*/ 
    curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);

    res = curl_easy_perform(curl);

    /* 释放所有curl资源*/ 
    curl_easy_cleanup(curl);

    if(CURLE_OK != res) {
      /*容错处理 */ 
      fprintf(stderr, "curl told us %d\n", res);
    }
  }

  if(ftpfile.stream)
    fclose(ftpfile.stream); /* 关闭本地文件 */ 
 /*释放所有curl资源*/
  curl_global_cleanup();

  return 0;
}

使用gcc编译，编译指令：gcc -o ftpDown ftpDown.c -lcurl

编译成功后，运行：

对比下载的文件和FTP上的文件：

以上。

参考文档：
1.https://blog.csdn.net/sever2012/article/details/7076248
2.https://curl.haxx.se/libcurl/c/ftpupload.html
3.https://curl.haxx.se/libcurl/c/ftpget.html
4.http://www.360doc.com/content/16/0616/11/33377968_568201213.shtml
5.https://jingyan.baidu.com/article/91f5db1b1922ba1c7e05e350.html
6.https://blog.csdn.net/wangqing_12345/article/details/52233067
7.https://baike.baidu.com/item/libcurl/5256898?fr=aladdin