cloudxtreme / mod_psgi Goto Github PK

This is Apache2 module mod_psgi.

* Install

    % ./configure
    % make
    % sudo make install

You can specify apxs, apachectl and perl as follows:

    % ./configure \
        --with-apxs=/path/to/apxs \
        --with-apachectl=/path/to/apachectl \
        --with-perl=/path/to/perl

Then activate it in Apache's httpd.conf file for instance
for the URL /psgi in as follows:

    # httpd.conf
    LoadModule psgi_module modules/mod_psgi.so
    <Location /psgi>
      SetHandler psgi
      PSGIApp /path/to/app.psgi
    </Location>

Then after restarting Apache via

    $ apachectl restart

* Spec

    * PSGIApp files are loaded by 'do $file' at the time of startup parent process.
    The file must return a code reference that is a PSGI application.

    * The input stream ($env->{'psgi.input'}) is not seekable.
    $env->{'psgi.input'}->seek($pos, $whence) raises an error.

* References

    * Repository: http://github.com/spiritloose/mod_psgi

    * PSGI/Plack: http://plackperl.org/

    * PSGI specification: http://search.cpan.org/perldoc?PSGI

* License

See the 'LICENSE' file.

* Author

Jiro Nishiguchi <[email protected]>