Apache FastCGI

Apache has multiple implementations of the CGI and FastCGI specifications. The below are the most common and easiest to use.

See here for details on the specifications.

Module

mod_fcgi was designed to be a comprehensive upgrade from mod_cgi and mod_cgid.

Consider the following Perl script, which should live under /usr/local/apache/fcgi-bin:

use CGI::Fast;

while (my $q = CGI::Fast->new) {
  print("Content-Type: text/plain\n\n");
  foreach $var (sort(keys(%ENV))) {
    $val = $ENV{$var};
    $val =~ s|\n|\\n|g;
    $val =~ s|"|\\"|g;
    print "${var}=\"${val}\"\n";
  }
}

With mod_fcgi, Apache can be made to execute this with very little configuration.

<Directory /usr/local/apache/fcgi-bin/>
  SetHandler fcgid-script
  Options +ExecCGI

  Order allow,deny
  Allow from all
</Directory>

PHP works very similarly. Consider the following script:

<?php
  phpinfo();
?>

Because many servers of significance are written in PHP, it's not realistic to require that they be installed under the web root. While the above script could live anywhere, the below configurations will reference /usr/local/myapp/ as its location.

A wrapper script under /usr/local/apache/fcgi-bin will be necessary. It should look like:

# PHP FastCGI processes exit after 500 requests by default.
PHP_FCGI_MAX_REQUESTS=10000
export PHP_FCGI_MAX_REQUESTS

# Replace with the path to your FastCGI-enabled PHP executable
exec /usr/local/bin/php-cgi

Finally, the Apache configuration should look like:

Alias /myapp/ /usr/local/myapp/
<Location /myapp/>
  AddHandler fcgid-script .php
  Options +ExecCGI
  FcgidWrapper /usr/local/apache/fcgi-bin/php-wrapper .php

  Order allow,deny
  Allow from all
</Location>

CategoryRicottone