mod_ahtse_lua AHTSE
Apache httpd content generator using Lua
A module using a Lua script file to respond to a get request. Similar to the CGI mechanism, somewhat customized for AHTSE use. The lua script file should define a handler function that takes three arguments and returns three values.
Since it involves executing a script, the use of this module may increase server vulnerability
Inputs to Lua
- URL parameter string, or nil if there are no parameters
- A table of input headers
- A table of notes. The HTTPS key is set if the matching apache environment variable is also set
Outputs from Lua
- Content
- A table of output headers
- The http status code
The Content-Type header is properly handled, others might not work as expected
Apache Directives
-
AHTSE_lua_RegExp regexp
Regular expressions that have to match the request URL to activate the module. May appear more than once. -
AHTSE_lua_Script script function
The lua script to run and what function to call. The script can be lua source or precompiled lua bytecode. The default function name is handler -
AHTSE_lua_Redirect On
When the lua script returns a redirect status code and a Location header, issue an internal redirect to that location. Default is to use the response as is. Recognized redirect codes are 301, 302, 307 and 308. -
AHTSE_lua_KeepAlive On
Preserve the initialized lua state between requests on the same input connection. By default a new lua state is instantiated for each request. This setting can improve performance, but should be used only when the lua state is not modified between requests.
Lua
-
sample_script.lua
An example server side lua script, returns the query string wrapped in JSON -
harness.lua
Executes a Lua script as if invoked by this module, for script testing