Apache Module mod_fcgid

Available Languages: en

Description:	Provides for execution of fastcgi applications
Status:	External
Module Identifier:	fcgid_module
Source File:	mod_fcgid.c
Compatibility:	Apache 2.0 and higher

Summary

Any program assigned to the handler fcgid-script is processed using the FastCGI protocol; mod_fcgid starts a sufficient number instances of the program to handle concurrent requests, and these programs remain running to handle further incoming requests. This is significantly faster than using the default mod_cgi or mod_cgid modules to launch the program upon each request. However, the programs invoked by mod_fcgid continue to consume resources, so the administrator must weigh the impact of invoking a particular program once per request against the resources required to leave a sufficient number of instances running continuously.

The pool of fcgid-invoked programs is shared between all httpd workers. Configuration directives below let the administrator tune the number of instances of the program that will run concurrently.

Specific executables are assigned this handler either by having a name containing an extension defined by the AddHandler directive, or with an override using the SetHandler directive (e.g., for all files in a specific directory such as cgi-bin).

For an introduction to using CGI scripts with Apache, see the generic tutorial on Dynamic Content With CGI.

BusyScanInterval Directive

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

TODO

BusyTimeout Directive

Description:	a fastcgi application will be killed after handling a request for BusyTimeout
Syntax:	`BusyTimeout seconds`
Default:	`BusyTimeout 300`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

DefaultInitEnv Directive

Description:	an environment variable name and optional value to pass to FastCGI.
Syntax:	`DefaultInitEnv name [ value ]`
Default:	`none`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

DefaultMaxClassProcessCount Directive

Description:	Max process count of one class of fastcgi application
Syntax:	`DefaultMaxClassProcessCount value`
Default:	`DefaultMaxClassProcessCount 100`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

DefaultMinClassProcessCount Directive

Description:	Min process count of one class of fastcgi application
Syntax:	`DefaultMinClassProcessCount value`
Default:	`DefaultMinClassProcessCount 3`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

ErrorScanInterval Directive

Description:	scan interval for exited process
Syntax:	`ErrorScanInterval seconds`
Default:	`ErrorScanInterval 3`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

FastCgiAccessChecker Directive

Description:	a absolute access checker file path
Syntax:	`FastCgiAccessChecker command`
Default:	`none`
Context:	directory, .htaccess
Override:	FileInfo
Status:	External
Module:	mod_fcgid

TODO

FastCgiAccessCheckerAuthoritative Directive

Description:	Set to 'off' to allow access control to be passed along to lower modules upon failure
Syntax:	`FastCgiAccessCheckerAuthoritative On\|Off`
Default:	`FastCgiAccessCheckerAuthoritative On`
Context:	directory, .htaccess
Override:	FileInfo
Status:	External
Module:	mod_fcgid

TODO

FastCgiAuthenticator Directive

Description:	a absolute authenticator file path
Syntax:	`FastCgiAuthenticator command`
Default:	`none`
Context:	directory, .htaccess
Override:	FileInfo
Status:	External
Module:	mod_fcgid

TODO

FastCgiAuthenticatorAuthoritative Directive

Description:	Set to 'off' to allow authentication to be passed along to lower modules upon failure
Syntax:	`FastCgiAuthenticatorAuthoritative On\|Off`
Default:	`FastCgiAuthenticatorAuthoritative On`
Context:	directory, .htaccess
Override:	FileInfo
Status:	External
Module:	mod_fcgid

TODO

FastCgiAuthorizer Directive

Description:	a absolute authorizer file path
Syntax:	`FastCgiAuthorizer command`
Default:	`none`
Context:	directory, .htaccess
Override:	FileInfo
Status:	External
Module:	mod_fcgid

TODO

FastCgiAuthorizerAuthoritative Directive

Description:	Set to 'off' to allow authorization to be passed along to lower modules upon failure
Syntax:	`FastCgiAuthorizerAuthoritative On\|Off`
Default:	`FastCgiAuthorizerAuthoritative On`
Context:	directory, .htaccess
Override:	FileInfo
Status:	External
Module:	mod_fcgid

TODO

FCGIWrapper Directive

Description:	The CGI wrapper setting
Syntax:	`FCGIWrapper command [ type ]`
Default:	`none`
Context:	server config, virtual host, directory, .htaccess
Override:	FileInfo
Status:	External
Module:	mod_fcgid

TODO

IdleScanInterval Directive

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

