php/sapi/aolserver

AOLserver README ($Id$)

To compile PHP 4.0 as a module for AOLserver, you need:

- AOLserver 3.0 source distribution
- installed AOLserver 3.0 

1.) Configuring AOLserver

Read doc/install.txt in the source distribution

It usually boils down to changing the INST path in include/Makefile.global
and running make all install.

2.) Configuring PHP

$ ./configure \
	--with-aolserver=/path/to/installed/aolserver \
	--with-aolserver-src=/path/to/source/distribution \
	<other options>

NOTE: While AOLserver 3.0 did not install its include directory, later
      releases will do so. This effectively means that you do not need
      to retain the source directory of AOLserver, if there is an
      include directory in the installation directory.

3.) Compiling and Installing PHP

$ make install

4.) Changing nsd.tcl

a) New section

Add a new section to pass options to PHP (required):

ns_section "ns/server/${servername}/module/php"

You can use the following commands in this section:

The 'map' command will cause AOLserver to pass all requests to *.php to
the PHP module (can be specified multiple times).  Example:

ns_param map *.php

The 'php_value "name val"' command assigns the configuration option name 
the value val (can be used multiple times). Example:

ns_param php_value "session.auto_start 1"

b) Enabling PHP

Then enable the PHP module:

ns_section "ns/server/${servername}/modules"
...
ns_param php ${bindir}/libphp4.so


=============================================================================
This has been tested with AOLserver release 3.0.

AOLserver support has been written by Sascha Schumann <sascha@schumann.cx>.