Go to file
Jeroen van Wolffelaar 8ec9e5bca0 Fix parse-error
2001-09-26 08:41:05 +00:00
build add missing dependency 2001-09-19 08:56:58 +00:00
ext Fix parse-error 2001-09-26 08:41:05 +00:00
main Back-substitute for Z_* macro's. If it breaks some extension (the script isn't optimal, it parses for example var->zval.value incorrect) please let me know. 2001-09-25 21:58:48 +00:00
pear * hopefully the only changes required for the initials->user rename 2001-09-04 03:34:59 +00:00
regex Remove trailing empty lines 2000-05-01 22:38:42 +00:00
sapi Back-substitute for Z_* macro's. If it breaks some extension (the script isn't optimal, it parses for example var->zval.value incorrect) please let me know. 2001-09-25 21:58:48 +00:00
scripts Now fixes virtually everything. 2001-09-26 08:32:55 +00:00
tests More tests 2001-08-05 18:38:48 +00:00
TSRM Kill unnecessary quoting, and set host_alias to host, if only the latter 2001-09-19 09:01:05 +00:00
win32 fix release_ts_dbg libpath 2001-09-25 17:16:27 +00:00
Zend Keep ZEND_CHANGES up-to-date. 2001-09-22 17:03:05 +00:00
acconfig.h.in Wipe out acconfig.h.in and rewrite some checks to use PHP_ARG_ENABLE. 2000-06-08 06:14:58 +00:00
acinclude.m4 Always quote the messages. 2001-09-06 20:55:24 +00:00
apidoc-zend.txt Close bug #7325. Patches by djm@web.us.uu.net. 2000-10-19 15:05:44 +00:00
apidoc.txt I think that is the preferred way as of now 1999-05-28 18:51:51 +00:00
buildconf Build compat bridge for makes which support only the BSD .include command. 2000-09-26 11:19:38 +00:00
ChangeLog ChangeLog update 2001-09-26 00:10:05 +00:00
ChangeLog.1999.gz * separated and compressed changelogs from 1999 and 2000 2001-04-13 23:33:49 +00:00
ChangeLog.2000.gz * separated and compressed changelogs from 1999 and 2000 2001-04-13 23:33:49 +00:00
CODING_STANDARDS vim-6 does folding - clean up a bunch of missing folding tags plus 2001-06-05 13:12:10 +00:00
config.guess Upgrade to libtool 1.4. 2001-05-06 18:49:09 +00:00
config.sub Upgrade to libtool 1.4. 2001-05-06 18:49:09 +00:00
configure.in Remove obselete message and drop "divert(6)" which caused 2001-09-11 07:30:45 +00:00
CREDITS - Update link 2000-10-05 22:22:26 +00:00
cvsclean "User interface" for removing all files which are ignored by cvs 2000-03-06 16:02:01 +00:00
dynlib.m4 - Fix copyright notices with 2001 2001-02-26 06:11:02 +00:00
EXTENSIONS added me and myself 2001-08-16 19:59:08 +00:00
footer * expanded the following constants and made them available in PHP: 2001-04-22 01:09:14 +00:00
genfiles Remove redundant files 2001-08-16 23:58:56 +00:00
header add year 2001 to header 2001-02-18 09:21:57 +00:00
INSTALL Added a note about --enable-versioning working with IRIX 6.5 2000-12-11 16:21:19 +00:00
LICENSE Sigh, that should be the last one :I 2000-05-22 16:56:22 +00:00
ltmain.sh Upgrade to libtool 1.4. 2001-05-06 18:49:09 +00:00
makedist - No need to generate number.c and number.h anymore. 2000-12-18 16:53:46 +00:00
Makefile.in * tidy up "make install" output 2001-08-28 13:07:33 +00:00
makerpm This file needed an update.. 2001-06-29 02:32:19 +00:00
NEWS - Fix NEWS 2001-09-26 07:59:04 +00:00
php4.gif temporary icon for RPMs until Colin gets back and can make us a spiffy new one 1999-07-24 19:00:06 +00:00
php4.spec.in added workaround for Solaris PIC weirdness. 1999-07-24 19:02:38 +00:00
php.ini-dist revert bad commit 2001-09-05 19:48:28 +00:00
php.ini-recommended revert bad commit 2001-09-05 19:48:28 +00:00
README.CVS-RULES One more notice about using names with NEWS entries. 2001-02-05 17:11:32 +00:00
README.EXT_SKEL We no longer need any FETCH's for internal functions 2001-08-02 05:49:24 +00:00
README.QNX PHP 4.0 1999-04-07 21:05:13 +00:00
README.SELF-CONTAINED-EXTENSIONS Add note about software requirements 2000-07-31 13:44:06 +00:00
README.STREAMS Information about php streams 2001-04-18 10:43:21 +00:00
README.Zeus Altered README.Zeus to give instructions on building FastCGI. 2001-03-19 11:23:57 +00:00
RELEASE_PROCESS Adding readme for release process, this needs to live somewhere and here seems as good a place as any. 2001-01-31 13:58:20 +00:00
run-tests.php * typo 2001-08-27 20:37:06 +00:00
snapshot Integration of -ng changes. Changes: 1999-12-30 02:59:53 +00:00
stamp-h.in # Fix ColorResolve bogosity 1999-11-21 04:07:56 +00:00
strtok_r.c Get Win32 to compile again 1999-11-27 00:48:50 +00:00
stub.c Add newline. Recent GCC snapshots segfault, if the input file is completely 2000-12-01 13:57:24 +00:00
TODO Add TODO for DLSYM_NEEDS_UNDRESCORE 2001-08-23 09:18:21 +00:00
TODO-4.2.txt I'll stop annoying the list if this doesn't shed light :) 2001-09-08 00:11:12 +00:00

