php/sapi/aolserver/README

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>

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>.