Go to file
Eric Stewart 86fed7fac7 Add tests:
DOMComment::__construct() with constructor called twice.
DOMDocumentFragment::appendXML() with unbound fragment.
DOMDocumentFragment::appendXML() with unbalanced chunks.
DOMDocumentFragment::__construct() called twice.
DOMDocumentType: basic access to all properties.
DOMDocumentType::name with invalid state.
DOMDocumentType::entities with invalid state.
DOMDocumentType::notations with invalid state.
DOMDocumentType::publicId with invalid state.
DOMDocumentType::publicId with empty value.
DOMDocumentType::systemId with invalid state.
DOMDocumentType::systemId with empty value.
DOMDocumentType::internalSubset with invalid state.
2009-05-26 06:09:18 +00:00
build - Fix the harmless patch that caused harm :) 2009-05-14 21:23:35 +00:00
ext Add tests: 2009-05-26 06:09:18 +00:00
main - MFH: Get rid of the four different versions of zend_extension* and only use 2009-05-18 21:33:38 +00:00
netware MFH: Bump copyright year, 3 of 3. 2008-12-31 11:15:49 +00:00
pear Test - if this works, something is wrong. 2008-11-04 21:25:22 +00:00
sapi MFH: Fix skipif 2009-05-20 10:08:32 +00:00
scripts - MFH: Get rid of the four different versions of zend_extension* and only use 2009-05-18 21:33:38 +00:00
tests MFH 2009-05-07 13:47:43 +00:00
TSRM Fix build 2009-05-19 10:00:12 +00:00
win32 - revert last commit and fix inline 2009-05-04 21:03:20 +00:00
Zend MFH(r-1.103) Expand zend_symtable_update_current_key to allow specifying HashPosition 2009-05-25 01:18:00 +00:00
.gdbinit - MFH Add compiler globals as 2009-01-04 15:20:19 +00:00
.project New math tests. Tested on Windows, Linux and Linux 64 bit 2009-01-12 17:56:28 +00:00
acconfig.h.in
acinclude.m4 MFH:- Fixed bug #47468 (enable cli|cgi-only extensions for embed sapi) 2009-05-09 20:26:51 +00:00
buildconf MFH: - Made build system less major version dependant to ease MFB/MFH 2007-07-26 22:45:59 +00:00
buildconf.bat MFH: Check if configure script was copied, and output an error if it wasn't 2009-01-02 12:18:21 +00:00
ChangeLog ChangeLog update 2005-08-08 05:39:44 +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
CODING_STANDARDS - MFH 2007-11-24 13:55:27 +00:00
config.guess - Update bundled libtool to 1.5.20 2005-11-29 15:58:54 +00:00
config.sub - Update bundled libtool to 1.5.20 2005-11-29 15:58:54 +00:00
configure.in - MFH: Get rid of the four different versions of zend_extension* and only use 2009-05-18 21:33:38 +00:00
CREDITS
cvsclean Renaming cvsclean target; IRIX make seems to ignore .PHONY 2004-03-14 17:44:36 +00:00
cvsclean.bat "Real" cvsclean, works as the unix version does 2003-12-19 12:51:19 +00:00
EXTENSIONS Maintainer file update 2009-04-08 13:31:54 +00:00
footer
genfiles - Give Marcus good old warm and fuzzy feeling.. :) 2008-03-26 15:04:57 +00:00
header Update copyright 2008-02-07 19:39:50 +00:00
INSTALL update install instructions (auto-generated from phpdoc XML sources) 2007-04-20 14:13:47 +00:00
LICENSE - MFH It's 2009 2009-03-11 00:02:52 +00:00
ltmain.sh - Update bundled libtool to 1.5.20 2005-11-29 15:58:54 +00:00
makedist Download pear phar file when making a distribution package 2006-05-12 14:54:10 +00:00
Makefile.frag fix gcov build 2008-03-19 23:24:56 +00:00
Makefile.gcov - MFH Drop libsqlite even here 2008-08-03 18:57:25 +00:00
Makefile.global MFH 2008-08-13 00:53:28 +00:00
makerpm - Change from PHP5 -> PHP 5 2004-02-08 22:49:47 +00:00
NEWS MFH: fix potential segfault when converting phars with metadata to other formats, add test 2009-05-24 18:50:58 +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 fix logo (proper spacing between the letters) 2006-03-06 19:10:19 +00:00
php.ini-development - win extension_dir 2009-05-04 15:20:38 +00:00
php.ini-production - win extension_dir 2009-05-04 15:20:38 +00:00
README.CVS-RULES MFH: State that bugs should be sorted desc. 2008-11-10 22:10:59 +00:00
README.EXT_SKEL update the docs 2008-06-19 17:59:35 +00:00
README.EXTENSIONS
README.input_filter Pierre requested an update to this. I don't think it makes sense to 2006-10-30 17:11:02 +00:00
README.MAILINGLIST_RULES MFH 2008-01-17 14:38:16 +00:00
README.namespaces - MFH: Changed namespace separator 2009-04-03 14:37:02 +00:00
README.PARAMETER_PARSING_API add object-compatible array modes 2008-11-24 18:10:36 +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 MFH: Removed an unnecessary item, that calls for doc builds 2009-04-11 03:42:02 +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 clarification of wwwhether 'make test' needs the PHP xecutable to be set 2009-03-20 15:43:40 +00:00
README.TESTING2 Fixed bug#46445 (run-tests2.php is missing or README.TESTING2 is unneeded) 2008-11-05 17:15:50 +00:00
README.UNIX-BUILD-SYSTEM
README.UPDATE_5_2 update xmlwriter_write_dtd_entity parameters 2007-01-06 18:05:02 +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 MFH: set default value of "precision" ini setting, 2009-05-20 09:22:50 +00:00
server-tests-config.php - MFH Fix filename 2005-09-19 19:03:53 +00:00
server-tests.php MFH: Bump copyright year, 3 of 3. 2008-12-31 11:15:49 +00:00
snapshot
stamp-h.in
stub.c
TODO Removed completed TODO items 2007-05-01 23:04:30 +00:00
TODO-5.1 Slated for PHP 6 2005-11-13 18:02:47 +00:00
TODO-PHP5 Update TODO: filter extension was added 2007-04-25 18:22:43 +00:00
UPGRADING getClosureThis() and $this handling in closures was removed 2009-05-22 03:32:20 +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'