A Minimal Standalone Common Lisp HTTP Server
S-HTTP-SERVER is a minimal standalone HTTP Server.
This simple package is used as a building block in a number of other open source projects.
- API Reference
- handle HTTP requests and generate HTTP responses
- be configured with plugins or handlers
- has a builtin status handler
- comes with a static resource handler, favicon handler and redirect handler
- allows you to write and install your own handlers
- support HTTPS on LispWorks
S-HTTP-SERVER is considered stable code.
- April 2006 - added HTTPS support, serveral handlers and optimalizations.
- December 2005 -
S-HTTP-SERVERwas featured in my first Lisp Movie: Episode 1: HTTP Client and Server [dead link]. Jean-François Brouillet has written an excellent tutorial on using S-HTTP-SERVER, complete with screenshots and code examples.
- November 2005 - Created as a new project.
S-HTTP-SERVER is written in ANSI standard Common Lisp and should be
portable across any CL implementation.
CL-USER 1 > (asdf:oos 'asdf:load-op :`S-HTTP-SERVER`)
Basically, you create an
S-HTTP-SERVER object and start it. Out of the
box only the status/debug page
is served. By registering new context handlers you can configure the
server further. The static-resource-handler hosts static documents from
a root directory in the file system. It is possible to write your own
handlers, look at the code of static-resource-handler and
S-HTTP-SERVER-handler for guidance.
CL-USER 1 > (in-package :`S-HTTP-SERVER`) #<The `S-HTTP-SERVER` package, 90/128 internal, 31/64 external> `S-HTTP-SERVER` 2 > (defvar *server* (make-`S-HTTP-SERVER`)) *SERVER* `S-HTTP-SERVER` 3 > (start-server *server*) ;; `S-HTTP-SERVER`: Started a new server on port 1701 #<`S-HTTP-SERVER` "`S-HTTP-SERVER`" port 1701 running 10C5F6EB> `S-HTTP-SERVER` 4 > (register-context-handler *server* "/my-site" 'static-resource-handler :arguments '("/var/www/")) ((STATIC-RESOURCE-HANDLER "/my-site" "/var/www/") (`S-HTTP-SERVER`-HANDLER "/`S-HTTP-SERVER`" :BUILTIN)) `S-HTTP-SERVER` 5 > (stop-server *server*) ;; `S-HTTP-SERVER`: Stopped server #<`S-HTTP-SERVER` "`S-HTTP-SERVER`" port 1701 not running 10C5F6EB>
Jean-François Brouillet has written an excellent tutorial on using S-HTTP-SERVER, complete with screenshots and code examples.
There is automatically generated API Reference documentation
available for the
The KPAX mailing list is used for this project.
- release 1: moved
S-HTTP-SERVERinto a seperate project under a new structure
There is currently no TODO list.
There are no known bugs.
S-HTTP-SERVER was written by Sven Van
S-HTTP-SERVER is being maintained by Sven Van
You are granted the rights to distribute and use this software as governed by the terms of the Lisp Lesser General Public License (http://opensource.franz.com/preamble.html), also known as the LLGPL.
This is a new project.
Copyright © 2005, 2006 Sven Van Caekenberghe, Beta Nine BVBA. All Right Reserved.