Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / php / sapi / aolserver

Annotation of embedaddon/php/sapi/aolserver/README, revision 1.1.1.2

1.1.1.2 ! misho       1: AOLserver README ($Id$)
1.1       misho       2: 
                      3: To 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: 
                      8: NOTE: 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: 
                     15: 1.) Configuring AOLserver
                     16: 
                     17: Read doc/install.txt in the source distribution
                     18: 
                     19: It usually boils down to changing the INST/PREFIX variable in 
                     20: include/Makefile.global and running make all install.
                     21: 
                     22: 2.) Configuring PHP
                     23: 
                     24: $ ./configure \
                     25:        --with-aolserver=/path/to/installed/aolserver \
                     26:        <other options>
                     27: 
                     28: NOTE: 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: 
                     33: 3.) Compiling and Installing PHP
                     34: 
                     35: $ make install
                     36: 
                     37: 4.) Changing nsd.tcl
                     38: 
                     39: a) New section
                     40: 
                     41: Add a new section to pass options to PHP (required):
                     42: 
                     43: ns_section "ns/server/${servername}/module/php"
                     44: 
                     45: You can use the following commands in this section:
                     46: 
                     47: The 'map' command will cause AOLserver to pass all requests to *.php to
                     48: the PHP module (can be specified multiple times).  Example:
                     49: 
                     50: ns_param map *.php
                     51: 
                     52: The 'php_value "name val"' command assigns the configuration option name 
                     53: the value val (can be used multiple times). Example:
                     54: 
                     55: ns_param php_value "session.auto_start 1"
                     56: 
                     57: b) Enabling PHP
                     58: 
                     59: Then enable the PHP module:
                     60: 
                     61: ns_section "ns/server/${servername}/modules"
                     62: ...
                     63: ns_param php ${bindir}/libphp5.so
                     64: 
                     65: 
                     66: =============================================================================
                     67: This has been tested with AOLserver release 3.0.
                     68: 
                     69: AOLserver support has been written by Sascha Schumann <sascha@schumann.cx>.