httpsrv：开发者必备的轻量级HTTP服务器工具

无论你是前端工程师、后端开发者还是全栈选手，一个灵活易用的HTTP服务器工具都是日常开发中的刚需。httpsrv凭借其简洁的API、低内存占用和高可扩展性，已成为众多开发者构建临时或生产级轻量服务的首选工具。

 

LuatOS的httpsrv核心库，让这一切变得简单——专为资源受限的物联网设备设计，可在支持LuatOS的硬件上，轻松创建一个用于处理HTTP请求的服务器。

核心功能：支持基本的HTTP方法（GET、POST、PUT、DELETE 等），并可以处理静态文件和动态请求。

适用场景：适合用于本地设备调试、简单的Web控制界面、数据上报接口等场景，为设备提供便捷的Web访问能力。

数量限制：HTTP服务器同一时间最多支持1个客户端连接，最多支持同时启动16个独立的HTTP服务实例。

目前httpsrv库已全面支持LuatOS开发系列模组，可根据项目实际需求灵活选型及应用。

 

一、httppsrv库使用要点

在LuatOS平台上使用httpsrv创建HTTP服务器时，整体使用流程和不同网络环境下的配置如下：

1.1 整体流程说明

1）初始化网络

根据需要使用的网络适配器类型，进行相应的网络初始化配置（如设置WiFi AP参数）。

2）创建回调函数

编写HTTP请求处理函数，该函数将在每次收到客户端请求时被调用。

3）选择网络适配器

确定使用哪种网络适配器（WiFi AP、STA或以太网）。

4）启动服务

调用httpsrv.start() 函数启动HTTP服务器。

5）检查启动结果

根据返回值判断服务器是否成功启动。

6）获取并记录IP地址

获取服务器的IP地址，并通过日志或其他方式告知用户。

7）处理请求

服务器开始处理来自客户端的HTTP请求，调用之前定义的回调函数。

8）停止服务

当不再需要HTTP服务时，调用httpsrv.stop() 函数停止服务，释放资源。

1.2 不同网络环境配置

1）确定网络适配器类型

httpsrv支持多种网络适配器，需要根据实际使用场景选择合适的适配器。

WiFi AP模式：通过socket.LWIP_AP参数指定，适用于设备作为Wi-Fi热点时提供Web服务。

WiFi STA模式：设备作为客户端连接到外部Wi-Fi网络后启动HTTP服务器。

以太网模式：通过socket.LWIP_ETH参数指定，仅适用于支持以太网接口的设备。

2）不同网卡下的使用方法

httpsrv支持多种网络适配器，需要根据实际使用场景选择合适的适配器。

WiFi AP模式：

WiFi STA模式：

以太网模式：

 

3）服务器IP地址获取与使用
 

httpsrv本身不提供直接设置服务器IP地址的功能，服务器会自动绑定到所选网络适配器的所有可用IP地址上。

可以通过以下方式获取服务器的IP地址：

客户端需要通过这些IP地址来访问HTTP服务器。在实际应用中，建议将获取到的IP地址通过日志输出或显示在屏幕上，方便用户访问。
 

4）多端口同时服务

httpsrv支持同时启动多个HTTP服务实例（最多16个），可以在不同端口上提供不同的服务内容：

5）服务停止
 

当不再需要HTTP服务时，应及时停止以释放系统资源：

 

二、httpsrv应用示例demo

如何快速上手应用？我们已为您准备好详细的示例代码与实操教程，轻松开始项目开发。

以Air8101工业引擎为例，最新资料详见下方链接：

最新示例源码：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8101/demo/httpsrv 

实操教程详见：https://docs.openluat.com/air8101/luatos/app/socket/httpsrv/

今天的内容就分享到这里了~