Skip to content

Commit

Permalink
Update build instructions for Zeus web server
Browse files Browse the repository at this point in the history
  • Loading branch information
Ben Mansell committed Mar 5, 2003
1 parent 26dd849 commit 7af6973
Showing 1 changed file with 10 additions and 24 deletions.
34 changes: 10 additions & 24 deletions README.Zeus
Original file line number Diff line number Diff line change
Expand Up @@ -21,29 +21,13 @@ If you have any problems, please check the support site for more
up-to-date information and advice.


Quick guide to installing FastCGI with Zeus
-------------------------------------------
Quick guide to installing CGI/FastCGI with Zeus
-----------------------------------------------

Step 1 - obtain and install FastCGI development kit.

Grab the package from:
http://www.fastcgi.com/dist/devkit_2.2.0.tar.gz

Extract the package and follow the instructions:
./configure
make
make export
(run the last as root)

This will install to /usr/local/lib/libfcgi.a
and /usr/local/include/*fcgi*



Step 2 - Compile PHP as FastCGI.
Step 1 - Compile PHP as FastCGI.

Compile as follows:
./configure --with-fastcgi
./configure --enable-fastcgi
make

Note that PHP has many options to the configure script -
Expand All @@ -55,7 +39,7 @@ program called 'php'. Copy this into your document root, under a
dedicated FastCGI directory (e.g. $DOCROOT/fcgi-bin/php)


Step 3 - configure Zeus
Step 2 - configure Zeus

Four stages:
- enable FastCGI
Expand Down Expand Up @@ -98,16 +82,18 @@ Click 'update' to commit these changes
Finally restart your virtual server for these changes to take effect.


Step 4 - start PHP as a FastCGI runner
Step 3 - start PHP as a FastCGI runner

When you start PHP, it will pre-fork a given number of child processes
to handle incoming PHP requests. Each process will handle a given
number of requests before exiting (and being replaced by a newly
forked process). You can control these two parameters by setting the
following environment variables BEFORE starting the FastCGI runner:

PHP_FCGI_CHILDREN - the number of child processes to pre-fork. If not
set, defaults to 8.
PHP_FCGI_CHILDREN - the number of child processes to pre-fork. This
variable MUST be set, if not then the PHP will not run as a FastCGI.
We recommend a value of 8 for a fairly busy site. If you have many,
long-running PHP scripts, then you may need to increase this further.

PHP_FCGI_MAX_REQUESTS - the number of requests each PHP child process
handles before exiting. If not set, defaults to 500.
Expand Down

0 comments on commit 7af6973

Please sign in to comment.