Expanded the installation docs, and added PHP 5 install instructions.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@135603 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Philip Olson 2003-07-22 09:38:26 +00:00
parent 9bfd45c8b8
commit 5b4511f0ee
2 changed files with 149 additions and 61 deletions

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.19 $ -->
<!-- $Revision: 1.20 $ -->
<sect1 id="install.apache">
<title>Servers-Apache</title>
<para>
@ -22,7 +22,7 @@
<example id="install.apache.unix.longer">
<title>
Installation Instructions (Apache Shared Module Version) for PHP 4
Installation Instructions (Apache Shared Module Version) for PHP
</title>
<screen>
<![CDATA[
@ -35,38 +35,74 @@
7. make
8. make install
9. cd ../php-xxx
10. ./configure --with-mysql --with-apxs=/www/bin/apxs
10. Now, configure your PHP. This is where you customize your PHP
with various options, like which extensions will be enabled. Do a
./configure --help for a list of available options. In our example
we'll do a simple configure with Apache 1 and MySQL support. Your
path to apxs may differ from our example.
./configure --with-mysql --with-apxs=/www/bin/apxs
11. make
12. make install
If you decide to change your configure options after installation
you only need to repeat the last three steps. You only need to
restart apache for the new module to take effect. A recompile of
Apache is not needed.
13. 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 10.
14. Edit your httpd.conf or srm.conf file and check that these lines are
present and not commented out:
If you decide to change your configure options after installation,
you only need to repeat the last three steps. You only need to
restart apache for the new module to take effect. A recompile of
Apache is not needed.
AddType application/x-httpd-php .php
Note that unless told otherwise, 'make install' will also install PEAR,
various PHP tools such as phpize, install the PHP CLI, and more.
LoadModule php4_module libexec/libphp4.so
You can choose any extension you wish here. .php is simply the one
we suggest. You can even include .html, and .php3 can be added for
backwards compatibility.
The path on the right hand side of the LoadModule statement must point
to the path of the PHP module on your system. The above statement is
correct for the steps shown above.
13. Setup your php.ini file:
cp php.ini-dist /usr/local/lib/php.ini
15. Use your normal procedure for starting the Apache server. (You must
You may edit your .ini file to set PHP options. If you prefer your
php.ini in another location, use --with-config-file-path=/some/path in
step 10.
If you instead choose php.ini-recommended, be certain to read the list
of changes within, as they affect how PHP behaves.
14. Edit your httpd.conf to load the PHP module. The path on the right hand
side of the LoadModule statement must point to the path of the PHP
module on your system. The make install from above may have already
added this for you, but be sure to check.
For PHP 4:
LoadModule php4_module libexec/libphp4.so
For PHP 5:
LoadModule php5_module libexec/libphp5.so
15. And in the AddModule section of httpd.conf, somewhere under the
ClearModuleList, add this:
For PHP 4:
AddModule mod_php4.c
For PHP 5:
AddModule mod_php5.c
16. Tell Apache to parse certain extensions as PHP. For example,
let's have Apache parse the .php extension as PHP. You could
have any extension(s) parse as PHP by simply adding more, with
each separated by a space. We'll add .phtml to demonstrate.
AddType application/x-httpd-php .php .phtml
It's also common to setup the .phps extension to show highlighted PHP
source, this can be done with:
AddType application/x-httpd-php-source .phps
17. 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.)
]]>
@ -79,8 +115,11 @@
lines used in restarting the server, for different apache/unix
installations. You should replace <literal>/path/to/</literal> with
the path to these applications on your systems.
<informalexample>
<screen>
</para>
<para>
<example>
<title>Example commands for restarting Apache</title>
<programlisting role="shell">
<![CDATA[
1. Several Linux and SysV variants:
/etc/rc.d/init.d/httpd restart
@ -98,8 +137,10 @@ stop and start:
/path/to/apachectl stop
/path/to/apachectl startssl
]]>
</screen>
</informalexample>
</programlisting>
</example>
</para>
<para>
The locations of the apachectl and http(s)dctl binaries often
vary. If your system has <literal>locate</literal> or
<literal>whereis</literal> or <literal>which</literal> commands,
@ -288,10 +329,12 @@ Group "#-1"
<itemizedlist>
<listitem>
<simpara>
Open &httpd.conf; with your favorite editor and locate the
<literal>LoadModule</literal> directive and add the following line
<emphasis>at the end</emphasis> of the list:
<literal>LoadModule php4_module "c:/php/sapi/php4apache.dll"</literal>
Open &httpd.conf; with your favorite editor and locate the
<literal>LoadModule</literal> directive and add the following line
<emphasis>at the end</emphasis> of the list for PHP 4:
<literal>LoadModule php4_module "c:/php/sapi/php4apache.dll"</literal>
or the following for PHP 5:
<literal>LoadModule php5_module "c:/php/sapi/php5apache.dll"</literal>
</simpara>
</listitem>
<listitem>
@ -303,8 +346,9 @@ Group "#-1"
find by scrolling down a few lines. You will see a list of
<literal>AddModule</literal> entries, add the following line
<emphasis>at the end</emphasis> of the list:
<literal>AddModule mod_php4.c</literal>
</simpara>
<literal>AddModule mod_php4.c</literal> For PHP 5, instead use
<literal>AddModule mod_php5.c</literal>
</simpara>
</listitem>
<listitem>
<simpara>

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- $Revision: 1.13 $ -->
<sect1 id="install.apache2">
<title>Servers-Apache 2.0</title>
<para>
@ -105,31 +105,67 @@
and stop the server to go on with the configuration for PHP:
/usr/local/apache2/bin/apachectl stop.
9. cd ../php4-NN
10. ./configure --with-apxs2=/usr/local/apache2/bin/apxs
9. cd ../php-NN
10. Now, configure your PHP. This is where you customize your PHP
with various options, like which extensions will be enabled. Do a
./configure --help for a list of available options. In our example
we'll do a simple configure with Apache 2 and MySQL support. Your
path to apxs may differ, in fact, the binary may even be named apxs2 on
your system.
./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql
11. make
12. make install
13. cp php.ini-dist /usr/local/lib/php.ini
Edit your php.ini file to set PHP options. If
you prefer this file in another location, use
--with-config-file-path=/path in step 10.
If you decide to change your configure options after installation,
you only need to repeat the last three steps. You only need to
restart apache for the new module to take effect. A recompile of
Apache is not needed.
Note that unless told otherwise, 'make install' will also install PEAR,
various PHP tools such as phpize, install the PHP CLI, and more.
13. Setup your php.ini
cp php.ini-dist /usr/local/lib/php.ini
You may edit your .ini file to set PHP options. If you prefer having
php.ini in another location, use --with-config-file-path=/some/path in
step 10.
If you instead choose php.ini-recommended, be certain to read the list
of changes within, as they affect how PHP behaves.
14. Edit your httpd.conf file and check that these lines are
present:
14. Edit your httpd.conf to load the PHP module. The path on the right hand
side of the LoadModule statement must point to the path of the PHP
module on your system. The make install from above may have already
added this for you, but be sure to check.
For PHP 4:
LoadModule php4_module modules/libphp4.so
AddType application/x-httpd-php .php
You can choose any extension you wish here. .php is simply the one
we suggest.
LoadModule php4_module libexec/libphp4.so
For PHP 5:
LoadModule php5_module libexec/libphp5.so
The path on the right hand side of the LoadModule statement must point
to the path of the PHP module on your system. The above statement is
correct for the steps shown above.
15. Use your normal procedure for starting the Apache server, e.g.:
/usr/local/apache2/bin/apachectl start
15. Tell Apache to parse certain extensions as PHP. For example,
let's have Apache parse the .php extension as PHP. You could
have any extension(s) parse as PHP by simply adding more, with
each separated by a space. We'll add .phtml to demonstrate.
AddType application/x-httpd-php .php .phtml
It's also common to setup the .phps extension to show highlighted PHP
source, this can be done with:
AddType application/x-httpd-php-source .phps
16. Use your normal procedure for starting the Apache server, e.g.:
/usr/local/apache2/bin/apachectl start
]]>
@ -205,7 +241,8 @@ Action application/x-httpd-php "/php/php.exe"
</para>
<para>
If you would like to use <literal>PHP</literal> as a module in Apache 2.0,
be sure to move <filename>php4ts.dll</filename> to
be sure to move <filename>php4ts.dll</filename> for PHP 4, or
<filename>php5ts.dll</filename> for PHP 5, to
<filename>winnt/system32</filename> (for Windows NT/2000) or
<filename>windows/system32</filename> (for Windows XP),
overwriting any older file. You need to insert these two lines to your
@ -215,8 +252,13 @@ Action application/x-httpd-php "/php/php.exe"
<title>PHP and Apache 2.0 as Module</title>
<programlisting role="apache">
<![CDATA[
; For PHP 4 do something like this:
LoadModule php4_module "c:/php/sapi/php4apache2.dll"
AddType application/x-httpd-php .php
; For PHP 5 do something like this:
LoadModule php5_module "c:/php/sapi/php5apache2.dll"
AddType application/x-httpd-php .php
]]>
</programlisting>
</example>
@ -225,9 +267,11 @@ AddType application/x-httpd-php .php
<simpara>
Remember to substitute the <filename>c:/php/</filename> for your actual
path to <literal>PHP</literal> in the above examples. Take care to use
<filename>php4apache2.dll</filename> in your LoadModule directive and
<emphasis>not</emphasis><filename>php4apche.dll</filename>. The latter one
is designd to run with Apache 1.3.x.
either <filename>php4apache2.dll</filename> or
<filename>php5apache2.dll</filename> in your LoadModule directive and
<emphasis>not</emphasis><filename>php4apache.dll</filename> or
<filename>php5apache.dll</filename> as the latter ones are designed to
run with <link linkend="install.apache.windows">Apache 1.3.x</link>.
</simpara>
</note>
<warning>