Go to file
2009-12-21 16:17:31 +00:00
build - Fix bad merge (Sorry Ilia..) 2009-11-28 00:06:54 +00:00
ext magic numbers to macros 2009-12-21 16:17:31 +00:00
main fix bug #50196 2009-12-19 01:13:33 +00:00
netware - This is PHP 6 - if this ... ever gets out 2009-03-10 23:40:06 +00:00
sapi - Fixed bug #50209 (Compiling with libedit cannot find readline.h) 2009-12-13 17:06:47 +00:00
scripts Missed a few - now it really works with autoconf-2.64+ 2009-11-25 01:36:41 +00:00
tests - Fix test 2009-12-14 05:52:49 +00:00
TSRM - Fixed ZTS build 2009-12-08 01:51:34 +00:00
win32 - #50334, add define on win as well 2009-12-10 14:08:19 +00:00
Zend Fixed Unicode support 2009-12-21 15:29:21 +00:00
.gdbinit - Added a function to print all CVs from the local scope. 2009-08-01 12:55:36 +00:00
acconfig.h.in
acinclude.m4 Someone strap down Jani and give him a sedative please. 2009-11-25 01:30:06 +00:00
buildconf - Removed unused parts 2009-07-20 10:51:40 +00:00
buildconf.bat Check if configure script was copied, and output an error if it wasn't 2009-01-02 12:16:42 +00:00
ChangeLog ChangeLog update 2009-07-09 01:34:17 +00:00
ChangeLog.1999.gz
ChangeLog.2000.gz
ChangeLog.2001.gz
ChangeLog.2002.gz
ChangeLog.2003.gz
ChangeLog.2004.gz
ChangeLog.2005.gz
CODING_STANDARDS Multi-branch test commit to see if email notifications are working 2009-07-17 04:26:33 +00:00
config.guess - Upgraded bundled libtool to 1.5.26 2009-11-23 21:54:21 +00:00
config.sub - Upgraded bundled libtool to 1.5.26 2009-11-23 21:54:21 +00:00
configure.in - Fixed bug #50508 (compile fails: Conflicting HEADER type declarations) 2009-12-18 11:02:07 +00:00
CREDITS
EXTENSIONS - Update 2009-02-05 13:45:58 +00:00
footer
genfiles MFB53: genfiles update 2008-03-26 15:05:39 +00:00
header correct year and version 2008-07-26 22:21:12 +00:00
INSTALL cvs->svn 2009-07-13 19:16:26 +00:00
LICENSE - It's 2009 2009-03-11 00:02:40 +00:00
ltmain.sh - Upgraded bundled libtool to 1.5.26 2009-11-23 21:54:21 +00:00
makedist CVS->SVN 2009-07-14 21:49:26 +00:00
Makefile.frag MFB 5.3: Rest of the changes for re2c merge 2008-03-26 14:46:17 +00:00
Makefile.gcov - Drop libsqlite even here 2008-08-03 18:57:06 +00:00
Makefile.global Added newly added removed directives to the makefile 2009-12-16 06:08:38 +00:00
makerpm php5.spec was never used, as far as can be determined. also, php 5 -> php 6 in makerpm, but that script needs considerably more work IMO 2009-07-15 07:04:43 +00:00
NEWS pff 2009-10-06 10:00:53 +00:00
php.gif change these in HEAD too 2006-03-07 16:47:19 +00:00
php.ini-development Make sure that max_file_uploads is set to 20 by-default in all places 2009-11-05 13:29:34 +00:00
php.ini-production Make sure that max_file_uploads is set to 20 by-default in all places 2009-11-05 13:29:34 +00:00
README.EXT_SKEL
README.EXTENSIONS
README.input_filter
README.MAILINGLIST_RULES - mention rfc 1855 2008-01-17 14:37:58 +00:00
README.namespaces - Changed namespace separator 2009-04-03 14:36:50 +00:00
README.NEW-OUTPUT-API - revise output handler alias API 2006-08-30 07:39:09 +00:00
README.PARAMETER_PARSING_API Restored double->long conversion behavior to that of PHP 5.2 (on most platforms) and prior: 2009-06-04 18:18:47 +00:00
README.PEAR Apparenty go-pear no longer exists (bug#44699) 2008-04-11 21:53:37 +00:00
README.PHP4-TO-PHP5-THIN-CHANGES
README.QNX
README.REDIST.BINS - MF53: add licenses info for bundled libs, codes merged from other projects, etc., information for binary distributions (windows, linux, etc.) 2009-06-24 11:48:44 +00:00
README.RELEASE_PROCESS expanded the section about how to create the changelog 2009-06-30 14:24:15 +00:00
README.SELF-CONTAINED-EXTENSIONS
README.STREAMS
README.SUBMITTING_PATCH Mention account access so we can refer account-requestors to this README 2009-11-20 21:52:02 +00:00
README.SVN-RULES - cvs->svn 2009-07-14 09:37:57 +00:00
README.TESTING clarification of wwwhether 'make test' needs the PHP xecutable to be set 2009-03-20 15:43:11 +00:00
README.TESTING2 Fixed bug#46445 (run-tests2.php is missing or README.TESTING2 is unneeded) 2008-11-05 17:15:37 +00:00
README.UNICODE - Fix small typo 2009-08-09 03:39:15 +00:00
README.UNICODE-UPGRADES Fix small typo 2008-03-10 14:27:07 +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 typo (closes bug #43943) 2008-02-22 17:15:57 +00:00
README.Zeus
run-tests.php - Sync (and KEEP it synced!) 2009-12-21 15:44:58 +00:00
server-tests-config.php
server-tests.php - This is PHP 6 - if this ... ever gets out 2009-03-10 23:40:06 +00:00
snapshot
stamp-h.in
stub.c
svnclean.bat - rename to svn 2009-07-13 16:08:08 +00:00
TODO Update 2009-06-28 18:00:38 +00:00
TODO-5.1
TODO-PHP5
unicode-gotchas.txt Add note about md5(). 2006-03-03 22:46:55 +00:00
unicode-issues.txt
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 Implement JIT request decoding support for $_GET and $_POST. 2009-05-23 18:03:27 +00:00
vcsclean dropped some more mime types, svnclean -> clean for multiple VCS 2009-07-16 04:43:18 +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'