README 1.8 KB

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