ngx_mod_psgi

ngx_mod_psgi copied to clipboard

NAME ngx_http_psgi_module - proof of concept PSGI implementation for nginx server

WARNING This software marked as 'proof of concept' and is under the heavy development. Anything you can or can not imagine may happen if you use it, even T. Rex may appear from your screen and eat you.

YOU HAVE BEEN WARNED.

DESCRIPTION ngx_http_psgi provides PSGI support for nginx HTTP server

DEMO git clone git://github.com/yko/ngx_mod_psgi.git cd ngx_mod_psgi make make demo

This builds nginx with psgi module and run demo PSGI application
at address http://127.0.0.1:3000/
After nginx started, demo sends POST request to server
and displays output.

Feel free to replace demo application and/or nginx.conf by your one,
re-run `make demo` and track down access and error logs
to see what's happening on server side.

You also may want to run tests from Plack::Test::Suite:

    make test

PRODUCTION This module is not production-ready yet. However, if you want to try it in production, feel free to use 'eg/nginx.conf' as an example. Also make sure you configure your nginx with 'add-module' option:

    ./configure [YOUR OPTIONS] --add-module=/path/to/ngx_http_psgi
    make

DEPENDENCIES You may need to install some dev libraries, like:

    libperl-dev

AUTHOR Yaroslav Korshak

COPYRIGHT Yaroslav Korshak, 2011-2013

LICENSE This software is licensed under the same terms as Perl itself.

SEE ALSO nginx http://nginx.org

PSGI spec <https://github.com/plack/psgi-specs>

yappo's psgi patch <https://github.com/yappo/nginx-psgi-patchs>

ngx_http_perl_module <http://wiki.nginx.org/EmbeddedPerlModule>

perlembed <http://perldoc.perl.org/perlembed.html>