嵌入式Linux网络编程实战：使用libcurl实现高效网络通信

银河码

已于 2025-03-21 18:18:23 修改

阅读量972

点赞数 21

分类专栏： Linux网络编程文章标签： linux 网络 c语言 vscode http ssl tcp/ip

于 2025-03-18 17:47:31 首次发布

本文链接：https://blog.youkuaiyun.com/m0_64657422/article/details/146345721

版权

Linux网络编程专栏收录该内容

12 篇文章

订阅专栏

嵌入式Linux网络编程实战：使用libcurl实现高效网络通信

【本文代码已在立创·泰山派平台验证通过（需进行交叉编译）】

一、为什么选择libcurl？

在嵌入式Linux开发中，libcurl 是处理网络协议的首选库，其优势如下：

多协议支持：HTTP/HTTPS/FTP/SMTP等
资源友好：最小编译体积约200KB
高可靠性：全球超过100亿台设备使用
跨平台性：支持Linux/RTOS/Windows等

二、libcurl在嵌入式环境中的配置

2.1 交叉编译libcurl

# 示例：ARM64平台编译：进入源码目录
# 配置编译参数（示例）
./configure \
    --host=aarch64-linux-gnu \          # 关键修改：指定 ARM64 工具链前缀
    --prefix=$(pwd)/build-arm64 \       # 安装到当前目录的 build-arm64 文件夹
    --disable-ftp \                     # 禁用 FTP 协议支持
    --disable-ldap \                    # 禁用 LDAP 协议支持
    --disable-rtsp \                    # 禁用 RTSP 协议支持
    --without-zlib \                    # 禁用 zlib 压缩（如需压缩可指定 --with-zlib=交叉编译的路径）
    --with-ssl=/path/to/openssl-arm64 \ # 指向交叉编译的 OpenSSL 路径
    --disable-shared \                  # 可选：仅编译静态库（减少依赖）
    --enable-static \                   # 编译静态库
    CC=aarch64-linux-gnu-gcc \          # 显式指定交叉编译器
    CXX=aarch64-linux-gnu-g++

# 编译并安装
make -j$(nproc) && make install

2.2 启用必要功能

编译选项	说明	推荐嵌入式配置
`--with-ssl`	启用HTTPS支持	必选
`--disable-verbose`	禁用调试日志	推荐禁用
`--disable-dict`	禁用不常用协议	按需裁剪

三、libcurl核心API详解

3.1 基础工作流程

3.2 关键函数解析

函数	用途	使用场景示例
`curl_easy_init()`	创建CURL句柄	初始化HTTP请求
`curl_easy_setopt()`	设置请求参数	配置URL/Header/回调函数
`curl_easy_perform()`	执行网络传输	发送请求并接收响应
`curl_easy_cleanup()`	释放句柄资源	请求结束后清理内存
`curl_global_init()`	全局初始化	程序启动时调用一次
`curl_easy_getinfo()`	获取响应信息	获取HTTP状态码/连接时间
`curl_global_cleanup)`	释放资源	程序结束时调用一次

1） curl_easy_init()

函数原型

CURL *curl_easy_init(void);

参数说明

无参数

返回值

成功: 返回CURL*句柄指针
失败: 返回NULL（通常内存不足时发生）

使用案例

CURL *curl = curl_easy_init();
if(!curl) {
    fprintf(stderr, "无法创建CURL句柄");
    return 1;
}

2） curl_easy_setopt()

函数原型

CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);

参数说明

参数	类型	说明	典型值示例
handle	CURL*	CURL句柄	由curl_easy_init返回的指针
option	CURLoption	配置选项宏	跳转到常用选项
parameter	varying	根据option类型决定	字符串/长整型/函数指针等

常用选项

选项	说明
`CURLOPT_URL`	设置请求 URL
`CURLOPT_WRITEFUNCTION`	设置接收数据的回调函数
`CURLOPT_WRITEDATA`	设置回调函数的用户数据指针
`CURLOPT_POSTFIELDS`	设置 POST 请求体数据
`CURLOPT_HTTPHEADER`	设置 HTTP 请求头
`CURLOPT_TIMEOUT`	设置请求超时时间（秒）
`CURLOPT_SSL_VERIFYPEER`	是否验证 SSL 证书（0-不验证）

返回值

CURLE_OK: 设置成功
其他错误码: 参考libcurl错误列表

使用案例

// 设置请求URL
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

// 设置响应回调函数
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);

// 禁用SSL验证（仅测试用）
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);

3） curl_easy_perform()

函数原型

CURLcode curl_easy_perform(CURL *handle);

参数说明

参数	类型	说明
handle	CURL*	CURL操作句柄

返回值

返回值	说明
CURLE_OK	请求执行成功
其他错误码	失败原因，如超时等

使用案例

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

4） curl_easy_cleanup()

函数原型

void curl_easy_cleanup(CURL *handle);

参数说明

参数	类型	说明
handle	CURL*	要销毁的CURL句柄指针

返回值

使用案例

curl_easy_cleanup(curl); // 释放句柄资源

5） curl_global_init()

函数原型

CURLcode curl_global_init(long flags);

参数说明

flags参数	说明
CURL_GLOBAL_ALL	初始化所有子模块
CURL_GLOBAL_SSL	仅初始化SSL
CURL_GLOBAL_DEFAULT	默认初始化（推荐）

