Xavante is a Lua HTTP 1.1 Web server that uses a modular architecture based on URI mapped handlers. Xavante currently offers a file handler, a redirect handler and a WSAPI handler. Those are used for general files, URI remapping and WSAPI applications respectively.
Xavante is free software and uses the same license as Lua.
Current version is 2.3.0 and works with Lua 5.1 and 5.2.
Xavante can be downloaded from its Github page, at the Downloads tab.
You can also install Xavante using LuaRocks:
luarocks install xavante
The "xavante" package installs Xavante as a library. To run Xavante as an application please install WSAPI:
luarocks install wsapi-xavante
Xavante dependencies can be separated by the used handlers:
The portability of Xavante is determined by its binary components (LuaSocket and LuaFileSystem) and Lua itself. The other components are written in Lua and are as portable as Lua itself.
- Xavante 2.3.0 [30/Jan/2013]
- Lua 5.2 compatibility
- Xavante 2.2.1 [21/Oct/2010]
- allow 0 as a port value, so the OS assigns one dynamically (contribut$
- bugfixes in CGILua handler
- Xavante 2.2.0 [18/Mar/2010]
- Changed xavante.cgiluahandler to works with WSAPI 1.2/1.3 without needing kepler_init
- Xavante 2.1.0 [20/Oct/2009]
- Adds "reload" option to xavante.cgiluahandler, to force new state for every request
- Fixes a bug in File Handler that was allowing the use of ".." to access forbiden directories (bug report by Matthew Wild).
- Xavante 2.0.1 [06/Mar/2009]
- Fixes bug [#9094] keep-alive connections don't clear cached data between requests (bug report and patch by John Passaniti)
redirecthandlernow treats query strings correctly (bug report by ændrük).
- Xavante 2.0 [23/May/2008]
- New WSAPI based
- Fixed a bug on
SAPI.redirectthat was not setting the statusline correctly
- First version using LuaRocks
- New WSAPI based
- Xavante 2.0 Beta [21/Nov/2007]
- Xavante 2.0 Beta is distributed as a Lua module, the command line and Windows launchers are now part of the Kepler distribution
- If you are using Kepler, it is strongly suggested that you replace your previous
config.luafile with the new one installed by Kepler
- Allow the definition of the HTTP status by using a "Status" header
- Added the
Connection: closeheader to every CGILua request in order to avoid confusions on the content size (patch by Ignacio Burgueño)
xavante.cgiluahandlernow accepts an optional table with global names to be passed to the Ring where the request is processed. If this option is not present it looks for a
RINGS_CGILUA_GLOBALSglobal and uses it.
- Fixed bug
SAPI.Response.Writewas not sending all its arguments but the first one (bug found by Ignacio Burgueño)
- Xavante 1.3.1 [31/Aug/2007]
- Replaces the use of the cgi table by cgilua.POST and cgilua.QUERY in the examples
- Correcting the behavior of coxpcall when used with C functions (patch by Ignacio Burgueño)
- Correcting issues with chucked encoding. Now it only sends the Transfer-Encoding header when necessary. Correcting the handling of cached files in filehandler. (patches by Ignacio Burgueño)
/webstructure, using a dynamic index to documentation in
- Xavante 1.3 [24/Aug/2007]
- Uses Lua 5.1
- Fixed headers to send the header twice if it's defined twice, instead of concat'ing with commas (previous behavior was broken when sending cookies)
- Removed the restriction of only handling URLs that corresponded to
files in the filesystem. Now cgilua.dispatcher can map URLs like
/apps/wiki/...into whatever it needs. Patch by Mauricio Bomfim.
- Corrected the
- Code refactoring by Thomas Harning (Bug [#767])
- Better error handling, using
- Added the correct prefix to error codes (by Zachary P. Landau)
- Support for caching based on last-modified implemented by Zachary P. Landau, based on the design of HTTP.lua (by PA)
- Content Encoding handling using
encoding.luaas a configuration file, added svgz encoding and content-type
- Fixed bug [#510] filehandler does not send correct headers for a 404 error (found by Matthew Burke)
- Xavante 1.2 [20/Sep/2006]
- Uses Compat-5.1 Release 5
- Handles multivalued HTTP headers
- Added HTTP chunked mode response
- New startup method, using KEPLER_INIT if available
- New configuration option for the Xavante startup message
- Redirection sends a 302 status instead of a 301 (less client caching)
- Changed xavante/server.lua to xavante/xavante.lua for a simpler require"xavante" instead of require"xavante.server"
- Uses Rings instead of VEnv in the CGILua handler
- Minor bug fixes in the CGILua handler
- Xavante 1.1 [12/Jul/2005]
- Uses Copas.step() to allow more control of the Xavante loop.
- Uses coxpcall 1.6
- New documentation with installation examples using Kepler file structure
- Code cleanup, minor bug fixes
- Xavante 1.1 Beta [17/Mar/2005]
- First public release
- Refactored to use Copas
- Source base merged with luahttpd
- New configuration file with simpler rules
- Xavante 1.0 [Feb/2004]
- (not released to the public)
Xavante 1.3+ was implemented by Javier Guerra, André Carregal, and Fábio Mascarenhas with the help of Ignacio Burgueño, Zachary P. Landau, Mauricio Bomfim, Matthew Burke, Thomas Harning and others.
Xavante 1.2 was implemented by Javier Guerra, André Carregal, Fábio Mascarenhas and Leonardo Godinho.
Xavante 1.1 was redesigned and implemented by Javier Guerra and André Carregal. It merged Javier's work with luahttpd and André's work with Copas and Xavante 1.0. luahttpd is now part of Xavante.
Xavante 1.0 was designed and implemented by André Carregal as part of the Kepler Project with contributions from Renato Crivano and Danilo Tuler. Xavante 1.0 development was sponsored by Fábrica Digital and Hands.
For more information please contact us. Comments are welcome!
You can also reach other Xavante developers and users on the Kepler Project mailing list.