Go to file
2001-01-07 21:21:12 +00:00
build Run run-tests.php in srcdir and add top_builddir/pear to the include 2000-12-24 16:03:16 +00:00
ext Minor changes to LDAP_OPT constants, and added support for controls to 2001-01-07 21:18:02 +00:00
main Fix CGI build 2001-01-07 18:56:24 +00:00
pear Fix typo. This one was my fault, anyway. 2001-01-07 05:24:21 +00:00
regex Remove trailing empty lines 2000-05-01 22:38:42 +00:00
sapi make threaded apache module build again 2001-01-05 17:00:07 +00:00
scripts filename wildcards in a c comment were a bad idea 2000-11-23 06:58:14 +00:00
tests Sync the expected output with Linux dirname output. The test passes now. 2000-12-24 14:40:37 +00:00
TSRM Add Release_TSDbg to TSRM as well 2001-01-07 18:28:03 +00:00
win32 finally remove -S option from bison 2001-01-05 18:06:24 +00:00
Zend Fix mismatch in return values 2001-01-07 19:04:02 +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 Made OpenSSL extension work with 0.9.5 and changed version check to 0.9.5 2001-01-07 11:36:15 +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-01-07 02:09:09 +00:00
CODING_STANDARDS Updated to reflect recent discussions on php-dev. 2000-12-19 06:22:07 +00:00
config.guess Upgrade to Libtool 1.3.5. 2000-06-11 10:26:24 +00:00
config.sub Upgrade to Libtool 1.3.5. 2000-06-11 10:26:24 +00:00
configure.in Changed OpenSSL requirements from 0.9.6 to 0.9.5 2001-01-07 21:21:12 +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 LTLIBRARY_DEPENDENCIES might depend on variables defined in config_vars.mk, 2000-10-30 14:29:51 +00:00
EXTENSIONS Changing my email address... 2001-01-04 11:15:35 +00:00
footer PHP 4.0 1999-04-07 21:05:13 +00:00
FUNCTION_LIST.txt PHP 4.0 1999-04-07 21:05:13 +00:00
genfiles Update to reflect the changes in the parsers/scanners 2000-11-02 23:05:32 +00:00
header fix license version number in sample header 2000-05-28 19:17:59 +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
ltconfig Should be ok to use CC here 2000-11-04 02:42:10 +00:00
ltmain.sh Temporary fix for mac os x stuff. 2000-10-26 17:58:11 +00:00
makedist - No need to generate number.c and number.h anymore. 2000-12-18 16:53:46 +00:00
Makefile.in Change directory name from core to main. 2000-06-11 18:51:17 +00:00
makerpm Small fix: Description still referred to package as PHP3. 2000-05-01 04:49:49 +00:00
NEWS NEWS update 2001-01-03 02:09:13 +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 Make this comment readable. 2001-01-02 21:37:21 +00:00
php.ini-optimized Make this comment readable. 2001-01-02 21:37:21 +00:00
php.ini-recommended Make this comment readable. 2001-01-02 21:37:21 +00:00
README.BCMATH Moving README-BCMATH to README.BCMATH 2000-05-03 04:57:11 +00:00
README.CVS-RULES MAINTAINERS has become EXTENSIONS 2000-07-26 02:10:18 +00:00
README.EXT_SKEL support for short comments was added to ext_skel proto files 2000-10-31 11:30:11 +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.Zeus Further updates to README.Zeus 2000-11-10 16:14:00 +00:00
run-tests.php Fix "make test" in VPATH environments 2000-12-24 14:24:04 +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 a reminder about #3149 2000-12-17 09:27:42 +00:00

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

Zeus fully supports running PHP in combination with our webserver. A
significant improvement in PHP 4 is that you can now run PHP as an
ISAPI module, giving great performance benefits over traditional CGI
code.

Note that you will need to be running at least version 3.3.6 of the
webserver. If you are running an earlier version, please see our
website (http://www.zeus.com) for upgrade instructions.


To build the ISAPI version of PHP, start the configuration with:

./configure --with-zeus=/usr/local/zeus

Obviously, replace /usr/local/zeus with the location of where you have
installed Zeus on your machine. For PHP to build successfully, you
need to have 3.3.6 already installed, because the code relies on the
presence of header files provided with the latest version.

You may have to adjust the environment variable LDFLAGS and EXTRA_LIBS
in order to link in extra libraries. This depends on the platform on
which you are building and also on the compiler used (see below). A
standard GNU/Linux install with GCC should build fine with no changes.


Configuring the webserver
-------------------------

After running 'make' and 'make install', you will have a 'libphp4.so'
file. Copy this file into a directory reserved for ISAPI
binaries. Now, perform the following steps for each virtual server
that you wish to run PHP on:

1) On the Admin server, go to 'edit server->path mapping'
2) Add an alias to the directory with libphp4.so in it, mapped to
   /isapi/ (or a location of your choice). Make sure you set the alias
   type to ISAPI.
