一、ESP32 IDF創(chuàng)建WEB SERVER的流程

1. 配置web服務(wù)器

在ESP-IDF中，Web服務(wù)器使用httpd組件實(shí)現(xiàn)。我們需要先創(chuàng)建httpd_config_t結(jié)構(gòu)體，指定服務(wù)器的端口、最大并發(fā)連接數(shù)、URI匹配處理器等選項(xiàng)。然后，我們通過(guò)調(diào)用httpd_start函數(shù)來(lái)啟動(dòng)Web服務(wù)器。

httpd_config_t config = HTTPD_DEFAULT_CONFIG();
httpd_handle_t server = NULL;

// 設(shè)置服務(wù)器端口為80
config.server_port = 80;

// 創(chuàng)建HTTP服務(wù)器句柄
if (httpd_start(&server, &config) != ESP_OK) {
    printf("Error starting server!\\n");
    return;
}

在這個(gè)示例中，我們首先使用HTTPD_DEFAULT_CONFIG宏創(chuàng)建默認(rèn)的Web服務(wù)器配置。接著，我們將服務(wù)器端口設(shè)置為80，創(chuàng)建HTTP服務(wù)器句柄，并啟動(dòng)Web服務(wù)器。

2. 注冊(cè) URI處理器

在Web服務(wù)器啟動(dòng)后，我們需要為不同的URI注冊(cè)處理器函數(shù)。當(dāng)Web服務(wù)器接收到請(qǐng)求時(shí)，會(huì)根據(jù)請(qǐng)求的URI選擇相應(yīng)的處理器函數(shù)進(jìn)行處理。在ESP-IDF中，我們可以使用

httpd_register_uri_handler函數(shù)注冊(cè)URI處理器。該函數(shù)的原型如下：

esp_err_t httpd_register_uri_handler(httpd_handle_t hd, const httpd_uri_t *uri)

其中，hd參數(shù)為HTTP服務(wù)器句柄；uri參數(shù)為包含URI路徑、HTTP方法、處理函數(shù)等信息的結(jié)構(gòu)體指針。例如：

static esp_err_t hello_get_handler(httpd_req_t *req)
{
    char resp_str[64];
    httpd_req_get_url_query_str(req, resp_str, sizeof(resp_str));
    printf("query string: %s\\n", resp_str);
    httpd_resp_send(req, "Hello, world!", HTTPD_RESP_USE_STRLEN);
    return ESP_OK;
}

httpd_uri_t hello = {
    .uri       = "/hello",
    .method    = HTTP_GET,
    .handler   = hello_get_handler,
    .user_ctx  = NULL
};

if (httpd_register_uri_handler(server, &hello) != ESP_OK) {
    printf("Error registering URI handler!\\n");
    return;
}

3. 實(shí)現(xiàn) URI處理器函數(shù)

在注冊(cè)URI處理器后，我們需要實(shí)現(xiàn)對(duì)應(yīng)的處理器函數(shù)。URI處理器函數(shù)的原型為：

typedef esp_err_t (*httpd_uri_func_t)(httpd_req_t *req);

其中，req參數(shù)為指向HTTP請(qǐng)求信息的結(jié)構(gòu)體指針，包含了請(qǐng)求的各種參數(shù)和數(shù)據(jù)。

4. 處理HTTP請(qǐng)求

在URI處理器函數(shù)中，我們可以通過(guò)HTTP請(qǐng)求信息結(jié)構(gòu)體指針httpd_req_t獲取HTTP請(qǐng)求的各種參數(shù)和數(shù)據(jù)。以下是一些常用的HTTP請(qǐng)求處理函數(shù)：

• httpd_req_get_hdr_value_str：獲取HTTP請(qǐng)求頭中指定字段的值（字符串格式）

• httpd_req_get_url_query_str：獲取HTTP請(qǐng)求URL中的查詢參數(shù)（字符串格式）

• httpd_query_key_value：解析HTTP請(qǐng)求URL中的查詢參數(shù)，獲取指定參數(shù)名的值（字符串格式）