TODO

IdleTimeout Directive

Description:	An idle fastcgi application will be killed after IdleTimeout
Syntax:	`IdleTimeout seconds`
Default:	`IdleTimeout 300`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

IPCCommTimeout Directive

Description:	Communication timeout to fastcgi server
Syntax:	`IPCCommTimeout seconds`
Default:	`IPCCommTimeout 40`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

IPCConnectTimeout Directive

Description:	Connect timeout to fastcgi server
Syntax:	`IPCConnectTimeout seconds`
Default:	`IPCConnectTimeout 3`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

MaxProcessCount Directive

Description:	Max total process count
Syntax:	`MaxProcessCount value`
Default:	`MaxProcessCount 1000`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

MaxRequestInMem Directive

Description:	The part of HTTP request which greater than this limit will swap to disk
Syntax:	`MaxRequestInMem bytes`
Default:	`MaxRequestInMem 65536`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

MaxRequestLen Directive

Description:	Max HTTP request length in bytes
Syntax:	`MaxRequestLen bytes`
Default:	`MaxRequestLen 1073741824`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

MaxRequestsPerProcess Directive

Description:	Max requests handled by each fastcgi application
Syntax:	`MaxRequestsPerProcess value`
Default:	`MaxRequestsPerProcess -1`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

OutputBufferSize Directive

Description:	CGI output buffer size
Syntax:	`OutputBufferSize bytes`
Default:	`OutputBufferSize 65536`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

PassHeader Directive

Description:	Header name which will be passed to FastCGI as environment variable.
Syntax:	`PassHeader name`
Default:	`none`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

PHP_Fix_Pathinfo_Enable Directive

Description:	Set 1, if cgi.fix_pathinfo=1 in php.ini
Syntax:	`PHP_Fix_Pathinfo_Enable 1`
Default:	`PHP_Fix_Pathinfo_Enable 0`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

ProcessLifeTime Directive

Description:	fastcgi application lifetime
Syntax:	`ProcessLifeTime seconds`
Default:	`ProcessLifeTime 3600`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

SharememPath Directive

Description:	fastcgi share memory file path
Syntax:	`SharememPath pathname`
Default:	`SharememPath logs/fcgid_shm`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

SocketPath Directive

Description:	fastcgi socket file path
Syntax:	`SocketPath pathname`
Default:	`SocketPath logs/fcgidsock`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

SpawnScore Directive

Description:	Score of spawn
Syntax:	`SpawnScore value`
Default:	`SpawnScore 1`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

SpawnScoreUpLimit Directive

Description:	Spawn score up limit
Syntax:	`SpawnScoreUpLimit value`
Default:	`SpawnScoreUpLimit 10`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

TerminationScore Directive

Description:	Score of termination
Syntax:	`TerminationScore value`
Default:	`TerminationScore 2`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

TimeScore Directive

Description:	Score of passage of time (in seconds)
Syntax:	`TimeScore seconds`
Default:	`TimeScore 1`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

ZombieScanInterval Directive

Description:	scan interval for zombie process
Syntax:	`ZombieScanInterval seconds`
Default:	`ZombieScanInterval 3`
Context:	server config, virtual host
Status:	External
Module:	mod_fcgid

TODO

Apache Module mod_fcgid

Summary

Directives

See also

BusyScanInterval Directive

BusyTimeout Directive

DefaultInitEnv Directive

DefaultMaxClassProcessCount Directive

DefaultMinClassProcessCount Directive

ErrorScanInterval Directive

FastCgiAccessChecker Directive

FastCgiAccessCheckerAuthoritative Directive

FastCgiAuthenticator Directive

FastCgiAuthenticatorAuthoritative Directive

FastCgiAuthorizer Directive

FastCgiAuthorizerAuthoritative Directive

FCGIWrapper Directive

IdleScanInterval Directive

IdleTimeout Directive

IPCCommTimeout Directive

IPCConnectTimeout Directive

MaxProcessCount Directive

MaxRequestInMem Directive

MaxRequestLen Directive

MaxRequestsPerProcess Directive

OutputBufferSize Directive

PassHeader Directive

PHP_Fix_Pathinfo_Enable Directive

ProcessLifeTime Directive

SharememPath Directive

SocketPath Directive

SpawnScore Directive

SpawnScoreUpLimit Directive

TerminationScore Directive

TimeScore Directive

ZombieScanInterval Directive