Using PHP4 with the Zeus Web Server
-----------------------------------

Zeus fully supports running PHP in combination with our
webserver. There are three different interfaces that can be used to
enable PHP:

* CGI
* ISAPI
* FastCGI

Of the three, we recommend using FastCGI, which has been tested and
benchmarked as providing the best performance and reliability.

Full details of how to install PHP are available from our
website, at:

http://support.zeus.com/products/php.html

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
-------------------------------------------

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.

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

Note that PHP has many options to the configure script -
e.g. --with-mysql. You will probably want to select your usual options
before compiling; the above is just a bare minimum, for illustration.

After compilation finishes, you will be left with an executable
program called 'php'. Copy this into your document root, under a
dedicated FastCGI directory (e.g. $DOCROOT/fcgi-bin/php)


Step 3 - configure Zeus

Four stages:
        -  enable FastCGI
        -  configure FastCGI
        -  setup alias for FastCGI
        -  setup alias for PHP

1) Using the admin server, go to the 'module configuration' page for
your virtual server, and ensure that 'fastcgi' is enabled (select the
tickbox to the left).

2) While we can run FastCGI's locally, there are known problems with
some OS's (specifically, the communication between web server and
FastCGI happens over a unix domain socket, and some OS's have trouble
sustaining high connection rates over these sockets). So instead, we
are going to set up the PHP FastCGI to run 'remotely' over localhost
(this uses TCP sockets, which do not suffer this problem). Go to the
'fastcgi configuration' page, and under 'add remote fastcgi':
        Add Remote FastCGI
                Docroot path            /fcgi-bin/php
                Remote machine          localhost:8002
The first entry is where you saved PHP, above.
The second entry is localhost:<any unused port>
We will start the FastCGI listening on this port shortly.
Click 'update' to commit these changes.

3) Go to the path mapping module and add an alias for FastCGI:
        Add Alias
                Docroot path            /fcgi-bin
                Filesystem directory    /path/to/docroot/fcgi-bin
                Alias type              fastcgi
Click 'update' to commit these changes

4) Also on the path mapping module, add a handler for PHP:
        Add handler
                File extension          php
                Handler                 /fcgi-bin/php
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

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_MAX_REQUESTS - the number of requests each PHP child process
handles before exiting. If not set, defaults to 500.

To start the FastCGI runner, execute '$ZEUSHOME/web/bin/fcgirunner
8002 $DOCROOT/fcgi-bin/php'.  Substitute the appropriate values for
$ZEUSHOME and $DOCROOT; also substitute for 8002 the port you chose,
above.

To stop the runner (e.g. to experiment with the above environment
variables) you will need to manually stop and running PHP
processes. (Use 'ps' and 'kill'). As it is PHP which is forking lots
of children and not the runner, Zeus unfortunately cannot keep track
of what processes are running, sorry. A typical command line may look
like 'ps -efl | grep $DOCROOT/fcgi-bin/php | grep -v grep | awk
'{print $4}' | xargs kill'