* :cpp:func:`httpd_start`： 创建 HTTP 服务器的实例，根据具体的配置为其分配内存和资源，并返回该服务器实例的句柄。服务器使用了两个套接字，一个用来监听 HTTP 流量（TCP 类型），另一个用来处理控制信号（UDP 类型），它们在服务器的任务循环中轮流使用。通过向 ``httpd_start()`` 传递 ``httpd_config_t`` 结构体，可以在创建服务器实例时配置任务的优先级和堆栈的大小。TCP 流量被解析为 HTTP 请求，根据请求的 URI 来调用用户注册的处理程序，在处理程序中需要发送回 HTTP 响应数据包。
* :cpp:func:`httpd_stop`： 根据传入的句柄停止服务器，并释放相关联的内存和资源。这是一个阻塞函数，首先给服务器任务发送停止信号，然后等待其终止。期间服务器任务会关闭所有已打开的连接，删除已注册的 URI 处理程序，并将所有会话的上下文数据重置为空。
* :cpp:func:`httpd_register_uri_handler`： 通过传入 ``httpd_uri_t`` 结构体类型的对象来注册 URI 处理程序。该结构体包含如下成员：``uri`` 名字，``method`` 类型（比如 ``HTTP_GET/HTTP_POST/HTTP_PUT`` 等等）， ``esp_err_t *handler (httpd_req_t *req)`` 类型的函数指针，指向用户上下文数据的 ``user_ctx`` 指针。

/* 自定义函数，用来释放上下文数据 */
void free_ctx_func(void *ctx)
{
    /* 也可以是 free 以外的代码逻辑 */
    free(ctx);
}

esp_err_t adder_post_handler(httpd_req_t *req)
{
    /* 若上下文中不存在会话，则新建一个 */
    if (! req->sess_ctx) {
        req->sess_ctx = malloc(sizeof(ANY_DATA_TYPE));  /*!< 指向上下文数据 */
        req->free_ctx = free_ctx_func;                  /*!< 释放上下文数据的函数 */
    }

    /* 访问上下文数据 */
    ANY_DATA_TYPE *ctx_data = (ANY_DATA_TYPE *)req->sess_ctx;

    /* 响应 */
    ...............
    ...............
    ...............

    return ESP_OK;
}

static esp_err_t ws_auth_handler(httpd_req_t *req)
{
    // 在此处编写认证逻辑
    // 返回 ESP_OK 允许握手，返回其他值则拒绝握手
    return ESP_OK;
}

// 注册带有握手前认证的 WebSocket URI 处理程序
static const httpd_uri_t ws = {
    .uri        = "/ws",
    .method     = HTTP_GET,
    .handler    = handler,           // WebSocket 数据处理程序
    .user_ctx   = NULL,
    .is_websocket = true,
    .ws_pre_handshake_cb = ws_auth_handler // 设置握手前回调函数
};

// 在启动服务器后注册该处理程序
httpd_register_uri_handler(server, &ws);

- HTTP_SERVER_EVENT_ERROR           :   ``httpd_err_code_t``
- HTTP_SERVER_EVENT_START           :   ``NULL``
- HTTP_SERVER_EVENT_ON_CONNECTED    :   ``int``
- HTTP_SERVER_EVENT_ON_HEADER       :   ``int``
- HTTP_SERVER_EVENT_HEADERS_SENT    :   ``int``
- HTTP_SERVER_EVENT_ON_DATA         :   ``esp_http_server_event_data``
- HTTP_SERVER_EVENT_SENT_DATA       :   ``esp_http_server_event_data``
- HTTP_SERVER_EVENT_DISCONNECTED    :   ``int``
- HTTP_SERVER_EVENT_STOP            :   ``NULL``

esp_err_t my_uri_handler(httpd_req_t *req)
{
    // 处理请求
    // ……

    // 如果请求处理成功，则返回 ESP_OK
    return ESP_OK;

    // 返回错误代码以关闭连接
    // 返回 ESP_FAIL
}

void register_uri_handlers(httpd_handle_t server)
{
    httpd_uri_t my_uri = {
        .uri       = "/my_uri",
        .method    = HTTP_GET,
        .handler   = my_uri_handler,
        .user_ctx  = NULL
    };

    httpd_register_uri_handler(server, &my_uri);
}