返回值

返回值	说明
CURLE_OK	初始化成功
其他错误码	初始化失败

使用案例

// 程序启动时调用
curl_global_init(CURL_GLOBAL_DEFAULT);

// 程序退出时清理
curl_global_cleanup();

6. curl_easy_getinfo()

函数原型

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO info, ...);

参数说明

参数	类型	说明
handle	CURL*	CURL句柄
info	CURLINFO	信息类型宏
…	varying	存储结果的变量地址

常用info类型

info宏	返回值类型	说明
CURLINFO_RESPONSE_CODE	long*	HTTP状态码
CURLINFO_TOTAL_TIME	double*	请求总耗时（秒）
CURLINFO_SIZE_DOWNLOAD	double*	下载数据量（字节）
…	…	…

使用案例

long http_code = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);
printf("HTTP状态码: %ld\n", http_code);

综合示例：完整HTTP GET请求

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

size_t write_callback(char *ptr, size_t size, size_t nmemb, void *userdata)
{
    size_t real_size = size * nmemb;
    printf("收到数据: %.*s", (int)real_size, ptr);
    return real_size;
}

int main() {
    CURL *curl;
    CURLcode res;

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();
    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://httpbin.org/get");	// 使用自己的测试网站
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
        
        res = curl_easy_perform(curl);
        if(res == CURLE_OK) {
            long http_code;
            curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);
            printf("\n请求成功，状态码: %ld\n", http_code);
        } else {
            fprintf(stderr, "请求失败: %s\n", curl_easy_strerror(res));
        }
        curl_easy_cleanup(curl);
    }
    curl_global_cleanup();
    return 0;
}

编译与运行：

# 在虚拟机ubuntu20.04环境下
gcc demo.c -o demo -lcurl
./demo
# 输出：
# 收到数据: { "args": {}, ... }
# 请求成功，状态码: 200

关键注意事项

线程安全：每个线程应使用独立的CURL句柄
性能优化：复用CURL句柄减少资源开销
错误处理：始终检查CURLcode返回值
内存管理：及时清理回调函数中的用户数据

通过掌握这些核心函数的使用方法，可以快速构建高效可靠的嵌入式网络应用。

四、实战：嵌入式HTTP客户端开发

4.1 完整示例代码

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

// 响应数据回调函数
static size_t write_callback(char *ptr, size_t size,  size_t nmemb, void *userdata)
{
    size_t real_size = size * nmemb;
    printf("接收数据: %.*s", (int)real_size, ptr);
    return real_size;
}

int main(void)
{
    CURL *curl;
    CURLcode res;

    // 0. 全局初始化（只需调用一次）
    curl_global_init(CURL_GLOBAL_DEFAULT);

    // 1. 创建CURL句柄
    curl = curl_easy_init();
    if(!curl) {
        fprintf(stderr, "curl初始化失败\n");
        return 1;
    }

    // 2. 配置请求参数
    curl_easy_setopt(curl, CURLOPT_URL, "https://jsonplaceholder.typicode.com/posts/1");
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback); 
    curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);  // 禁用SSL证书验证（生产环境不建议）

    // 3. 执行请求
    res = curl_easy_perform(curl);
    
    // 4. 检查结果
    if(res != CURLE_OK) {
        fprintf(stderr, "请求失败: %s\n", curl_easy_strerror(res));
    } else {
        long http_code = 0;
        curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);
        printf("\nHTTP状态码: %ld\n", http_code);
    }

    // 5. 清理资源
    curl_easy_cleanup(curl);
    curl_global_cleanup();
    
    return 0;
}

4.2 编译与运行

# 在ubuntu20.04下编译命令（需链接libcurl）
gcc curl_demo.c -o curl_demo -lcurl

# 运行示例
./curl_demo
[输出] 接收数据: {
  "userId": 1,
  "id": 1,
  "title": "sunt aut...",
  "body": "quia et..." 
}
HTTP状态码: 200

五、高级功能扩展

5.1 POST请求发送JSON数据

const char *json_data = "{\"sensor\":1, \"value\":25.5}";
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Content-Type: application/json");

curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_data);
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

5.2 连接超时设置

curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);       // 总超时10秒
curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 5L); // 连接超时5秒

5.3 断点续传

FILE *fp = fopen("download.bin", "ab");
curl_easy_setopt(curl, CURLOPT_RESUME_FROM_LARGE, (curl_off_t)ftell(fp));
curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);

六、常见问题排查

6.1 SSL证书问题

错误信息：SSL certificate problem: unable to get local issuer certificate
解决方案：

// 指定CA证书路径
curl_easy_setopt(curl, CURLOPT_CAINFO, "/etc/ssl/certs/ca-certificates.crt");

6.2 内存泄漏检测

使用Valgrind工具检查：

valgrind --leak-check=full ./curl_demo

6.3 性能优化

复用CURL句柄：避免频繁创建/销毁
启用连接复用：curl_easy_setopt(curl, CURLOPT_TCP_KEEPALIVE, 1L)
使用多线程：每个线程独立CURL句柄

资源下载：
libcurl官方文档

本文展示了libcurl在嵌入式Linux中的核心使用方法，实际开发中可根据需求：

定制编译选项减小体积
集成到buildroot/Yocto构建系统
添加异步请求处理机制
结合JSON解析库（如cJSON）处理数据