1.3.1
[hunchentoot.git] / README.md
blob20e4205245b39373d3f9683e4a04ea48229ebc41
1 ----------------------------------------
2 Hunchentoot - The Common Lisp web server
3 ----------------------------------------
5 Hunchentoot is a web server written in Common Lisp and at the same
6 time a toolkit for building dynamic websites.  As a stand-alone web
7 server, Hunchentoot is capable of HTTP/1.1 chunking (both directions),
8 persistent connections (keep-alive), and SSL.
10 Hunchentoot provides facilities like automatic session handling (with
11 and without cookies), logging, customizable error handling, and easy
12 access to GET and POST parameters sent by the client. It does *not*
13 include functionality to programmatically generate HTML output. For
14 this task you can use any library you like,
15 e.g. [CL-WHO](https://github.com/edicl/cl-who/) or
16 [HTML-TEMPLATE](https://github.com/edicl/html-template/).
18 Hunchentoot talks with its front-end or with the client over TCP/IP
19 sockets and optionally uses multiprocessing to handle several requests
20 at the same time.  Therefore, it cannot be implemented completely in
21 [portable Common
22 Lisp](http://www.lispworks.com/documentation/HyperSpec/Front/index.htm).
23 It currently works with [LispWorks](http://www.lispworks.com/) and all
24 Lisps which are supported by the compatibility layers
25 [usocket](http://common-lisp.net/project/usocket/) and [Bordeaux
26 Threads](http://common-lisp.net/project/bordeaux-threads/).
28 Hunchentoot comes with a [BSD-style
29 license](http://www.opensource.org/licenses/bsd-license.php) so you
30 can basically do with it whatever you want.
32 Complete documentation for Hunchentoot including details about how to
33 install it can be found in the `docs` directory or at the [project
34 website](https://edicl.github.io/hunchentoot/).