3) Click 'update'
4) Add a handler for file extension 'php' to be run by /isapi/libphp4.so
5) Click 'update', then go back to the previous page.
6) Click on the 'module configuration' button, ensure that ISAPI
   support is ticked.
7) Click on the ISAPI link. At the bottom of the page, click the
   checkbox for running ISAPI extensions 'out of process'.
8) Click 'update'. Then restart the virtual server. Done!


Troubleshooting
---------------

*) Why does the compile fail at Zend/zend-scanner-cc.cc
                             or Zend/zend-parser.c ?

These source files are auto-generated from the corresponding .y files.
The default distribution of PHP contains pre-generated versions of these
files that have caused problems for some people. The simplest solution is
to delete the files. They will then be rebuilt correctly. You must have the
following GNU tools to do this:

       bison  1.28 or later
       flex  2.5.4 or later

*) Why does my PHP library fail to load?

After configuring Zeus, if you get a '502 Bad Gateway' error when
accessing a PHP page, there are problems loading the PHP
library. Check the error log ($ZEUSHOME/web/log/errors) for errors.

Failing to load the PHP ISAPI module is likely to be due to unresolved
symbols in the module. A way to check for this is to visit our support
page at http://support.zeus.com/faq/entries/isapi_error.html and run
the program there on your libphp4.so. It will list any unresolved
symbols.

*) My libphp4.so has unresolved symbols. How do I fix this?

You must ensure that the PHP build process links in the appropriate
libraries that contain these symbols! The libraries required will
depend on the platform you are running PHP on.

You may need to set one or two environment variables before running
the 'configure' program to set up PHP; LDFLAGS and EXTRA_LIBS. Make
sure that you also export these variables to the build process.
(Type 'export LDFLAGS EXTRA_LIBS' in the shell to do this.)

If you are using 3rd party tools and libraries which are installed
in non-standard locations, you may need to set the environment
variable LD_LIBRARY_PATH to point to the library's location, prior
to running the Zeus Web Server. For example, if you have compiled
external MySQL support, and mysql is installed in /usr/local/mysql,
you should set LD_LIBRARY_PATH to '/usr/local/mysql/lib/mysql'
and then 'export LD_LIBRARY_PATH'. For convenience, you should add
this to the 'start-zeus' script provided.

Yet another method of ensuring the linked libraries are found is to
set the environment variable LD_RUN_PATH before compiling PHP. This
works in a similar way to LD_LIBRARY_PATH, but at compile-time.
Libraries produced with this envrionment variable set will have its
value 'burned' into the resultant binary, specifying a runtime
search pth to locate other required libraries such as MySQL.

On Linux, you can also tell the dynamic linker where to find the
libraries, by adding '/usr/local/mysql/lib/mysql' to the file 
/etc/ld.so.conf - after editting this file, run 'ldconfig' as root,
to use the changes.


Specific examples:

Solaris + gcc:
Ensure you run ./configure with the `--enable-libgcc' parameter. You
may need to set LDFLAGS to '-L/usr/local/egcs/lib' (path depends on
your gcc installation)

FreeBSD 4:
Some people may find they need to run ./configure with the
'--enable-libgcc' compile option too.


Performance issues
==================

To make PHP run fast under Zeus, check the following points:

1) Run PHP as an ISAPI module, not a CGI - compile it with the --with-zeus=...
   flag!

2) Tune the ISAPI runner to your required workload. There are several
   tuneables that can be given. These are set by adding the appropriate
   lines to the $ZEUSHOME/web/global.cfg file. Changes to this file will only
   be picked up after the web server is restarted (run stop-zeus ; start-zeus)

   tuning!modules!isapi!external!maxthreads xxx

   - Sets the maximum number of threads that the ISAPI runner will spawn. If
     further PHP page requests arrive, they will be queued until a current
     page is finished. For busy websites, we suggest increasing this value
     (defaults to 16). Replace the 'xxx' in the above line with the required
     number of threads. Note that the threads are equally shared between
     ISAPI extensions and filters, so if you want to handle 100 concurrent
     PHP page requests, set this tuneable to 200.

   tuning!modules!isapi!external!minthreads xxx

   - Sets the minimum number of threads. Idle threads will be kept in a pool,
     which avoids costly thread creation/deletion.


For more information and help with Zeus, please visit our website:
http://support.zeus.com