Asynchronous/multiplexing FastCGI for nginx (incl. ref server implementation)
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
nginx removed clutter and replaced it with a todo Dec 13, 2009
servers/afcgitest removed an incorrect assertment Dec 13, 2009
.gitignore gitignore Dec 13, 2009
LICENSE initial commit Dec 13, 2009 readme w screenshot Dec 13, 2009


Asynchronous FastCGI.

Primarily a modified version of the Nginx FastCGI module which implements multiplexing of connections, allowing a single FastCGI server to handle many concurrent requests.

This paves the way for long-lived connections in web apps without wasting resources -- i.e. optimally you only need to run one server process per CPU (or one server with one thread per CPU) instead of one process per request.


  • nginx/ contains the modified ngx_http_fastcgi_module.c along with a "prefix" (conf, logs, etc) for running a test server.

  • servers/ contains a set of asynchronous FastCGI server implementations, most notably the original libevent-based server written with the purpose to test afcgi.


Nginx module

The nginx module is built by replacing the original ngx_http_fastcgi_module.c:

tar xzf nginx-0.8.29.tar.gz
cd nginx-0.8.29/src/http/modules
mv ngx_http_fastcgi_module.c ngx_http_fastcgi_module.c.dist
cp /path/to/afcgi/nginx/src/http/modules/ngx_http_fastcgi_module.c .
cd ../../..

This module has been developed for and tested with nginx version 0.8.29 and is still in an experimental stage. No warranties, no guarantees -- use at own risk ;)

Server reference implementation

The FCGI server reference implementation in servers/afcgitest is built by using regular make and linking against libevent:

cd /path/to/afcgi/servers/afcgitest

The last line assumes a FastCGI client (i.e. nginx) is connecting to port 5000 on

At the moment the Makefile is prepared for Mac OS X and contains a few lines which will not work in other environments. Simply remove or comment-out these lines when building on another platform:

# If Mac OS X:
CFLAGS += -arch i386
LDFLAGS += -arch i386


# If Mac OS X:
#CFLAGS += -arch i386
#LDFLAGS += -arch i386

OS X users: This assumes libevent is built for the i386 architecture. Your libevent library might use another architecture and then you should change the -arch argument value to match the architecture of libevent.

License & redistribution

Most parts of this software is licensed under the MIT license (see the LICENSE file for details) while the nginx module is licensed under the nginx license (details in the file nginx/LICENSE).

In short; you are free to use this software for commercial and non-commercial applictions as long as the license(s) and copyright notice(s) are properly reproduced. Read the LICENSEs files for details.


  • Rasmus Andersson

  • Igor Sysoev (author of the original, synchronous fastcgi module)