diff --git a/chapters/install.xml b/chapters/install.xml
index 44669a211c..9986d03735 100644
--- a/chapters/install.xml
+++ b/chapters/install.xml
@@ -4,9 +4,10 @@
Downloading the latest version
- The source code, and binary distributions for some platforms (including
- Windows), can be found at
- http://www.php.net/.
+ The source code, and binary distributions for some platforms
+ (including Windows), can be found at http://www.php.net/.
+
@@ -17,15 +18,29 @@
installation of PHP. Prerequisite knowledge and software:
- Basic UNIX skills (being able to operate "make"
- and a C compiler)
- An ANSI C compiler
- A web server
+
+
+ Basic UNIX skills (being able to operate "make" and a C
+ compiler)
+
+
+
+
+ An ANSI C compiler
+
+
+
+
+ A web server
+
+
- Quick Installation Instructions (Apache Module Version)
+
+ Quick Installation Instructions (Apache Module Version)
+
@@ -72,36 +87,40 @@
-
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, 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.
+ configure with the new options.
+
Running configure by hand. To see what options you have, type
- ./configure --help.
+ ./configure --help.
+
-
-
+
+
Details about some of the different configuration options are
- listed below.
+ listed below.
+
+
Apache module
@@ -112,9 +131,13 @@
--with-apache=DIR
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.
+ /usr/local/www/apache_1.2.4, this is
+ your Apache distribution base directory. The default directory
+ is /usr/local/etc/httpd.
+
+
fhttpd module
@@ -124,13 +147,16 @@
fhttpd module?" (the
option to configure) and specify the fhttpd source base
- directory. The default directory is /usr/local/src/fhttpd. If you are
+ 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.
+ performance, more control and remote execution
+ capability.
+
+
CGI version
-
The default is to build PHP as a CGI program. If you are
running a web server PHP has module support for, you should
@@ -138,15 +164,16 @@
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.
+ 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):
-
+ ODBC):
+
Adabas D
@@ -155,9 +182,12 @@
Compiles with Adabas D support. The parameter is the Adabas D
- install directory and defaults to /usr/local/adabasd.
+ install directory and defaults to /usr/local/adabasd.
+
- Adabas home page
+ Adabas home page
+
@@ -167,7 +197,8 @@
Enables the bundled DBase support. No external libraries are
- required.
+ required.
+
@@ -177,7 +208,8 @@
Enables the bundled read-only filePro support. No external
- libraries are required.
+ libraries are required.
+
@@ -187,18 +219,22 @@
Enables mSQL support. The parameter to this option is the mSQL
- install directory and defaults to /usr/local/Hughes. This is the
+ install directory and defaults to /usr/local/Hughes. This is the
default directory of the mSQL 2.0 distribution.
configure automatically detects which mSQL
version you are running and PHP supports both 1.0 and 2.0, but
if you compile PHP with mSQL 1.0, you can only access mSQL 1.0
- databases, and vice-versa.
+ databases, and vice-versa.
+
See also mSQL Configuration
Directives in the configuration
- file.
+ file.
+
- mSQL home page
+ mSQL home page
+
@@ -208,13 +244,18 @@
Enables MySQL support. The parameter to this option is the
- MySQL install directory and defaults to /usr/local. This is the default
- installation directory of the MySQL distribution.
+ MySQL install directory and defaults to /usr/local. This is the default
+ installation directory of the MySQL distribution.
+
See also MySQL
- Configuration Directives in the configuration file.
+ Configuration Directives in the configuration file.
+
- MySQL home page
+ MySQL home page
+
@@ -230,7 +271,9 @@
/usr/local.
FreeODBC
- home page or iODBC home page
+ home page or iODBC
+ home page
+
@@ -241,10 +284,12 @@
Includes OpenLink ODBC support. The parameter to this option is
the OpenLink ODBC installation directory and defaults to
- /usr/local/openlink.
+ /usr/local/openlink.
+
OpenLink Software's home
- page
+ page
+
@@ -259,7 +304,8 @@
specify this parameter if your Oracle environment has been set
up.
- Oracle home page
+ Oracle home page
+
@@ -269,13 +315,18 @@
Includes PostgreSQL support. The parameter is the PostgreSQL
- base install directory and defaults to /usr/local/pgsql.
+ base install directory and defaults to /usr/local/pgsql.
+
See also Postgres
- Configuration Directives in the configuration file.
+ Configuration Directives in the configuration file.
+
PostgreSQL home
- page
+ page
+
@@ -285,9 +336,12 @@
Includes Solid support. The parameter is the Solid install
- directory and defaults to /usr/local/solid.
+ directory and defaults to /usr/local/solid.
+
- Solid home page
+ Solid home page
+
@@ -297,12 +351,17 @@
Includes Sybase support. The parameter is the Sybase install
- directory and defaults to /home/sybase.
+ directory and defaults to /home/sybase.
+
See also Sybase
- Configuration Directives in the configuration file.
+ Configuration Directives in the configuration file.
+
- Sybase home page
+ Sybase home page
+
@@ -312,10 +371,15 @@
Includes Sybase-CT support. The parameter is the Sybase-CT
- install directory and defaults to /home/sybase.
+ install directory and defaults to /home/sybase.
+
See also Sybase-CT
- Configuration Directives in the configuration file.
+ Configuration Directives in the configuration
+ file.
+
@@ -325,9 +389,12 @@
Includes Velocis support. The parameter is the Velocis install
- directory and defaults to /usr/local/velocis.
+ directory and defaults to /usr/local/velocis.
+
- Velocis home page
+ Velocis home page
+
@@ -337,7 +404,9 @@
Includes support for an arbitrary custom ODBC library. The
- parameter is the base directory and defaults to /usr/local.
+ parameter is the base directory and defaults to /usr/local.
+
This option implies that you have defined CUSTOM_ODBC_LIBS when
you run the configure script. You also must have a valid odbc.h
@@ -351,7 +420,8 @@
CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib
-lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50
-
+
+
@@ -367,10 +437,19 @@
Anywhere. Requires that one (and only one) of these modules or
the Velocis module is enabled, or a custom ODBC library
specified. This option is only applicable if one of the
- following options is used: --with-iodbc, --with-solid, --with-adabas, --with-velocis, or --with-custom-odbc,
+ following options is used: --with-iodbc, --with-solid, --with-adabas, --with-velocis, or --with-custom-odbc.
+
See also Unified ODBC
- Configuration Directives in the configuration file.
+ Configuration Directives in the configuration
+ file.
+
@@ -381,10 +460,15 @@
Includes LDAP (Lightweight Directory Access
Protocol) support. The parameter is the LDAP base install
- directory, defaults to /usr/local/ldap.
+ directory, defaults to /usr/local/ldap.
+
- More information about LDAP can be found in RFC1777 and
- RFC1778.
+ More information about LDAP can be found in RFC1777 and
+ RFC1778.
+
@@ -398,9 +482,11 @@
- Include support for the mcrypt library. See the mcrypt documentation for more information. If
- you use the optional DIR argument, PHP will
- look for mcrypt.h in DIR/include.
+ Include support for the mcrypt library. See the mcrypt documentation for more
+ information. If you use the optional
+ DIR argument, PHP will look for
+ mcrypt.h in DIR/include.
@@ -413,18 +499,18 @@
Include support for Sys V semaphores (supported by most Unix
derivates). See the Semaphore and Shared
Memory documentation for more information.
-
+
-
+
--enable-sysvshm
- Include support for Sys V shared memory (supported by most Unix
- derivates). See the Semaphore and
- Shared Memory documentation for more information.
+ Include support for Sys V shared memory (supported by most Unix
+ derivates). See the Semaphore and Shared
+ Memory documentation for more information.
@@ -471,8 +557,9 @@
- The path used to look for the configuration
- file when PHP starts up.
+ The path used to look for the
+ configuration file when PHP starts up.
+
@@ -495,10 +582,11 @@
- Enables extra debug information. This makes it possible to gather
- more detailed information when there are problems with PHP.
- (Note that this doesn't have anything to do with debugging
- facilities or information available to PHP scripts.)
+ Enables extra debug information. This makes it possible to
+ gather more detailed information when there are problems with
+ PHP. (Note that this doesn't have anything to do with debugging
+ facilities or information available to PHP scripts.)
+
@@ -509,11 +597,14 @@
Enables "safe mode" by default. This imposes several
restrictions on what PHP can do, such as opening only files
- within the document root. Read the Security chapter for more more
+ within the document root. Read the Security chapter for more more
information. CGI users should always enable secure mode. This
option only sets the default, it may be enabled or disabled with
the safe_mode directive in
- the configuration file later.
+ the configuration file
+ later.
+
@@ -525,8 +616,11 @@
Makes PHP keep track of where GET/POST/cookie variables come
from in the arrays HTTP_GET_VARS, HTTP_POST_VARS and
HTTP_COOKIE_VARS. This option only sets the default, it may be
- enabled or disabled with the track_vars directive in the
- configuration file later.
+ enabled or disabled with the track_vars directive in the
+ configuration file
+ later.
+
@@ -536,11 +630,15 @@
Enable magic quotes by default. This option only sets the
- default, it may be enabled or disabled with the magic_quotes_runtime
- directive in the configuration
- file later. See also the magic_quotes_gpc and the
- magic_quotes_sybase
- directives.
+ default, it may be enabled or disabled with the magic_quotes_runtime
+ directive in the configuration file
+ later. See also the
+ magic_quotes_gpc and the magic_quotes_sybase
+ directives.
+
@@ -550,9 +648,12 @@
Enables the internal PHP debugger support. This feature is
- still in an experimental state. See also the Debugger Configuration
- directives in the configuration
- file.
+ still in an experimental state. See also the Debugger Configuration
+ directives in the configuration
+ file.
+
@@ -563,8 +664,10 @@
If this is enabled, the PHP CGI binary can safely be placed
outside of the web tree and people will not be able to
- circumvent .htaccess security. Read the section in the security
- chapter about this option.
+ circumvent .htaccess security. Read the section in the security
+ chapter about this option.
+
@@ -574,8 +677,11 @@
Enables bc style arbitrary precision math
- functions. See also the bcmath.scale option in the
- configuration file.
+ functions. See also the bcmath.scale option in the
+ configuration
+ file.
+
@@ -585,29 +691,33 @@
Enable the security check for internal server redirects. You
- should use this if you are running the CGI version with Apache.
-
+ should use this if you are running the CGI version with
+ Apache.
+
When using PHP as a CGI binary, PHP by default always first
checks that it is used by redirection (for example under Apache,
by using Action directives). This makes sure that the PHP
binary cannot be used to bypass standard web server
- authentication procedures by calling it directly, like http://my.host/cgi-bin/php/secret/doc.html.
- This example accesses http://my.host/secret/doc.html but does not
- honour any security settings enforced by httpd for directory
- /secret.
-
+ authentication procedures by calling it directly, like http://my.host/cgi-bin/php/secret/doc.html.
+ This example accesses http://my.host/secret/doc.html but does
+ not honour any security settings enforced by httpd for directory
+ /secret.
+
- Not enabling option disables the check and enables bypassing httpd
- security and authentication settings. Do this only if your
- server software is unable to indicate that a safe redirection
- was done and all your files under your document root and
- user directories may be accessed by anyone.
-
+ Not enabling option disables the check and enables bypassing
+ httpd security and authentication settings. Do this only if
+ your server software is unable to indicate that a safe
+ redirection was done and all your files under your document root
+ and user directories may be accessed by anyone.
+
Read the section in
- the security chapter about this option.
-
+ the security chapter about this option.
+
+
--disable-short-tags
@@ -615,14 +725,15 @@
- Disables the short form <? ?> PHP
- tags. You must disable the short form if you want to use PHP
- with XML. With short tags disabled, the only
- PHP code tag is <?php ?>. This option
- only sets the default, it may be enabled or disabled with the
- short_open_tag
- directive in the configuration
- file later.
+ Disables the short form <? ?> PHP tags.
+ You must disable the short form if you want to use PHP with
+ XML. With short tags disabled, the only PHP
+ code tag is <?php ?>. This option only
+ sets the default, it may be enabled or disabled with the short_open_tag directive in
+ the configuration file
+ later.
+
@@ -632,8 +743,11 @@
Makes it possible to run code on other HTTP or FTP servers
- directly from PHP with include(). See also the include_path option in the
- configuration file.
+ directly from PHP with include(). See also the include_path option in the
+ configuration file.
+
@@ -642,32 +756,33 @@
- Turns off syntax highlighting.
+ Turns off syntax highlighting.
+
CPPFLAGS and LDFLAGS
- To make the PHP installation look for header or library files
- in different directories, modify the CPPFLAGS and
+ To make the PHP installation look for header or library files in
+ different directories, modify the CPPFLAGS and
LDFLAGS environment variables, respectively. If
you are using a sensible shell, you should be able to do
LDFLAGS=-L/my/lib/dir CPPFLAGS=-I/my/include/dir ./configure
-
+
+
-
Building
- When PHP is configured, you are ready to build the CGI
- executable or the PHP library. The command
- make should take care of this. If it fails
- and you can't figure out why, see the Problems section.
-
+ When PHP is configured, you are ready to build the CGI executable
+ or the PHP library. The command make should
+ take care of this. If it fails and you can't figure out why, see
+ the Problems section.
+
@@ -675,9 +790,9 @@
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.
+ 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.
+
@@ -688,9 +803,12 @@
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
+ mode. Use the max_execution_time
configuration setting to control this time for your own
- scripts. make bench ignores the configuration file.
+ scripts. make bench ignores the configuration file.
+
@@ -699,25 +817,36 @@
Installation on Windows 95/98/NT systems
- 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 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:
-
- Personal Web Server (Newest version recommended)
-
-
- Internet Information Server 3 or 4
-
-
- Apache 1.3.x
-
- Omni HTTPd 2.0b1
-
-
+
+
+ Personal Web Server (Newest version recommended)
+
+
+
+
+ Internet Information Server 3 or 4
+
+
+
+
+ Apache 1.3.x
+
+
+
+
+ Omni HTTPd 2.0b1
+
+
+
+
General Installation Steps
@@ -757,10 +886,10 @@
- If you are using Omni Httpd, do not follow the next step.
+ If you are using Omni Httpd, do not follow the next step.
Set the 'doc_root' to point to your webservers
document_root. ex: c:\apache\htdocs or c:\webroot
-
+
@@ -768,7 +897,8 @@
starts. You can uncomment the: 'extension=php3_*.dll' lines
to load these modules. 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
+ 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");
@@ -780,7 +910,8 @@
'c:\windows\system\inetsrv\browscap.ini' on Windows 95/98
and 'c:\winnt\system32\inetsrv\browscap.ini' on NT
Server. Additional information on using the browscap
- functionality in PHP can be found at this mirror, select the "source"
+ functionality in PHP can be found at this mirror, select the "source"
button to see it in action.
@@ -788,33 +919,34 @@
-
- The DLLs for PHP extensions are prefixed with 'php3_'. This prevents
- confusion between PHP extensions and their supporting libraries.
+ The DLLs for PHP extensions are prefixed with 'php3_'. This
+ prevents confusion between PHP extensions and their supporting
+ libraries.
+
-
+
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
- (php_iis_reg.inf). You may want to edit this file and make sure
- the extensions and PHP install directories match your
- configuration. Or you can follow the steps below to do it
- manually.
-
-
- WARNING: These steps involve working directly with the windows
- registry. One error here can leave your system in an unstable
- state. We highly recommend that you back up your registry
- first. The PHP Development team will not be held responsible if
- you damage your registry.
-
+
+ The recommended method for configuring these servers is to use
+ the INF file included with the distribution
+ (php_iis_reg.inf). You may want to edit this file and make sure
+ the extensions and PHP install directories match your
+ configuration. Or you can follow the steps below to do it
+ manually.
+
+
+ WARNING: These steps involve working directly with the windows
+ registry. One error here can leave your system in an unstable
+ state. We highly recommend that you back up your registry
+ first. The PHP Development team will not be held responsible if
+ you damage your registry.
+
-
+
@@ -824,8 +956,8 @@
Navigate to: HKEY_LOCAL_MACHINE /System
- /CurrentControlSet /Services /W3Svc /Parameters
- /ScriptMap.
+ /CurrentControlSet /Services /W3Svc /Parameters
+ /ScriptMap.
@@ -885,7 +1017,7 @@
Now create another New->Key under
HKEY_CLASSES_ROOT and name it
- phpfile.
+ phpfile.
@@ -928,13 +1060,14 @@
Exit Regedit.
-
-
-
- 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.
-
+
+
+
+ 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.
+
@@ -943,7 +1076,7 @@
To install PHP on an NT Server running IIS 4, follow these
- instructions:
+ instructions:
@@ -972,24 +1105,24 @@
Click Add, and in the Executable box, type:
c:\path-to-php-dir\php.exe %s %s. You MUST
have the %s %s on the end, PHP will not function properly if
- you fail to do this.
+ you fail to do this.
In the Extension box, type the file name extension you want
- associated with PHP scripts. (You must repeat step 5 and 6 for
+ associated with PHP scripts. (You must repeat step 5 and 6 for
each extension you want accociated with PHP
scripts. (.php3 and
- .phtml are common)
+ .phtml are common.)
Set up the appropriate security. (This is done in Internet
- Service Manager), and if your NT Server uses NTFS file system,
+ Service Manager), and if your NT Server uses NTFS file system,
add execute rights for I_USR_ to the directory that contains
- php.exe.
+ php.exe.
@@ -1009,29 +1142,37 @@
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.
+ configuration directives.
+
- ScriptAlias /php3/
- "c:/path-to-php-dir/"
+
+ ScriptAlias /php3/ "c:/path-to-php-dir/"
+
- AddType application/x-httpd-php3 .php3
+
+ AddType application/x-httpd-php3 .php3
+
- AddType application/x-httpd-php3 .phtml
+
+ AddType application/x-httpd-php3 .phtml
+
- Action application/x-httpd-php3 "/php3/php.exe"
+
+ Action application/x-httpd-php3 "/php3/php.exe"
+
@@ -1081,19 +1222,20 @@
Step 6: Click OK
-
+
+
-
- Repeat steps 2 - 6 for each extension you want to associate with
- PHP.
-
+
+ Repeat steps 2 - 6 for each extension you want to associate with
+ PHP.
+ PHP Modules
-
+
PHP Modules
@@ -1169,11 +1311,10 @@
-
+
-
@@ -1183,38 +1324,47 @@
Read the FAQ
Some problems are more common than others. The most common ones
- are listed in the PHP FAQ, found at &url.php.faq;
+ are listed in the PHP FAQ, found at &url.php.faq;
+
Bug reports
-
- If you think you have found a bug in PHP, please report
- it. The PHP developers probably don't know about it, and
- unless you report it, chances are it won't be fixed. You
- can report bugs using the bug-tracking system at &url.php.bugs;.
+ If you think you have found a bug in PHP, please report it. The
+ PHP developers probably don't know about it, and unless you
+ report it, chances are it won't be fixed. You can report bugs
+ using the bug-tracking system at &url.php.bugs;.
+
-
+ Other problems
If you are still stuck, someone on the PHP mailing list may be
- able to help you. You should check out the archive first, in
- case someone already answered someone else who had the same
- problem as you. The archives are available from the support
- page on &url.php;. To
- subscribe to the PHP mailing list, send an empty mail to &email.php3.subscribe;.
- The mailing list address is &email.php3;.
-
+ able to help you. You should check out the archive first, in case
+ someone already answered someone else who had the same problem as
+ you. The archives are available from the support page on &url.php;. To subscribe to the PHP
+ mailing list, send an empty mail to &email.php3.subscribe;.
+ The mailing list address is
+ &email.php3;.
+
If you want to get help on the mailing list, please try to be
precise and give the necessary details about your environment
(which operating system, what PHP version, what web server, if
you are running PHP as CGI or a server module, etc.), and
preferably enough code to make others able to reproduce and test
- your problem.
+ your problem.
+
+
+
+
@@ -1228,7 +1378,7 @@ sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
-sgml-default-dtd-file:"../manual.ced"
+sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil