当前位置：首页 > news >正文

LwIP-2.1.3 HTTP Client扩展：从GET到POST的轻量级实现指南

news 2026/6/7 11:28:09

1. LwIP-2.1.3 HTTP Client基础解析

LwIP作为轻量级TCP/IP协议栈，其HTTP客户端模块在嵌入式开发中非常实用。但原生LwIP-2.1.3仅支持GET方法，这在实际项目中往往不够用。我们先看下GET请求的报文结构：

#define HTTPC_REQ_11 "GET %s HTTP/1.1\r\n" /* URI */ "User-Agent: %s\r\n" /* User-Agent */ "Accept: */*\r\n" "Connection: Close\r\n" /* 非持久连接 */ "\r\n"

这种固定格式的宏定义使得GET请求非常容易构造，但当我们想提交表单数据时就会遇到障碍。POST请求与GET的核心差异在于：

需要Content-Type声明数据格式
必须指定Content-Length
请求体需要携带实际数据

2. POST报文构造实战

基于GET的宏定义，我们可以扩展出POST版本：

#define HTTPC_REQ_11_POST "POST %s HTTP/1.1\r\n" /* URI */ "User-Agent: %s\r\n" /* User-Agent */ "Accept: */*\r\n" "Content-Type: application/x-www-form-urlencoded\r\n" "Content-Length: %d\r\n" /* 数据长度 */ "Connection: Close\r\n" "\r\n" "%s" /* 实际数据 */

这里有几个关键点需要注意：

Content-Type：示例中使用表单格式，实际还可以是application/json等
数据长度：必须精确计算请求体的字节数
数据拼接：报文头与请求体之间用空行分隔

带Host头的扩展版本：

#define HTTPC_REQ_11_HOST_POST "POST %s HTTP/1.1\r\n" /* URI */ "User-Agent: %s\r\n" /* User-Agent */ "Accept: */*\r\n" "Host: %s\r\n" /* 服务器名 */ "Content-Type: application/x-www-form-urlencoded\r\n" "Content-Length: %d\r\n" "Connection: Close\r\n" "\r\n" "%s"

3. 核心函数改造指南

原始代码通过httpc_create_request_string生成请求报文，我们需要为其添加POST分支：

static int httpc_create_request_string(const httpc_connection_t *settings, const char* server_name, int server_port, const char* uri, int use_host, char *buffer, size_t buffer_size) { if (settings->use_proxy) { // 代理处理逻辑保持不变... } else if (use_host) { LWIP_ASSERT("server_name != NULL", server_name != NULL); if (settings->use_post) { // 新增POST分支 return snprintf(buffer, buffer_size, HTTPC_REQ_11_HOST_FORMAT_POST(uri, server_name, settings->arglen, settings->args)); } return snprintf(buffer, buffer_size, HTTPC_REQ_11_HOST_FORMAT(uri, server_name)); } else { if (settings->use_post) { // 无Host的POST分支 return snprintf(buffer, buffer_size, HTTPC_REQ_11_FORMAT_POST(uri, settings->arglen, settings->args)); } return snprintf(buffer, buffer_size, HTTPC_REQ_11_FORMAT(uri)); } }

4. 连接结构体扩展方案

为了支持POST功能，需要扩展httpc_connection_t结构体：

typedef struct _httpc_connection { ip_addr_t proxy_addr; u16_t proxy_port; u8_t use_proxy; #if LWIP_ALTCP altcp_allocator_t *altcp_allocator; #endif httpc_result_fn result_fn; httpc_headers_done_fn headers_done_fn; /* 新增POST相关字段 */ u8_t use_post; // 启用POST方法标志 u16_t arglen; // 参数长度 const char* args; // 参数数据指针 } httpc_connection_t;

新增字段说明：

use_post：1表示使用POST方法
arglen：请求体数据长度
args：指向请求体数据的指针

5. 实际调用示例

下面演示如何通过修改后的接口发送POST请求：

// GET请求示例（保持原用法不变） httpc_get_file(&server_ip, 8080, "/api/data", NULL, callback, NULL, NULL); // POST请求示例 httpc_connection_t settings = { .use_proxy = 0, .result_fn = NULL, .headers_done_fn = NULL, .use_post = 1, // 启用POST .arglen = strlen(post_data), .args = post_data // 例如"key1=value1&key2=value2" }; httpc_get_file(&server_ip, 8080, "/api/submit", &settings, callback, NULL, NULL);