This module provides support for FastCGI, an open extension to CGI
which provides much higher performance and greater functionality.
For more information about FastCGI, see the official website at
http://www.fastcgi.com.
FastCGIs are executed in FastCGI alias directories setup by the ">
map module. More information about how to setup FastCGI is available
in the documentation system.
Remote FastCGIs
FastCGIs can be setup to run on a different machine than the
webserver. Simply specify the URL of the FastCGI (which should be
inside a FastCGI alias) which is to run remotely, and the details of
where the FastCGI lives on the network.
<%= Z::form( ) %>
<%= ( grep /^\!remote\!/, keys %::f ) and
Z::form_table( key=>"Path", value=>"Remote Machine", base=>"remote" ) or
"No remote FastCGIs are currently defined"
%>
Add Remote FastCGI:
Docroot Path: /path
Remote machine: hostname:port
<%= Z::endform() %>
FastCGI Authorizers
FastCGI can be used to authenticate client requests (e.g. checking
supplied user/password information against an database). A FastCGI
authorizer is setup to handle authentication on a portion of the
document tree by specifying a docroot path. Any client requests to
this portion of the document tree will cause the Web Server to contact
the FastCGI for authorization before allowing the request to proceed.
<%= Z::form( ) %>
<%= ( grep /^\!authorizers\!/, keys %::f ) and
Z::form_table( key=>"Path", value=>"FastCGI location", base=>"authorizers" ) or
"No FastCGI authorizers are currently defined"
%>
Add FastCGI authorizer:
Docroot Path: /path
FastCGI location:
<%= Z::endform() %>
Base environment
For FastCGI programs started by the automatically by the server on
demand, you can specify extra environment settings to be passed to
them here on startup.
<%= Z::form( ) %>
<%= ( grep /^\!env\!/, keys %::f ) and
Z::form_table( key=>"Name", value=>"Value", base=>"env" ) or
"No extra CGI environment variables are currently defined"
%>