httpserver - HTTP-сервер

Функції для запуску вбудованого HTTP-сервера на Лілці.

Модуль httpserver дозволяє приймати HTTP-запити від інших пристроїв у мережі, обробляти їх та надсилати відповіді. Для роботи сервера Лілка повинна бути підключена до WiFi (див. wifi - Робота з WiFi-мережами).

Приклад простого HTTP-сервера, який відповідає на запити:

wifi.connect("MyWifi", "password")

local server_fd = httpserver.listen(80)

function lilka.update(delta)
    local req, err = httpserver.accept(server_fd, 0)
    if req == nil then
        return
    end

    if req.path == "/" then
        httpserver.respond(req.fd, 200, {["Content-Type"] = "text/plain"}, "Привіт від Лілки!")
    else
        httpserver.respond(req.fd, 404, {}, "Not Found")
    end
end

function lilka.draw()
    display.fill_screen(display.color565(0, 0, 0))
    display.set_cursor(0, 16)
    display.print("HTTP-сервер запущено")
end

class httpserver

static listen(port, backlog?)

Creates a TCP server socket and starts listening for HTTP connections.

Parameters:

• port (integer) – Port to listen on (e.g. 80)

• backlog? (integer) – Connection backlog (default: 5)

Returns:

fd Server socket file descriptor, or nil on error

Return type:

integer or nil

Returns:

? errmsg Error message on failure

Return type:

str

static accept(server_fd, timeout_ms?)

Waits for and accepts the next HTTP connection, parses the request.

The returned fd must be passed to httpserver.respond() or net.close().

Parameters:

• server_fd (integer) – Server socket from httpserver.listen()

• timeout_ms? (integer) – How long to wait in ms; -1 = block indefinitely

Returns:

request Parsed request table, or nil on timeout/error

Return type:

HttpRequest or nil

Returns:

? errmsg «timeout» | error description

Return type:

str

static respond(fd, status, headers?, body?)

Sends a complete HTTP/1.1 response and closes the client connection.

Parameters:

• fd (integer) – Client socket fd from request.fd

• status (integer) – HTTP status code (e.g. 200, 404)

• headers? (dict[str, str]) – Extra response headers

• body? (str) – Response body (default: empty)

static close(fd)

Closes a server socket (stops accepting new connections).

Parameters:

fd (integer) – Server socket file descriptor

class HttpRequest

fd: integer

Client socket fd — pass to httpserver.respond() or net.close()

client_ip: str

Remote client IP address

method: str

HTTP method (GET, POST, PUT, DELETE, …)

path: str

URL path without query string

query: str

Raw query string (may be empty)

headers: dict[str, str]

Request headers (keys lowercased)

body: str

Request body (empty string when none)