• httpd_req_recv：從HTTP請(qǐng)求接收數(shù)據(jù)

• httpd_req_send：發(fā)送HTTP響應(yīng)數(shù)據(jù)

• httpd_resp_set_type：設(shè)置HTTP響應(yīng)內(nèi)容的MIME類型

• httpd_resp_send_chunk：分塊發(fā)送HTTP響應(yīng)數(shù)據(jù)。

  例如，以下是一個(gè)URI處理器函數(shù)的示例，用于處理/echo路徑的POST請(qǐng)求：

static esp_err_t echo_post_handler(httpd_req_t *req)
{
    char buf[1024];
    int ret, remaining = req->content_len;

    // 從HTTP請(qǐng)求中接收數(shù)據(jù)
    while (remaining > 0) {
        ret = httpd_req_recv(req, buf, MIN(remaining, sizeof(buf)));
        if (ret <= 0) {
            if (ret == HTTPD_SOCK_ERR_TIMEOUT) {
                // 處理超時(shí)
                httpd_resp_send_408(req);
            }
            return ESP_FAIL;
        }

        // 處理接收到的數(shù)據(jù)
        // ...

        remaining -= ret;
    }

    // 發(fā)送HTTP響應(yīng)
    httpd_resp_set_type(req, HTTPD_TYPE_TEXT);
    httpd_resp_send(req, "Received data: ", -1);
    httpd_resp_send_chunk(req, buf, req->content_len);
    httpd_resp_send_chunk(req, NULL, 0);

    return ESP_OK;
}

5. 處理web socket連接

除了支持HTTP請(qǐng)求外，ESP-IDF的Web服務(wù)器還支持WebSocket連接。WebSocket是一種基于TCP的協(xié)議，可以提供雙向通信功能。在ESP-IDF中，我們可以使用httpd_ws_frame_t結(jié)構(gòu)體表示W(wǎng)ebSocket幀，使用httpd_ws_send_frame_async函數(shù)異步發(fā)送WebSocket幀。

要處理WebSocket連接，我們需要為WebSocket URI注冊(cè)專門的處理器函數(shù)，并在該函數(shù)中處理WebSocket連接的各種事件。

6. 注冊(cè) URI 處理函數(shù)

創(chuàng)建好HTTP服務(wù)器后，需要注冊(cè)URI處理函數(shù)，以便處理客戶端發(fā)送的請(qǐng)求。URI處理函數(shù)需要實(shí)現(xiàn)在HTTP請(qǐng)求中指定的URI。

在ESP-IDF中，可以使用

httpd_register_uri_handler()函數(shù)注冊(cè)URI處理函數(shù)。該函數(shù)需要傳入一個(gè)httpd_uri_t結(jié)構(gòu)體作為參數(shù)，該結(jié)構(gòu)體包含了URI路徑和處理函數(shù)的信息。

例如，下面的代碼注冊(cè)了一個(gè)處理根目錄的URI處理函數(shù)：

httpd_uri_t uri = {
    .uri       = "/",
    .method    = HTTP_GET,
    .handler   = hello_get_handler,
    .user_ctx  = NULL
};

httpd_register_uri_handler(server, &uri);

上面的代碼注冊(cè)了一個(gè)HTTP GET方法，URI路徑為“/”的處理函數(shù)hello_get_handler。當(dāng)客戶端請(qǐng)求根目錄時(shí)，HTTP服務(wù)器將調(diào)用hello_get_handler函數(shù)處理請(qǐng)求。

7. 啟動(dòng)HTTP服務(wù)器

在所有的URI處理函數(shù)都被注冊(cè)后，可以調(diào)用httpd_start()函數(shù)啟動(dòng)HTTP服務(wù)器。

httpd_start(&server);

8. 發(fā)送響應(yīng)

