simpleHttpServer Reference

Module defined in lua/common/utils/simpleHttpServer.lua. Simple HTTP server with static file serving, JSON responses, custom route handlers, and HTML templating.

---

Exports

Functions

M.start(_bindhost, _bindport, _fileroot, _handlers, _argsCallback)

Start the HTTP server.

• Parameters:
  • _bindhost - string - Bind hostname/IP
  • _bindport - number - Bind port
  • _fileroot - string - Root directory for static files
  • _handlers - table - Route handler table mapping paths to functions
  • _argsCallback - function|nil - Callback for query parameter processing

M.stop()

Stop the HTTP server and close all connections.

M.update()

Poll for and process incoming HTTP requests. Call each frame.

• Returns: table - Request processing results

Internal Notes

• Uses LuaSocket for TCP networking
• MIME type detection via file extension mapping
• serve_file serves static files with appropriate MIME headers
• serve_json serializes Lua tables as JSON responses
• handle routes requests to registered handlers or falls back to file serving
• Uses resty/template (lustache) for HTML templating
• Non-blocking polling via socket.select with zero timeout