Go to file
2003-06-25 00:18:01 +00:00
build updating license information in the headers. 2003-06-10 20:04:29 +00:00
ext enable sqlite by default 2003-06-25 00:18:01 +00:00
main Fixed typo. 2003-06-24 14:36:01 +00:00
netware updating license information in the headers. 2003-06-10 20:04:29 +00:00
pear * Fix for bug #23954 2003-06-22 19:14:16 +00:00
regex centralize #include "build-defs.h" and drop (sometimes inconsistent) other 2002-10-24 13:15:49 +00:00
sapi Simplify/fix logging 2003-06-16 19:11:33 +00:00
scripts - Unified PHP_SETUP_OPENSSL with other PHP_SETUP_* macros. 2003-06-24 14:05:26 +00:00
tests Add test case for final classes 2003-06-21 22:02:16 +00:00
TSRM bring head into sync with the php4 branch 2003-06-23 01:27:13 +00:00
win32 Remove references to bundled libmysql. 2003-06-23 04:27:11 +00:00
Zend ChangeLog update 2003-06-24 00:30:11 +00:00
.gdbinit Fixed printzn part. 2003-05-05 11:43:50 +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 Fix configure failure with static openssl libs 2003-06-24 16:39:52 +00:00
buildconf cleanup 2003-05-19 11:54:00 +00:00
ChangeLog ChangeLog update 2003-06-22 00:31:09 +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
ChangeLog.2001.gz * archive the 2001 changelog 2002-01-06 05:19:43 +00:00
ChangeLog.2002.gz rotate changelog 2003-01-02 18:48:06 +00:00
CODING_STANDARDS - Update codinf standards with the posted RFC (results from PEAR Meeting) 2003-05-23 10:38:43 +00:00
config.guess upgrade files to libtool 1.4.3 shipped ones 2002-11-14 00:41:53 +00:00
config.sub upgrade files to libtool 1.4.3 shipped ones 2002-11-14 00:41:53 +00:00
configure.in - Unified PHP_SETUP_OPENSSL with other PHP_SETUP_* macros. 2003-06-24 14:05:26 +00:00
CREDITS Let's pretend this is up-to-date now 2002-04-22 14:45:13 +00:00
cvsclean "User interface" for removing all files which are ignored by cvs 2000-03-06 16:02:01 +00:00
EXTENSIONS Somehow i feel like that 2003-06-22 16:32:58 +00:00
footer consistent with the used style 2003-02-20 00:19:04 +00:00
genfiles - Hope this is the last commit in the series. Make sure that the .h file 2002-05-27 14:47:03 +00:00
header updating license information in the headers. 2003-06-10 20:04:29 +00:00
INSTALL Fix Bug #21892 (links to apache2 install instructions missing) 2003-02-01 11:18:53 +00:00
LICENSE Bump year. 2002-12-31 15:59:15 +00:00
ltmain.sh - Updated libtool to 1.4.3 which has test for the sed problem.. 2003-02-10 17:09:48 +00:00
makedist --force here too for release packages 2003-05-22 00:31:31 +00:00
Makefile.frag - Fixed bug: #13561 (--without-pear prevents install of phpize, php-config) 2003-01-28 10:59:12 +00:00
Makefile.global MFH 4.3; tell the users that the tmpnam stuff is ok. 2003-05-18 23:52:09 +00:00
makerpm - Fix a path and remove --with-imap 2002-03-04 10:45:30 +00:00
NEWS Nothing to see here, move along. 2003-06-16 19:58:24 +00:00
php4.spec.in 2 years is ages.... and no way temporary. changed the php4 logo to a versionless one. 2002-02-01 09:20:11 +00:00
php.gif 2 years is ages.... and no way temporary. changed the php4 logo to a versionless one. 2002-02-01 09:20:11 +00:00
php.ini-dist Make the default mysql connection timeout 60 seconds rather then unlimited. 2003-06-18 15:19:16 +00:00
php.ini-recommended Make the default mysql connection timeout 60 seconds rather then unlimited. 2003-06-18 15:19:16 +00:00
README.CVS-RULES - Bah, Jani needs to be clearer next time ;P 2002-10-31 15:06:18 +00:00
README.EXT_SKEL fix bug #22841 2003-03-24 12:16:03 +00:00
README.EXTENSIONS * zend_module_entry change: apino, debug and zts are moved first, 2001-10-11 23:33:59 +00:00
README.input_filter An input filter might not simply strip stuff, it might also turn things 2003-02-20 22:21:49 +00:00
README.PARAMETER_PARSING_API - Whitespace 2003-01-03 10:39:22 +00:00
README.QNX PHP 4.0 1999-04-07 21:05:13 +00:00
README.SELF-CONTAINED-EXTENSIONS Improve the wording in this paragraph. 2002-10-23 21:35:17 +00:00
README.STREAMS Added notes about locking functions. 2003-03-04 21:46:33 +00:00
README.SUBMITTING_PATCH typo 2002-11-14 20:57:48 +00:00
README.TESTING Correcting example to use proper variable - NO_INTERACTION 2003-03-19 18:04:17 +00:00
README.TESTING2 many new enhancements to run-tests that allow for testing cgi and other 2003-03-25 07:45:18 +00:00
README.UNIX-BUILD-SYSTEM Correct spelling. 2002-10-23 21:46:40 +00:00
README.Zeus Update build instructions for Zeus web server 2003-03-05 11:50:18 +00:00
run-tests2.php updating license information in the headers. 2003-06-10 20:04:29 +00:00
run-tests-config.php many new enhancements to run-tests that allow for testing cgi and other 2003-03-25 07:45:18 +00:00
run-tests.php updating license information in the headers. 2003-06-10 20:04:29 +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 done. 2003-05-30 22:32:37 +00:00
TODO-PHP5 The basic input filtering framework is done and working nicely 2003-02-27 18:45:37 +00:00
TODO.BUILDv5 phpize is already working, remove from todo 2002-03-07 14:49:16 +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 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'