在URI處理函數(shù)中，可以使用httpd_resp_send()函數(shù)將響應(yīng)發(fā)送回客戶端。該函數(shù)需要傳入一個(gè)httpd_req_t結(jié)構(gòu)體作為參數(shù)，該結(jié)構(gòu)體表示HTTP請(qǐng)求和響應(yīng)。

例如，在上面的hello_get_handler處理函數(shù)中，可以使用httpd_resp_send()函數(shù)將“Hello, World!”字符串作為響應(yīng)發(fā)送回客戶端：

static esp_err_t hello_get_handler(httpd_req_t *req)
{
    const char* resp_str = "Hello, World!";
    httpd_resp_send(req, resp_str, strlen(resp_str));
    return ESP_OK;
}

9. 關(guān)閉 http 服務(wù)

使用httpd_stop()函數(shù)，該函數(shù)用于停止HTTP服務(wù)并釋放所有資源。

// 創(chuàng)建HTTP服務(wù)
httpd_handle_t server = NULL;
httpd_config_t config = HTTPD_DEFAULT_CONFIG();
httpd_start(&server, &config);

// 關(guān)閉HTTP服務(wù)
httpd_stop(server);

二、本要主要使用API的說(shuō)明

1. httpd_register_uri_handler

用于將HTTP請(qǐng)求的URI路由到處理程序。這個(gè)函數(shù)接收兩個(gè)參數(shù)：httpd_handle_t類型的HTTP服務(wù)器句柄和httpd_uri_t類型的URI配置。

2. httpd_handle_t

httpd_handle_t是HTTP服務(wù)器的一個(gè)句柄，它是通過(guò)httpd_start函數(shù)創(chuàng)建的。而httpd_uri_t則定義了HTTP請(qǐng)求的URI信息，包括URI路徑、HTTP請(qǐng)求方法和處理函數(shù)等。

3. httpd_query_key_value獲取變量值

httpd_query_key_value 用于從查詢字符串中獲取指定鍵的值。查詢字符串是指URL中?后面的部分，包含多個(gè)鍵值對(duì)，每個(gè)鍵值對(duì)之間使用&分隔。例如，對(duì)于以下URL：

http://192.168.1.1/path/to/handler?key1=value1&key2=value2

獲取其中的：

esp_err_t httpd_query_key_value(const char *query, const char *key, char *buf, size_t buf_len);

這是一個(gè)使用示例：

char query_str[] = "key1=value1&key2=value2";
char key[] = "key1";
char value[16];

if (httpd_query_key_value(query_str, key, value, sizeof(value)) == ESP_OK) {
    printf("value=%s\\n", value);
} else {
    printf("key not found\\n");
}

4. 獲取get參數(shù)示例

下面定義的 handler 演示了如何從請(qǐng)求參數(shù)里解析 字符串param1和整型變量param2：

esp_err_t index_handler(httpd_req_t *req)
{
     char* query_str = NULL;
     char param1_value[10] = {0};
     int param2_value=0;

     query_str = strstr(req->uri, "?");
     if(query_str!=NULL){
         query_str ++;
         httpd_query_key_value(query_str, "param1", param1_value, sizeof(param1_value));
         char param2_str[10] = {0};
         httpd_query_key_value(query_str, "param2", param2_str, sizeof(param2_str));
         param2_value = atoi(param2_str);
     }

     char resp_str[50] = {0};
     snprintf(resp_str, sizeof(resp_str), "param1=%s, param2=%d", param1_value, param2_value);
    httpd_resp_send(req, resp_str, strlen(resp_str));
    return ESP_OK;
}

5. 獲取post參數(shù)示例

下面的示例代碼中根據(jù)httpd_req_t的content_len來(lái)分配一個(gè)緩沖區(qū)，并解析請(qǐng)求中的POST參數(shù)：

