diff --git a/chapters/install.xml b/chapters/install.xml
index 74e35d829e..31d29dbe8b 100644
--- a/chapters/install.xml
+++ b/chapters/install.xml
@@ -12,89 +12,103 @@
Installation on UNIX systems
-
- This section will guide you through the configuration and
- installation of PHP.
+ This section will guide you through the general configuration and
+ installation of PHP on unix systems. Be sure to investigate any
+ sections specific to your platform or web server before you begin
+ the process.
-
Prerequisite knowledge and software:
-
Basic UNIX skills (being able to operate "make" and a C
- compiler)
+ compiler, if compiling)
- An ANSI C compiler
+ An ANSI C compiler (if compiling)
+
+
+ flex (for compiling)
+
+
+
+
+ bison (for compiling)
+
+
A web server
+
+
+ Any module specific components (such as gd, pdf libs, etc.)
+
+
- There are several ways to compile and configure PHP for the Unix
- platform. The entire configuration process is controlled by the
+ There are several ways to install PHP for the Unix platform, either
+ with a compile and configure process, or through various
+ pre-packaged methods. The user compile and configuration processes
+ are much more complex, so the documentation is more focused on those
+ procedures.
+
+
+
+ The initial PHP setup and configuration process is controlled by the
use of commandline options to the configure
script. This page outlines the usage of the most common options,
but there are many others to play with. Check out the Complete list of configure
- options for an exhaustive rundown.
+ options for an exhaustive rundown. There are several ways
+ to install PHP:
- As an Apache module
+ As an Apache module
- As an fhttpd module
+ As an fhttpd module
For use with AOLServer, NSAPI,
+ linkend="install.otherhttpd">AOLServer, NSAPI,
phttpd, Pi3Web, Roxen, thttpd, or Zeus.
- As a CGI executable
+ As a CGI executable
- Apache Module
+ Apache Module Quick Reference
- PHP can be compiled in a number of different ways as an Apache
- module. First we show the quick instructions. Following this is
- a list of various examples with explanations, to provide an
- overview of how to accomplish certain things.
-
-
-
- You can select arguments to add to the
- configure on line 8 below from the Complete list of configure
- options.
+ PHP can be compiled in a number of different ways, but one of
+ the most popular is as an Apache module. The following is a quick
+ installation overview.
- Quick Installation Instructions (Apache Module Version)
+ Quick Installation Instructions for PHP 4 (Apache Module Version)
1. gunzip apache_1.3.x.tar.gz
@@ -108,168 +122,19 @@
9. make
10. make install
11. cd ../apache_1.3.x
-12. for PHP 3: ./configure --activate-module=src/modules/php3/libphp3.a
- for PHP 4: ./configure --activate-module=src/modules/php4/libphp4.a
+12. ./configure --activate-module=src/modules/php4/libphp4.a
13. make
14. make install
-
- Instead of this step you may prefer to simply copy the httpd binary
- overtop of your existing binary. Make sure you shut down your
- server first though.
-
15. cd ../php-x.x.x
-16. for PHP 3: cp php3.ini-dist /usr/local/lib/php3.ini
- for PHP 4: cp php.ini-dist /usr/local/lib/php.ini
-
- You can edit your .ini file to set PHP options. If
- you prefer this file in another location, use
- --with-config-file-path=/path in step 8.
-
+16. cp php.ini-dist /usr/local/lib/php.ini
17. Edit your httpd.conf or srm.conf file and add:
-
- For PHP 3: AddType application/x-httpd-php3 .php3
- For PHP 4: AddType application/x-httpd-php .php
-
- You can choose any extension you wish here. .php is simply the one
- we suggest. You can even include .html .
+ AddType application/x-httpd-php .php
-
-18. Use your normal procedure for starting the Apache server. (You must
+18. Use your normal procedure for restarting the Apache server. (You must
stop and restart the server, not just cause the server to reload by
use a HUP or USR1 signal.)
-
-
-
-
-
-
-./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 either the php.ini file or
- directly using dl.
-
-
- When choosing to build PHP in different ways, you should consider
- the advantages and drawbacks of each method. Building as a shared
- object will mean that you can compile apache separately, and don't
- have to recompile everything as you add to, or change, PHP.
- Building PHP into apache (static method) means that PHP will
- load and run faster. For more information, see the Apache
- webpage on DSO support.
-
-
-
-
- fhttpd Module
-
- To build PHP as an fhttpd module, answer "yes" to "Build as an
- fhttpd module?" (the
- option to configure) and specify the fhttpd source base
- directory. The default directory is /usr/local/src/fhttpd. If you are
- running fhttpd, building PHP as a module will give better
- performance, more control and remote execution capability.
-
-
-
-
- Other web servers
-
- PHP can be built to support a large number of web servers. Please
- see Server-related
- options for a full list of server-related configure
- options.
-
-
-
-
- CGI/Commandline version
-
- The default is to build PHP as a CGI program. This creates a
- commandline interpreter, which can be used for CGI processing, or
- for non-web-related PHP scripting. If you are running a web
- server PHP has module support for, you should generally go for
- that solution for performance reasons. However, the CGI version
- enables Apache users to run different PHP-enabled pages under
- different user-ids. Please make sure you read through the Security chapter if you are going to
- run PHP as a CGI.
-
-
-
-
- Database Support Options
-
- PHP has native support for a number of databases (as well as
- ODBC). To enable support for the various databases, options are
- given to the configure script at compile
- time. Read the list
- of all database-related options for more information.
-
-
-
- For a list of all possible options to
- configure, please see the Complete list of configure
- options.
-
+
+
@@ -281,38 +146,299 @@
the Problems section.
+
-
- Testing
+
+ Linux installs
+
+ This section contains notes and hints specific to Linux installs
+ of PHP.
+
+
+ Using Packages
- If you have built PHP as a CGI program, you may test your build
- by typing make test. It is always a good idea
- to test your build. This way you may catch a problem with PHP on
- your platform early instead of having to struggle with it later.
+ Many linux distributions have some sort of package installation,
+ such as rpm files. This can greatly assist in building a standard
+ configuration, but if you need to have a different set of features
+ (such as a secure server, or a different database driver), you may
+ need to build php and/or your webserver. If you are unfamiliar
+ with building and compiling your own software, it's worth
+ investigating whether or not somebody has already built a packaged
+ version of PHP with the features you need.
+
-
- Benchmarking
+
+ HP-UX installs
+
+ This section contains notes and hints specific to HP-UX installs
+ of PHP.
+
+
+
+ Installation Instructions for HP-UX 10
+
+
+From: paul_mckay@clearwater-it.co.uk
+04-Jan-2001 09:49
+(These tips are for php v4.0.4 and apache v1.3.9)
+
+So you want to install PHP and Apache on a HP-UX 10.20 box?
+
+1. You need gzip, download a binary distribution from
+http://hpux.connect.org.uk/ftp/hpux/Gnu/gzip-1.2.4a/gzip-1.2.4a-sd-10.20.depot.Z
+uncompress the file and install using swinstall
+
+2. You need gcc, download a binary distribution from
+http://gatekeep.cs.utah.edu/ftp/hpux/Gnu/gcc-2.95.2/gcc-2.95.2-sd-10.20.depot.gz
+gunzip this file and install gcc using swinstall.
+
+3. You need the gnu binutils, you can download a binary distribution from
+http://hpux.connect.org.uk/ftp/hpux/Gnu/binutils-2.9.1/binutils-2.9.1-sd-10.20.depot.gz
+gunzip and install using swinstall.
+
+
+3. You now need bison, you can download a binary distribution from
+http://hpux.connect.org.uk/ftp/hpux/Gnu/bison-1.28/bison-1.28-sd-10.20.depot.gz
+install as above.
+
+4. You now need flex, you need to download the source from one of the
+http://www.gnu.org mirrors. It is in the non-gnu directory of the ftp site.
+Download the file, gunzip, then tar -xvf it. Go into the newly created flex
+directory and do a ./configure, then a make, and then a make install
+
+If you have errors here, it's probably because gcc etc. are not in your
+PATH so add them to your PATH.
+
+Right, now into the hard stuff.
+
+5.Download the PHP and apache sources.
+
+6.gunzip and tar -xvf them.
+
+We need to hack a couple of files so that they can compile ok.
+
+7. Firstly the configure file needs to be hacked because it seems to lose
+track of the fact that you are a hpux machine, there will be a
+better way of doing this but a cheap and cheerful hack is to put
+ lt_target=hpux10.20
+on line 47286 of the configure script.
+
+8. Next, the apache GuessOS file needs to be hacked. Under
+apache_1.3.9/src/helpers change line 89 from
+ "echo "hp${HPUXMACH}-hpux${HPUXVER}"; exit 0"
+to:
+ "echo "hp${HPUXMACH}-hp-hpux${HPUXVER}"; exit 0"
+
+9. You cannot install PHP as a shared object under HP-UX so you must compile
+it as a static, just follow the instructions at the Apache page.
+
+10. PHP and apache should have compiled OK, but apache won't start. you need
+to create a new user for apache, eg www, or apache. You then change lines 252
+and 253 of the conf/httpd.conf in apache so that instead of
+ User nobody
+ Group nogroup
+you have something like
+ User www
+ Group sys
+
+This is because you can't run apache as nobody under hp-ux.
+Apache and PHP should then work.
+
+Hope this helps somebody,
+Paul Mckay.
+
+
+
+
+
+
+
+Solaris installs
+
+ This section contains notes and hints specific to Solaris installs
+ of PHP.
+
+
+ Required software
+
+ Solaris installs often lack C compilers and their related tools.
+ The required software is as follows:
+
+
- If you have built PHP 3 as a CGI program, you may benchmark your
- build by typing make bench. Note that if safe
- mode is on by default, the benchmark may not be able to finish if
- it takes longer then the 30 seconds allowed. This is because the
- set_time_limit can not be used in safe
- mode. Use the max_execution_time
- configuration setting to control this time for your own
- scripts. make bench ignores the configuration file.
+ gcc (recommended, other C compilers may work)
-
-
- make bench is only available for PHP 3.
-
-
+
+
+
+ make
+
+
+
+
+ flex
+
+
+
+
+ bison
+
+
+
+
+ m4
+
+
+
+
+ autoconf
+
+
+
+
+ automake
+
+
+
+
+ perl
+
+
+
+
+ gzip
+
+
+
+
+ tar
+
+
+
+ In addition, you will need to install (and possibly compile) any
+ additional software specific to your configuration (such as Oracle
+ or MySQL.
+
+
+ Using Packages
+
+ You can simplify the solaris install process by using pkgadd to
+ install most of your needed components.
+
+
+
+
+
+ Mac OS X installs
+
+ This section contains notes and hints specific to Mac OS X installs
+ of PHP.
+
+
+ Using Packages
+
+ There are a few pre-packaged and pre-compiled versions of PHP for
+ Mac OS X. This can greatly assist in building a standard
+ configuration, but if you need to have a different set of features
+ (such as a secure server, or a different database driver), you may
+ need to build php and/or your webserver. If you are unfamiliar
+ with building and compiling your own software, it's worth
+ investigating whether or not somebody has already built a packaged
+ version of PHP with the features you need.
+ Lightyear Design offers a
+ pre-built version of PHP for OS X, as does
+ Tenon Intersystems
+
+
+
+ Compiling for OS X server
+
+ There are two slightly different versions of Mac OS X, client and
+ server. The following is for OS X server.
+
+
+
+ Mac OS X server install
+
+
+1. Get the latest distributions of Apache and PHP
+2. Untar them, and run the configure program on Apache like so.
+ ./configure --exec-prefix=/usr \
+ --localstatedir=/var \
+ --mandir=/usr/share/man \
+ --libexecdir=/System/Library/Apache/Modules \
+ --iconsdir=/System/Library/Apache/Icons \
+ --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \
+ --enable-shared=max \
+ --enable-module=most \
+ --target=apache
+
+4. You may also want to add this line:
+ setenv OPTIM=-O2
+ If you want the compiler to do some optimization.
+
+5. Next, go to the php4 source directory and configure it.
+ ./configure --prefix=/usr \
+ --sysconfdir=/etc \
+ --localstatedir=/var \
+ --mandir=/usr/share/man \
+ --with-xml \
+ --with-apache=/src/apache_1.3.12
+
+ If you have any other addiitons (MySQL, GD, etc.), be sure to add
+ them here. For the --with-apache string, put in the path to your
+ apache source directory, for example "/src/apache_1.3.12".
+6. make
+7. make install
+ This will add a directory to your Apache source directory under
+ src/modules/php4.
+
+8. Now, reconfigure Apache to build in PHP4.
+ ./configure --exec-prefix=/usr \
+ --localstatedir=/var \
+ --mandir=/usr/share/man \
+ --libexecdir=/System/Library/Apache/Modules \
+ --iconsdir=/System/Library/Apache/Icons \
+ --includedir=/System/Library/Frameworks/Apache.framework/Versions/1.3/Headers \
+ --enable-shared=max \
+ --enable-module=most \
+ --target=apache \
+ --activate-module=src/modules/php4/libphp4.a
+
+ You may get a message telling you that libmodphp4.a is out of date.
+ If so, go to the src/modules/php4 directory inside your apache
+ source directory and run this command:
+
+ ranlib libmodphp4.a
+
+ Then go back to the root of the apache source directory and run the
+ above configure command again. That'll bring the link table up to
+ date.
+
+9. make
+10. make install
+
+11. copy and rename the php.ini-dist file to your "bin" directory from your
+ php4 source directory:
+ cp php.ini-dist /usr/local/bin/php.ini
+
+ or (if your don't have a local directory)
+
+ cp php.ini-dist /usr/bin/php.ini
+
+
+
+ Other examples for
+ Mac OS X client
+ and
+ Mac OS X server
+ are available at Stepwise.
+
+
@@ -1673,7 +1799,7 @@
PHP 4: Sets the path in which to look for php.ini.
- Defaults to /usr/local/lib
+ Defaults to /usr/local/lib
@@ -2126,14 +2252,14 @@
PHP 3, PHP 4: Disable the URL-aware fopen wrapper that allows accessing
files via http or ftp.
-
-
- This switch is only available for PHP versions up to 4.0.3, newer
- versions provide an INI parameter called
+
+
+ This switch is only available for PHP versions up to 4.0.3, newer
+ versions provide an INI parameter called
allow_url_fopen instead of forcing you to
decide upon this feature at compile time.
-
-
+
+
@@ -2637,15 +2763,74 @@
Installation on Windows 95/98/NT systems
+
+ There are two main ways to set up PHP for windows, either
+ manually or with an installshield installer.
+
+
+
+ Installshield
+ directions are here.
+
+
+
+
+ Manual Setup
+ directions are also available..
+
+
+
+
+
+
+ Windows Installshield
+
+
+ The Windows PHP installer available from the downloads page at
+ &url.php; installs the CGI version
+ of PHP and, for IIS, PWS, and Xitami, configures the web server as
+ well.
+
+
+
+ Install your choosen http server on your system and make sure it
+ all works.
+
+
+
+ Run the installer exe file and follow the instructions provided by
+ the installation wizard. Two types of installation are supported -
+ standard, which provides sensible defaults for all the settings it
+ can, and advanced, which asks questions as it goes along.
+
+
+
+ The installation wizard gathers enough information to set up the
+ php.ini file and configure the web server to
+ use PHP. For IIS and also PWS on NT Workstation, a list of all the
+ nodes on the server with script map settings is displayed, and you
+ can choose those nodes to which you wish to add the PHP script
+ mappings.
+
+
+ Once the installation has completed the installer will inform you
+ if you need to restart your system, restart the server, or just
+ start using PHP.
+
+
+
+
+
+ General Installation Steps
- This install guide will help you install and configure PHP on your
- Windows 9x/NT webservers. This guide was compiled by
- &link.bob;. The latest revision can be found at &url.win32install;.
- This guide provides installation support for:
+ This guide provides manual installation support for:
@@ -2669,10 +2854,6 @@
-
-
- General Installation Steps
-
The following steps should be performed on all installations
before the server specific instructions.
@@ -2687,16 +2868,16 @@
Copy the file, 'php.ini-dist' to your
- '%WINDOWS%' directory on Windows 95/98 or to your
- '%SYSTEMROOT%' directory under Windows NT or Windows
- 20000 and rename it to 'php.ini'. Your
- '%WINDOWS%' or '%SYSTEMROOT%' directory is
+ '%WINDOWS%' directory on Windows 95/98 or to your
+ '%SYSTEMROOT%' directory under Windows NT or Windows
+ 20000 and rename it to 'php.ini'. Your
+ '%WINDOWS%' or '%SYSTEMROOT%' directory is
typically:
c:\windows for Windows 95/98c:\winnt or c:\winnt40 for NT/2000 servers
-
+
@@ -2743,18 +2924,390 @@
-
+
+
The DLLs for PHP extensions are prefixed with 'php_'. This
prevents confusion between PHP extensions and their supporting
libraries.
+
+
+
+
+
+ Installation of Windows Modules
+
+ After installing PHP and a webserver on windows, you will
+ probably want to tune your specific modules. The following
+ table describes the current windows modules. As described in
+ the manual installation steps, you can choose which modules you
+ would like to load when PHP starts by uncommenting the:
+ 'extension=php_*.dll' lines. Some modules require you to have
+ additional libraries installed on your system for the
+ module to work correctly. The PHP
+ FAQ has more information on
+ where to get supporting libraries. You can also load a
+ module dynamically in your script using:
+ dl("php_*.dll");
+
+
+ PHP Modules
+
+
+
+
+
+
+
+
+
+ Apache Server installs
+
+ This section contains notes and hints specific to Apache installs
+ of PHP, both for Unix and
+ Windows versions.
+
+
+ Details of installing PHP with apache on Unix.
+
+ You can select arguments to add to the
+ configure on line 8 below from the Complete list of configure
+ options.
+
+
+
+
+ Installation Instructions (Apache Module Version)
+
+
+1. gunzip apache_1.3.x.tar.gz
+2. tar xvf apache_1.3.x.tar
+3. gunzip php-x.x.x.tar.gz
+4. tar xvf php-x.x.x.tar
+5. cd apache_1.3.x
+6. ./configure --prefix=/www
+7. cd ../php-x.x.x
+8. ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars
+9. make
+10. make install
+11. cd ../apache_1.3.x
+12. for PHP 3: ./configure --activate-module=src/modules/php3/libphp3.a
+ for PHP 4: ./configure --activate-module=src/modules/php4/libphp4.a
+13. make
+14. make install
+
+ Instead of this step you may prefer to simply copy the httpd binary
+ overtop of your existing binary. Make sure you shut down your
+ server first though.
+
+15. cd ../php-x.x.x
+16. for PHP 3: cp php3.ini-dist /usr/local/lib/php3.ini
+ for PHP 4: cp php.ini-dist /usr/local/lib/php.ini
+
+ You can edit your .ini file to set PHP options. If
+ you prefer this file in another location, use
+ --with-config-file-path=/path in step 8.
+
+17. Edit your httpd.conf or srm.conf file and add:
+
+ For PHP 3: AddType application/x-httpd-php3 .php3
+ For PHP 4: AddType application/x-httpd-php .php
+
+ You can choose any extension you wish here. .php is simply the one
+ we suggest. You can even include .html .
+
+
+18. Use your normal procedure for starting the Apache server. (You must
+ stop and restart the server, not just cause the server to reload by
+ use a HUP or USR1 signal.)
+
+
+
+
+ Different examples of compiling PHP for apache are as follows:
+
+
+./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 either the php.ini file or
+ directly using dl.
+
+
+ When choosing to build PHP in different ways, you should consider
+ the advantages and drawbacks of each method. Building as a shared
+ object will mean that you can compile apache separately, and don't
+ have to recompile everything as you add to, or change, PHP.
+ Building PHP into apache (static method) means that PHP will
+ load and run faster. For more information, see the Apache
+ webpage on DSO support.
+
+
+
+
+
+ Details of installing Windows 9x/NT and Apache 1.3.x
+
+
+ You must edit your srm.conf or
+ httpd.conf to configure Apache to work with
+ the PHP CGI binary.
+
+
+ Although there can be a few variations of configuring PHP under
+ Apache, this one is simple enough to be used by the
+ newcomer. Please consult the Apache Docs for further
+ configuration directives.
+
+
+
+
+
+
+
+ ScriptAlias /php/ "c:/path-to-php-dir/"
+
+
+
+
+
+
+ AddType application/x-httpd-php .php
+
+
+
+
+
+
+ AddType application/x-httpd-php .phtml
+
+
+
+
+
+
+ Action application/x-httpd-php "/php/php.exe"
+
+
+
+
+
+
+
+ To use the source code highlighting feature, simply create a PHP
+ script file and stick this code in: <?php show_source
+ ("original_php_script.php"); ?>. Substitute
+ original_php_script.php with the name of the
+ file you wish to show the source of. (this is only one way of
+ doing it). Note: On Win-Apache all back
+ slashes in a path statement such as: "c:\directory\file.ext",
+ must be converted to forward slashes.
+
+
+
+
+
+ CGI/Commandline Server Installs
+
+ The default is to build PHP as a CGI program. This creates a
+ commandline interpreter, which can be used for CGI processing, or
+ for non-web-related PHP scripting. If you are running a web
+ server PHP has module support for, you should generally go for
+ that solution for performance reasons. However, the CGI version
+ enables Apache users to run different PHP-enabled pages under
+ different user-ids. Please make sure you read through the Security chapter if you are going to
+ run PHP as a CGI.
+
+
+
+ Testing
+
+ If you have built PHP as a CGI program, you may test your build
+ by typing make test. It is always a good idea
+ to test your build. This way you may catch a problem with PHP on
+ your platform early instead of having to struggle with it later.
+
-
- Windows 95/98/NT and PWS/IIS 3
+
+ Benchmarking
+
+ If you have built PHP 3 as a CGI program, you may benchmark your
+ build by typing make bench. Note that if safe
+ mode is on by default, the benchmark may not be able to finish if
+ it takes longer then the 30 seconds allowed. This is because the
+ set_time_limit can not be used in safe
+ mode. Use the max_execution_time
+ configuration setting to control this time for your own
+ scripts. make bench ignores the configuration file.
+
+
+
+ make bench is only available for PHP 3.
+
+
+
+
+
+ fhttpd Server Installs
+
+ To build PHP as an fhttpd module, answer "yes" to "Build as an
+ fhttpd module?" (the
+ option to configure) and specify the fhttpd source base
+ directory. The default directory is /usr/local/src/fhttpd. If you are
+ running fhttpd, building PHP as a module will give better
+ performance, more control and remote execution capability.
+
+
+
+
+ IIS/PWS Server installs
+
+ This section contains notes and hints specific to IIS installs
+ of PHP, both for IIS3 and
+ IIS4 versions.
+
+
+ Windows 95/98/NT and PWS/IIS 3
+
The recommended method for configuring these servers is to use
the INF file included with the distribution
@@ -2894,14 +3447,13 @@
PWS and IIS 3 users now have a fully operational system. IIS 3
- users can use a nifty tool from
- Steven Genusa to configure their script maps.
+ users can use a nifty tool
+ from Steven Genusa to configure their script maps.
-
+
-
+ Windows NT and IIS 4
@@ -2959,69 +3511,143 @@
+
+
-
- Windows 9x/NT and Apache 1.3.x
-
-
- You must edit your srm.conf or
- httpd.conf to configure Apache to work with
- the PHP CGI binary.
-
-
- Although there can be a few variations of configuring PHP under
- Apache, this one is simple enough to be used by the
- newcomer. Please consult the Apache Docs for further
- configuration directives.
-
+
+ Netscape and iPlanet Enterprise Server Installs
+
+ To build PHP with NES or iPlanet web servers, enter the proper
+ install directory for the
+ option. The default directory is usually /opt/netscape/suitespot/. Please
+ also read /php-xxx-version/sapi/nsapi/nsapi-readme.txt.
+
+
+
+
+ Installation Example for Netscape Enterprise on Solaris
+
+
+Instructions for Sun Solaris 2.6 with Netscape Enterprise Server 3.6
+from: bhager@invacare.com
-
-
-
-
-
- ScriptAlias /php/ "c:/path-to-php-dir/"
-
-
-
-
-
-
- AddType application/x-httpd-php .php
-
-
-
-
-
-
- AddType application/x-httpd-php .phtml
-
-
-
-
-
-
- Action application/x-httpd-php "/php/php.exe"
-
-
-
-
+1. Install the following packages from www.sunfreeware.com or another
+download site:
+
+ flex-2_5_4a-sol26-sparc-local
+ gcc-2_95_2-sol26-sparc-local
+ gzip-1.2.4-sol26-sparc-local
+ perl-5_005_03-sol26-sparc-local
+ bison-1_25-sol26-sparc-local
+ make-3_76_1-sol26-sparc-local
+ m4-1_4-sol26-sparc-local
+ autoconf-2.13
+ automake-1.4
+ mysql-3.23.24-beta (if you want mysql support)
+ tar-1.13 (GNU tar)
+
+2. Make sure your path includes the proper directories
+ PATH=.:/usr/local/bin:/usr/sbin:/usr/bin:/usr/ccs/bin
+ export PATH
+
+3. gunzip php-x.x.x.tar.gz (if you have a .gz dist, otherwise go to 4)
+4. tar xvf php-x.x.x.tar
+5. cd ../php-x.x.x
+
+6. For the following step, make sure /opt/netscape/suitespot/ is where
+your netscape server is installed. Otherwise, change to correct path:
+ /configure --with-mysql=/usr/local/mysql --with-nsapi=/opt/netscape/suitespot/ --enable-track-vars --enable-libgcc
+7. make
+8. make install
+
+
+ After performing the base install and reading the appropriate
+ readme file, you may need to performs some additional
+ configuration steps.
+
+ Firstly you may need to add some paths to the LD_LIBRARY_PATH
+ environment for netscape to find all the shared libs. This can
+ best done in the start script for your netscape server.
+ Windows users can probably skip this step. The start
+ script is often located in:
+ /path/to/server/https-servername/start
+
+
+ You may also need to edit the configuration files that are
+ located in:/path/to/server/https-servername/config/.
+
-
- To use the source code highlighting feature, simply create a PHP
- script file and stick this code in: <?php show_source
- ("original_php_script.php"); ?>. Substitute
- original_php_script.php with the name of the
- file you wish to show the source of. (this is only one way of
- doing it). Note: On Win-Apache all back
- slashes in a path statement such as: "c:\directory\file.ext",
- must be converted to forward slashes.
-
+
+
+ Configuration Example for Netscape Enterprise
+
+
+Configuration Instructions for Netscape Enterprise Server
+from: bhager@invacare.com
-
+1. Add the following line to mime.types:
+ type=magnus-internal/x-httpd-php exts=php
-
+2. Add the following to obj.conf, shlib will vary depending on
+your OS, for unix it will be something like
+/opt/netscape/suitespot/bin/libphp4.so.
+You should place the following lines after mime types init.
+ Init fn="load-modules" funcs="php4_init,php4_close,php4_execute,php4_auth_trans" shlib="/php4/nsapiPHP4.dll"
+ Init fn=php4_init errorString="Failed to initialize PHP!"
+
+
+
+
+
+
+
+ Authentication configuration
+
+ PHP authentication cannot be used with any other authentication. ALL AUTHENTICATION IS
+ PASSED TO YOUR PHP SCRIPT. To configure PHP Authentication for the entire server, add
+ the following line:
+
+
+
+ To use PHP Authentication on a single directory, add the following:
+
+
+
+
+
+
+
+
+ Omni HTTPd Server installs
+
+ This section contains notes and hints specific Omni HTTPd.
+
+ Omni HTTPd 2.0b1 for Windows
@@ -3072,125 +3698,17 @@
-
-
- Windows Installshield
-
-
- The Windows PHP installer available from the downloads page at
- &url.php; installs the CGI version of
- PHP and, for IIS, PWS, and Xitami, configures the web server as well.
-
-
-
- Install your choosen http server on your system and make sure it all works.
-
-
-
- Run the installer exe file and follow the instructions provided by the
- installation wizard. Two types of installation are supported - standard,
- which provides sensible defaults for all the settings it can, and
- advanced, which asks questions as it goes along.
-
-
-
- The installation wizard gathers enough information to set up the
- php.ini file and configure the web server to use PHP.
- For IIS and also PWS on NT Workstation, a list of all the nodes on the server
- with script map settings is displayed, and you can choose those nodes to which
- you wish to add the PHP script mappings.
-
-
-
- Once the installation has completed the installer will inform you if you
- need to restart your system, restart the server, or just start using PHP.
-
-
-
-
- PHP Modules
-
-
-
-
-
-
+
+
+ Other web servers
+
+ PHP can be built to support a large number of web servers. Please
+ see Server-related
+ options for a full list of server-related configure
+ options.
+