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工業引擎為例

今天的內容就分享到這里了


審核編輯 黃宇