Examples

+ +

Note

The examples assume that mod_fcgid and other necessary + modules are loaded into the server already, either built-in or + via the LoadModule + directive.

+ +

Additionally, the example configurations provide full access + to the applications using access control directives which work + with Apache 2.0 and 2.2. These directives are not appropriate + for all environments, and they do not work for development + levels of Apache HTTP Server (Subversion trunk).

+ +

The first example is a very simple Perl FastCGI application, + and its configuration directives. This is typical for FastCGI + applications which are named in the URL and which require no + special configuration.

+ +

Perl FastCGI application - /usr/local/apache/fcgi-bin/foo.pl

+ #!/usr/bin/perl + 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"; + + } + + } +

+ +

Configuration directives

+ <Directory /usr/local/apache/fcgi-bin/> + + SetHandler fcgid-script + Options +ExecCGI + + # Customize the next two directives for your requirements. + Order allow,deny + Allow from all + + </Directory> +

+ +

PHP applications are usually configured using the + FCGIWrapper directive + and a corresponding wrapper script, as in the following + example:

+ +

PHP application - /usr/local/phpapp/phpinfo.php

+ <?php + + phpinfo(); + + ?> +

+ +

Configuration directives

+ Alias /phpapp/ /usr/local/phpapp/ + <Location /phpapp/> + + AddHandler fcgid-script .php + Options +ExecCGI + FCGIWrapper /usr/local/bin/php-wrapper .php + # Uncomment the following line if cgi.fix_pathinfo + # is set to 1 in php.ini: + # PHP_Fix_Pathinfo_Enable 1 + + # Customize the next two directives for your requirements. + Order allow,deny + Allow from all + + </Location> + + <FilesMatch /usr/local/phpapp/phpinfo.php> + + # Customize the next two directives for your requirements. + Order allow,deny + Allow from all + + </FilesMatch> + +

+ +

PHP wrapper script - /usr/local/bin/php-wrapper

+ #!/bin/sh + # Set desired PHP_FCGI_* environment variables. + # Example: + PHP_FCGI_MAX_REQUESTS=1000 + export PHP_FCGI_MAX_REQUESTS + + # Replace with the path to your FastCGI-enabled PHP executable + exec /usr/local/bin/php-cgi +

+ +

BusyScanInterval Directive

- +

Description:	scan interval for busy timeout process
Syntax:	`BusyScanInterval seconds`
Default:	`BusyScanInterval 120`
Context:	server config, virtual host
Context:	server config
Status:	External
Module:	mod_fcgid

The module performs the BusyTimeout check - at this interval.

The module performs the + BusyTimeout check at this + interval.

Use DefaultInitEnv to define environment variables to pass to the FastCGI application. This directive can be used multiple times.

A process class is the set of processes which were started by the same + command, and share certain other characteristics such as virtual host and + identity.

This directive sets the maximum number of processes in a class that + can be started.

A process class is the set of processes which were started by the same + command, and share certain other characteristics such as virtual host and + identity.

This directive sets the minimum number of processes in a class that + will be retained after finishing requests.

This is the interval at which the module will handle + pending process termination. Termination is pending for + any processes which have exceeded + IdleScanInterval or + ProcessLifeTime.

This directive controls whether or not other access checkers + are allowed to run when this module has an access checker configured + and it fails a request. If this directive is On (default) + and a FastCGI access checker returns a failure status, a failure is + returned to the client without giving other access checkers a chance to + allow access. If this directive is Off, other access + checkers will be called.

This directive controls whether or not other authenticators + are allowed to run when this module has an authenticator configured + and it fails a request. If this directive is On (default) + and a FastCGI authenticator returns a failure status, a failure is + returned to the client without giving other authenticators a chance to + validate the client identity. If this directive is Off, + other authenticators will be called.

This directive controls whether or not other authorizers + are allowed to run when this module has an authorizer configured + and it fails a request. If this directive is On (default) + and a FastCGI authorizer returns a failure status, a failure is + returned to the client without giving other authorizer a chance to + access the resource. If this directive is Off, other + authorizers will be called.

The optional suffix argument restricts the use of this FCGI server to all URLs with the given exact path suffix. A suffix needs to start with '.'.

The virtual flag signals that there will be no check whether the request URL actually points to an existing file. The only file which needs to exist is the wrapper itself.

The directive can be used multiple times. A wrapper defined without a suffix is used as a default in case no suffix matches.

This is the interval at which the module will search for + processes which have exceeded + IdleScanInterval or + ProcessLifeTime.

Application processes which have not handled a request + for this period of time will be terminated.

This is the maximum period of time the module will wait + while trying to read from or write to a FastCGI application.

This is the maximum period of time the module will wait + while trying to connect to a FastCGI application on Windows. + (This directive is not respected on Unix, where AF_UNIX defaults + will apply.)

This module reads the request body from the client before - sending to the application. Normally the request body will - be stored in memory. If the body exceeds - MaxRequestInMem bytes, the body will - be stored in a temporary file.

This module reads the entire request body from the client + before sending it to the application. Normally the request body + will be stored in memory. Once the amount of request body read + from the client exceeds MaxRequestInMem + bytes, the remainder of the request body will be stored in a + temporary file.

If the size of the request body exceeds this amount, the request will fail with 500 Server Error.

If set, FastCGI application processes will be terminated after - handling this many requests.

FastCGI application processes will be terminated after handling + the specified number of requests. A value of -1 + disables the check.

This is the maximum amount of response data the module will read + from the FastCGI application before flushing the data to the client.

See also

Topics

See also

Examples

Note

Perl FastCGI application - /usr/local/apache/fcgi-bin/foo.pl

Configuration directives

PHP application - /usr/local/phpapp/phpinfo.php

Configuration directives

PHP wrapper script - /usr/local/bin/php-wrapper

BusyScanInterval Directive

Note

Warning