Linux下C语言调用libcurl库下载文件到本地

一、项目介绍

当前文章介绍如何使用C语言调用libcurl库在Linux（Ubuntu）操作系统下实现网络文件下载功能。

libcurl是一个开源的跨平台网络传输库，用于在C和C++等编程语言中实现各种网络通信协议的客户端功能。它支持多种协议，包括HTTP、HTTPS、FTP、SMTP、POP3等，可以方便地进行数据的上传和下载操作。

以下是libcurl库的一些主要特点和功能：

1. 跨平台性：libcurl库可以在多个操作系统上使用，包括Windows、Linux、macOS等。这使得开发者可以轻松地编写跨平台的网络应用程序。
2. 多协议支持：libcurl支持多种网络协议，包括HTTP、HTTPS、FTP、SMTP、POP3等。它提供了丰富的API，使得开发者可以通过简单的接口调用来实现与远程服务器之间的通信。
3. 断点续传：libcurl支持断点续传功能，即可以从已经下载的位置继续下载文件。这对于大文件的下载非常有用，可以节省带宽和时间，并避免重新下载整个文件。
4. SSL/TLS支持：libcurl可以通过OpenSSL或其他TLS/SSL库来进行安全传输。它支持HTTPS协议，并提供了SSL证书验证、加密和解密等功能，以确保数据的安全性。
5. 异步和多线程支持：libcurl提供了异步和多线程操作的支持，可以在网络传输过程中进行其他任务处理，提高程序的并发性和性能。
6. 适应性和灵活性：libcurl库提供了丰富的选项和回调函数，允许开发者根据自己的需求进行定制和扩展。开发者可以配置代理服务器、设置超时时间、自定义HTTP头部等。
7. 良好的错误处理和调试支持：libcurl提供了详细的错误代码和错误信息，方便开发者进行错误处理和故障排除。它还提供了调试输出功能，可打印详细的网络通信和传输信息。
8. 并发连接管理：libcurl支持并发连接管理，可以同时处理多个网络请求。这对于高并发的网络应用非常有用，可以提高系统的吞吐量和性能。

二、环境准备

libcurl库： 可以通过在终端中运行以下命令进行安装：

sudo apt-get install libcurl4-openssl-dev

GitHub仓库：github.com/curl/curl libcurl官网： curl.se/libcurl/

三、设计步骤

3.1 引入头文件

在C代码文件中，需要引入curl/curl.h头文件，以便使用libcurl库提供的函数和结构体。

#include <stdio.h>
#include <curl/curl.h>

3.2 初始化libcurl

在程序开始之前，需要初始化libcurl库。可以通过调用curl_global_init函数来完成。

curl_global_init(CURL_GLOBAL_DEFAULT);

3.3 设置下载选项

接下来，需要设置下载选项，包括要下载的URL链接、保存到本地的文件路径等。可以使用curl_easy_setopt函数来设置选项。

CURL *curl = curl_easy_init();
if (curl) {
    curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/file.zip");
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);  // fp是文件指针，用于保存下载的数据
}

3.4 执行下载请求

调用curl_easy_perform函数来执行下载请求，并将文件保存到指定路径。在执行过程中，libcurl库会自动处理网络传输和接收文件数据。

CURLcode res = curl_easy_perform(curl);
if (res != CURLE_OK) {
    fprintf(stderr, "下载失败: %s\n", curl_easy_strerror(res));
}

3.5 清理资源

最后，在程序结束时，需要清理libcurl的资源。可以通过调用curl_easy_cleanup函数来完成。

curl_easy_cleanup(curl);

3.6 完整示例代码

下面是一个完整的示例代码，演示如何使用C语言和libcurl库在Linux（Ubuntu）下实现网络文件下载功能：

#include <stdio.h>
#include <curl/curl.h>
​
int main() {
    CURL *curl = curl_easy_init();
    FILE *fp = fopen("downloaded_file.zip", "wb");  //打开一个文件用于保存下载的数据
​
    if (curl && fp) {
        curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/file.zip");
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
​
        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK) {
            fprintf(stderr, "下载失败: %s\n", curl_easy_strerror(res));
        }
​
        fclose(fp);
    } else {
        fprintf(stderr, "初始化失败\n");
    }
​
    curl_easy_cleanup(curl);
    curl_global_cleanup();
​
    return 0;
}

3.7 编译和运行

在终端中，使用以下命令编译示例代码：

gcc -o download_program download_program.c -lcurl

然后，通过运行生成的可执行文件来执行下载程序：

./download_program

四、完整代码

下面是一个封装了网络文件下载功能的子函数：

#include <stdio.h>
#include <curl/curl.h>

// 定义回调函数，用于将下载的数据写入本地文件
size_t write_callback(void *ptr, size_t size, size_t nmemb, void *stream) {
    return fwrite(ptr, size, nmemb, (FILE *)stream);
}

// 子函数，用于下载网络文件到本地
int download_file(const char *url, const char *output_filename) {
    CURL *curl = curl_easy_init();
    FILE *fp = fopen(output_filename, "wb");  // 打开一个文件用于保存下载的数据

    if (curl && fp) {
        // 设置下载选项
        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);

        // 执行下载请求
        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK) {
            fprintf(stderr, "下载失败: %s\n", curl_easy_strerror(res));
            fclose(fp);
            curl_easy_cleanup(curl);
            return -1;
        }

        fclose(fp);
    } else {
        fprintf(stderr, "初始化失败\n");
        if (fp) {
            fclose(fp);
        }
        if (curl) {
            curl_easy_cleanup(curl);
        }
        return -1;
    }

    curl_easy_cleanup(curl);
    return 0;
}

int main() {
    const char *url = "http://example.com/file.zip";
    const char *output_filename = "downloaded_file.zip";

    int ret = download_file(url, output_filename);
    if (ret == 0) {
        printf("文件下载成功！\n");
    } else {
        printf("文件下载失败！\n");
    }

    return 0;
}

在上面的代码中，download_file函数实现了下载网络文件到本地的功能。将要下载的URL链接和保存到本地的文件路径作为函数参数传入。函数内部使用libcurl库设置下载选项，执行下载请求，并将数据写入本地文件。

在main函数中，可以调用download_file函数来实现文件下载。通过判断函数返回值，可以判断文件下载是否成功。

编译和运行代码的步骤与之前提供的步骤相同。通过调用download_file函数实现网络文件下载功能，可以方便地在其他代码中复用该功能，并进行错误处理和扩展。