esp_err_t post_demo_handler(httpd_req_t *req)
{
    char post_string[64];
    int post_int=0;

    if (req->content_len > 0)
    {
        // 從請(qǐng)求體中讀取POST參數(shù)
        char *buf = malloc(req->content_len + 1);
        int ret = httpd_req_recv(req, buf, req->content_len);
        if (ret <= 0)
        {
            // 接收數(shù)據(jù)出錯(cuò)
            free(buf);
            return ESP_FAIL;
        }
        buf[req->content_len] = '\\0';

        // 解析POST參數(shù)
        char *param_str;
        param_str = strtok(buf, "&");
        while (param_str != NULL)
        {
            char *value_str = strchr(param_str, '=');
            if (value_str != NULL)
            {
                *value_str++ = '\\0';
                if (strcmp(param_str, "post_string") == 0)
                {
                    strncpy(post_string, value_str, sizeof(post_string));
                }
                else if (strcmp(param_str, "post_int") == 0)
                {
                    post_int = atoi(value_str);
                }
            }
            param_str = strtok(NULL, "&");
        }

        free(buf);
    }

    // 將結(jié)果打印輸出
    printf("post_string=%s, post_int=%d\\n", post_string, post_int);

    // 返回成功
    httpd_resp_send(req, NULL, 0);
    return ESP_OK;
}


 httpd_uri_t post_uri = {
         .uri = "/post",
         .method = HTTP_POST,
         .handler = post_demo_handler,
         .user_ctx = NULL
 };

三、基本用法完整示例

接前文的項(xiàng)目代碼示例，項(xiàng)目結(jié)構(gòu)如下：

本文主要是使用其中的web_server.c文件。

1. 加載http_server模塊

在 CMakeLists.txt里寫上 ：

idf_component_register(
	REQUIRES "esp_http_server"
)

2. 建立 web_server.h 頭文件

#ifndef ESP32_LEARN_WEB_SERVER_H
#define ESP32_LEARN_WEB_SERVER_H
void http_server_task(void *pvParameters);
#endif //ESP32_LEARN_WEB_SERVER_H

3. web_server.c文件實(shí)現(xiàn)

#include "include/web_server.h"
#include 
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "esp_system.h"
#include "esp_netif.h"
#include "esp_http_server.h"
#include "string.h"
/* Define the server port number */
#define SERVER_PORT 80

/* Define the routes for the web server */
const  char *INDEX_HTML = "Hello, world";

/* Define the handler for the HTTP requests */
 esp_err_t index_handler(httpd_req_t *req)
{
    httpd_resp_send(req, INDEX_HTML, strlen(INDEX_HTML));
    return ESP_OK;
}

/* Define the HTTP server configuration */
 httpd_uri_t index_uri = {
        .uri = "/",
        .method = HTTP_GET,
        .handler = index_handler,
        .user_ctx = NULL
};

/* Define the HTTP server task */
 void http_server_task(void *pvParameters)
{
    httpd_handle_t server = NULL;
    httpd_config_t config = HTTPD_DEFAULT_CONFIG();
    config.server_port = SERVER_PORT;

    /* Start the HTTP server */
    if (httpd_start(&server, &config) == ESP_OK) {
        /* Register the routes */
        httpd_register_uri_handler(server, &index_uri);
        ESP_LOGI("HTTP_SERVER", "Server started");
    }

    /* Loop to keep the task running */
    while (1) {
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

4. main.c 創(chuàng)建任務(wù)開啟web server

#include 

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"

#include 
#include "network/include/wifi.h"
#include "network/include/wifi_sta.h"
#include "network/include/wifi_ap.h"
#include "network/include/web_server.h"
static const char *TAG = "main";



void app_main()
{
    ESP_LOGE(TAG, "app_main");
    // 初始化NVS存儲(chǔ)區(qū)
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        ret = nvs_flash_init();
    }
    ESP_ERROR_CHECK(ret);

    // Wi-Fi初始化
    ESP_LOGI(TAG, "Wi-Fi initialization");
    wifi_initialize();

    wifi_init_softap();
    /* Start the HTTP server task */
    xTaskCreate(http_server_task, "http_server_task", 4096, NULL, 5, NULL);
    while (1) {
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}