Go to file
2008-01-14 05:03:02 +00:00
build MFB:- Updated bundled shtool to 2.0.6 and added "platform" command in it. 2007-04-16 20:50:18 +00:00
ext fix test (make OS-agnostic) 2008-01-14 05:03:02 +00:00
main use correct macro 2008-01-13 22:55:02 +00:00
netware Bump copyright year, 2 of 2. 2007-12-31 07:12:20 +00:00
sapi MFB: fixed test 2008-01-13 17:23:36 +00:00
scripts - Fix problem with non-bash compliant shells 2007-08-24 11:43:42 +00:00
tests fix test 2008-01-10 08:45:54 +00:00
TSRM Bump copyright year, 2 of 2. 2007-12-31 07:12:20 +00:00
win32 add errors when missing dependencies (Steph) 2008-01-10 18:21:23 +00:00
Zend ChangeLog update 2008-01-12 01:31:36 +00:00
.gdbinit - Add print_htptr, print_htstr 2007-05-20 21:45:58 +00:00
acconfig.h.in
acinclude.m4 Document the 'cxx' parameter to PHP_NEW_EXTENSION. 2007-12-31 04:27:47 +00:00
buildconf - Made build system less dependant for the PHP major version to also 2007-07-26 22:45:22 +00:00
buildconf.bat - pass parameters to buildconf.bat over to buildconf.js (#43281) 2007-11-14 01:42:01 +00:00
ChangeLog ChangeLog update 2008-01-14 01:31:35 +00:00
ChangeLog.1999.gz
ChangeLog.2000.gz
ChangeLog.2001.gz
ChangeLog.2002.gz
ChangeLog.2003.gz - Compress 2003 changelog 2004-01-01 11:41:18 +00:00
ChangeLog.2004.gz - Compressed 2004 Changelog 2005-01-10 15:07:51 +00:00
ChangeLog.2005.gz 2005 -> 2006 2006-01-01 12:17:46 +00:00
CODING_STANDARDS - fixed unexpected emphasis in reST parsing due to use of * 2007-11-24 13:55:20 +00:00
config.guess MFB51: Update bundled libtool to version 1.5.20 2005-11-29 21:33:12 +00:00
config.sub MFB51: Update bundled libtool to version 1.5.20 2005-11-29 21:33:12 +00:00
configure.in MFB: allow lcov 1.6 2007-10-05 14:49:40 +00:00
CREDITS
cvsclean Renaming cvsclean target; IRIX make seems to ignore .PHONY 2004-03-14 17:44:36 +00:00
cvsclean.bat
EXTENSIONS update pdo_firebird status 2007-11-14 22:36:50 +00:00
footer
genfiles More files to have #line directives stripped for release 2005-11-08 20:21:35 +00:00
header bump year and license version 2006-01-01 13:10:10 +00:00
INSTALL Rename php5 module to php6. Remove version number from 2007-01-10 23:46:09 +00:00
LICENSE 2005 -> 2006 2006-01-01 12:17:46 +00:00
ltmain.sh MFB51: Update bundled libtool to version 1.5.20 2005-11-29 21:33:12 +00:00
makedist Download pear phar file when making a distribution package 2006-05-12 14:54:16 +00:00
Makefile.frag MFB 2007-05-24 21:43:56 +00:00
Makefile.gcov MFB 2007-01-04 14:12:14 +00:00
Makefile.global - Fix issue with broken shells 2007-08-03 14:01:40 +00:00
makerpm Rename php5 module to php6. Remove version number from 2007-01-10 23:46:09 +00:00
NEWS - Move some entries to 5.3 2007-11-06 09:45:24 +00:00
php5.spec.in - Renamed all *php4* files to *php5*, changed all php4/PHP4 to php5/PHP5 2004-01-17 13:00:38 +00:00
php.gif change these in HEAD too 2006-03-07 16:47:19 +00:00
php.ini-dist - Added ".htaccess" style user-defined php.ini files support for 2007-09-28 02:04:28 +00:00
php.ini-recommended - Added ".htaccess" style user-defined php.ini files support for 2007-09-28 02:04:28 +00:00
README.CVS-RULES - 5.2 is only for bug fixes 2007-11-24 13:52:19 +00:00
README.EXT_SKEL
README.EXTENSIONS
README.input_filter - Fix docs 2005-12-06 02:30:04 +00:00
README.MAILINGLIST_RULES - added rules about real names and signatures 2008-01-11 14:01:52 +00:00
README.namespaces T_IMPORT -> T_USE 2007-11-07 09:14:06 +00:00
README.NEW-OUTPUT-API - revise output handler alias API 2006-08-30 07:39:09 +00:00
README.PARAMETER_PARSING_API - Clarify the difference with * and + args 2007-11-06 09:48:14 +00:00
README.PEAR - if questions, rtfm 2005-08-15 22:18:15 +00:00
README.PHP4-TO-PHP5-THIN-CHANGES new incompatibilities. maybe someone from the doc group will update the 2004-08-24 22:01:58 +00:00
README.QNX
README.RELEASE_PROCESS - Fixed rest warnings 2007-12-19 13:13:27 +00:00
README.SELF-CONTAINED-EXTENSIONS
README.STREAMS
README.SUBMITTING_PATCH Typos found by Petras Kudaras. 2003-12-22 23:45:53 +00:00
README.TESTING typo 2004-04-15 15:27:08 +00:00
README.TESTING2
README.UNICODE remove \u, \U and \C support in single quotes, as they are meant to contain binary data only and no escape sequences except \' 2007-10-03 18:38:35 +00:00
README.UNICODE-UPGRADES - Nicer version 2007-01-19 09:31:52 +00:00
README.UNIX-BUILD-SYSTEM
README.UPDATING_TO_PHP6 - Use the right variable name 2007-05-18 12:38:07 +00:00
README.WIN32-BUILD-SYSTEM Now that it has matured somewhat, don't discourage questions about it 2003-12-23 02:51:18 +00:00
README.Zeus - Change from PHP5 -> PHP 5 2004-02-08 22:49:47 +00:00
run-tests.php - Show info for CL and CGI if both are going to be used 2008-01-06 16:47:50 +00:00
server-tests-config.php - Fix filename 2005-09-19 19:03:38 +00:00
server-tests.php MFB: Leftover: Bump copyright year. 2008-01-01 06:22:15 +00:00
snapshot
stamp-h.in
stub.c
TODO *** empty log message *** 2005-11-20 02:27:49 +00:00
TODO-5.1 test commit 2005-12-11 04:50:47 +00:00
TODO-PHP5 Remove finished tasks 2004-05-28 09:06:56 +00:00
unicode-gotchas.txt Add note about md5(). 2006-03-03 22:46:55 +00:00
unicode-issues.txt Unicode support. 2005-08-11 23:36:07 +00:00
unicode-progress.txt - Update unicode progress on SPL, looks like nearly done, actually all is 2007-01-19 10:19:50 +00:00
unicode-todo.txt *** empty log message *** 2007-01-18 16:45:43 +00:00

Using PHP 5 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 CGI/FastCGI with Zeus
-----------------------------------------------

Step 1 - Compile PHP as FastCGI.

Compile as follows:
        ./configure --enable-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 2 - 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 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. 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.

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'