Home
Chinese Info
Download (source)
Documentations
Feedback
Support This Project
  • Here are some examples of configuration

Configuration for Regular fastcgi (non-PHP, non-Ruby, non-Python) 

Configuration for suEXEC fastcgi

Configuration for PHP (UNIX)

Configuration for Ruby on Rails

Configuration for suPHP (UNIX)

Configuration for PHP (Windows)

Configuration for Authenticator

Configuration for Authorizer

Configuration for AccessChecker

 


  • There are some other configurations you can set

IdleTimeout n (300 seconds)

An idle fastcgi application will be terminated after IdleTimeout seconds.

IdleScanInterval n (120 seconds)

The scan interval for idle fastcgi applications.

BusyTimeout n (300 seconds)

a fastcgi application will be terminated if handing a single request longer than busy timeout.

BusyScanInterval n (120 seconds)

The scan interval for busy timeout fastcgi applications.

ErrorScanInterval n (3 seconds)

The scan interval for exit pending fastcgi applications. fastcgi applications will be terminated within this scanning.

ZombieScanInterval n (3 seconds)

The scan interval for zombie process. 

ProcessLifeTime n (3600 seconds)

A fastcgi application will be terminated if lifetime expired, even no error is detected.

SocketPath path (logs/fcgidsock)

The directory to put the UNIX domain socket. (UNIX only)

SharememPath path (logs/fcgid_shm)

The share memory file path. (UNIX only) (version >= 2.1 only)

SpawnScoreUpLimit n (10)

The spawn-speed control score up water limit. Score increases while a process is spawned or terminated, and decreases as time progresses; while the score is higher than SpawnScoreUpLimit, the spawning will be held for a while. The higher this number is, the higher speed of the spawning can be.

SpawnScore n (1)

The weight of spawning.  This weight will be plused to the spawn-control score on every spawn. The higher this number is, the lower speed of spawning can be.

TerminationScore n (2)

The weight of termination. This weight will be plused to the score while fastcgi process terminates. The higher this number is, the lower speed of spawning can be.

MaxProcessCount n (1000)

The max count of total fastcgi process count.

DefaultMaxClassProcessCount n (100)

The maximum number of fastcgi application instances allowed to run for any one fastcgi application. 

DefaultMinClassProcessCount n (3)

The minimum number of fastcgi application instances for any one fastcgi application. 

DefaultInitEnv  env_name env_value

The default environment variables before a fastcgi application is spawned. You can set this configuration more than once.

Note: If you get:
Can't create TCP/IP socket (10106) error while running PHP script(on Win32 only), you will have to set these(Please modify the values if necessary):
DefaultInitEnv PHPRC "c:/php/"
DefaultInitEnv PATH "c:/php;C:/WINDOWS/system32;C:/WINDOWS;C:/WINDOWS/System32/Wbem;"
DefaultInitEnv SystemRoot "C:/Windows"
DefaultInitEnv SystemDrive "C:"
DefaultInitEnv TEMP "C:/WINDOWS/TEMP"
DefaultInitEnv TMP "C:/WINDOWS/TEMP"
DefaultInitEnv windir "C:/WINDOWS"

(Thank Steffen of apachelounge.com for this note)


IPCConnectTimeout n (3 seconds)

The connect timeout to a fastcgi application. 

IPCCommTimeout n (20 seconds)

The communication timeout to a fastcgi application. Please increase this value if your CGI have a slow initialization or slow respond.

OutputBufferSize n (64k bytes)

CGI output cache buffer size.

PHP_Fix_Pathinfo_Enable n(n=0/1, default 0)

If you are using PHP and set cgi.fix_pathinfo=1 in php.ini, set PHP_Fix_Pathinfo_Enable 1.

MaxRequestsPerProcess n (-1)

(Added in version 1.11, patch from Robert L Mathews)

Adds a MaxRequestsPerProcess parameter that allows mod_fcgid to exit after handling a certain number of requests, similar to the existing ProcessLifeTime option. 

This solves a problem with PHP in FastCGI mode. By default, PHP stops accepting new FastCGI connections after handling 500 requests; unfortunately, there is a potential race condition during the PHP cleanup code in which PHP can be shutting down but still have the socket open, so mod_fcgid under heavy load can send request number 501 to PHP and have it "accepted", but then PHP appears to simply exit, causing errors.

If you are using PHP, you should set it to 500. -1 mean fastcgi process will not exit no matter how many requests it has handled.