xref: /PHP-5.4/sapi/aolserver/README (revision f4983c0d)
1AOLserver README ($Id$)
2
3To compile PHP 4.0 as a module for AOLserver, you need:
4
5- installed AOLserver 3.1 or later
6  (see the note below for AOLserver 3.0)
7
8NOTE: You should not use this module in production. PHP is not 100% stable
9      yet in threaded mode. To increase reliability enable the Global Lock
10      by removing #define NO_GLOBAL_LOCK in main/main.c. Also don't use
11      php_value as it will lead to races in a sub-system (use an ini file
12      instead).
13
14
151.) Configuring AOLserver
16
17Read doc/install.txt in the source distribution
18
19It usually boils down to changing the INST/PREFIX variable in
20include/Makefile.global and running make all install.
21
222.) Configuring PHP
23
24$ ./configure \
25	--with-aolserver=/path/to/installed/aolserver \
26	<other options>
27
28NOTE: If you are still using AOLserver 3.0, you need to retain the
29      AOLserver source code and pass another option to PHP:
30
31      --with-aolserver-src=/path/to/source/distribution
32
333.) Compiling and Installing PHP
34
35$ make install
36
374.) Changing nsd.tcl
38
39a) New section
40
41Add a new section to pass options to PHP (required):
42
43ns_section "ns/server/${servername}/module/php"
44
45You can use the following commands in this section:
46
47The 'map' command will cause AOLserver to pass all requests to *.php to
48the PHP module (can be specified multiple times).  Example:
49
50ns_param map *.php
51
52The 'php_value "name val"' command assigns the configuration option name
53the value val (can be used multiple times). Example:
54
55ns_param php_value "session.auto_start 1"
56
57b) Enabling PHP
58
59Then enable the PHP module:
60
61ns_section "ns/server/${servername}/modules"
62...
63ns_param php ${bindir}/libphp5.so
64
65
66=============================================================================
67This has been tested with AOLserver release 3.0.
68
69AOLserver support has been written by Sascha Schumann <sascha@schumann.cx>.
70