diff --git a/chapters/install.xml b/chapters/install.xml index b8a5058ebe..4b6cbf5592 100644 --- a/chapters/install.xml +++ b/chapters/install.xml @@ -86,61 +86,77 @@ - - - Configuration - - - There are two ways of configuring PHP. - - - - Using the "setup" script that comes with PHP. This script - asks you a series of questions (almost like the "install" - script of PHP/FI 2.0) and runs "configure" in the end. To run - this script, type ./setup. - - - This script will also create a file called "do-conf", this - file will contain the options passed to configure. You can - edit this file to change just a few options without having to - re-run setup. Then type ./do-conf to run - configure with the new options. - - - - - Running configure by hand. To see what options you have, type - ./configure --help. - - - - - - Details about some of the different configuration options are - listed below. - - - Apache module - + Apache Module - To build PHP as an Apache module, answer "yes" to "Build as an - Apache module?" (the - option to configure) and specify the Apache distribution base - directory. If you have unpacked your Apache distribution in - /usr/local/www/apache_1.2.4, this is - your Apache distribution base directory. The default directory - is /usr/local/etc/httpd. + PHP can be compiled in a number of different ways. Here is a + quick summary: + + +./configure --with-apxs --with-pgsql + + + + + This will create a libphp4.so shared library + that is loaded into Apache using a LoadModule line in Apache's + httpd.conf file. The PostgreSQL support is + embedded into this libphp4.so library. + + + + +./configure --with-apxs --with-pgsql=shared + + + + + This will again create a libphp4.so shared + library for Apache, but it will also create a + pgsql.so shared library that is loaded into + PHP either by using the extension directive in + php.ini file or by loading it explicitly in + a script using the dl function. + + + + +./configure --with-apache=/path/to/apache_source --with-pgsql + + + + + This will create a libmodphp4.a library, a + mod_php4.c and some accompanying files and + copy this into the src/modules/php4 directory + in the Apache source tree. Then you compile Apache using + --activate-module=src/modules/php4/libphp4.a + and the Apache build system will create + libphp4.a and link it statically into the + httpd binary. The PostgreSQL support is + included directly into this httpd binary, so + the final result here is a single httpd + binary that includes all of Apache and all of PHP. + + + + +./configure --with-apache=/path/to/apache_source --with-pgsql=shared + + + + + Same as before, except instead of including PostgreSQL support + directly into the final httpd you will get a + pgsql.so shared library that you can load + into PHP from eihter the php.ini file or + directly using dl. - fhttpd module + fhttpd Module To build PHP as an fhttpd module, answer "yes" to "Build as an