httpsrv：打造极简HTTP服务器的首选方案

当项目需要快速暴露一个HTTP接口或共享本地文件时，传统的Web服务器往往显得过于笨重。httpsrv通过精简的设计理念，让开发者无需依赖复杂框架，即可用极少代码构建出功能完整的轻量级HTTP服务，成为现代开发流程中的理想选择。

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/

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