betz Sat Mar 29 10:35:15 2003 EDT Modified files: /phpdoc/en/chapters install.apache.xml Log: part of fix for #22115 more verbose explanation, where to add directives to httpd.conf some formating Index: phpdoc/en/chapters/install.apache.xml diff -u phpdoc/en/chapters/install.apache.xml:1.16 phpdoc/en/chapters/install.apache.xml:1.17 --- phpdoc/en/chapters/install.apache.xml:1.16 Fri Jan 31 15:58:47 2003 +++ phpdoc/en/chapters/install.apache.xml Sat Mar 29 10:35:15 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> +<!-- $Revision: 1.17 $ --> <sect1 id="install.apache"> <title>Servers-Apache</title> <para> @@ -119,7 +119,7 @@ <para> This will create a <filename>libphp4.so</filename> shared library that is loaded into Apache using a LoadModule line in - Apache's <filename>httpd.conf</filename> file. The PostgreSQL + Apache's &httpd.conf; file. The PostgreSQL support is embedded into this <filename>libphp4.so</filename> library. </para> @@ -189,7 +189,7 @@ </para> <note> <para> - Apache's default http.conf currently ships with a section that looks + Apache's default &httpd.conf; currently ships with a section that looks like this: <informalexample> <programlisting> @@ -205,9 +205,10 @@ </note> <note> <para> - Make sure you specify the installed version of apxs when using --with-apxs=/path/to/apxs. - You must NOT use the apxs version that is in the apache sources but the one that is actually - installed on your system. + Make sure you specify the installed version of apxs when using + <option role="configure">--with-apxs=/path/to/apxs</option>. + You must NOT use the apxs version that is in the apache sources but the one + that is actually installed on your system. </para> </note> </sect2> @@ -219,8 +220,7 @@ on Windows. One is to use the CGI binary (php.exe), the other is to use the Apache module DLL. In either case you need to stop the Apache server, and edit your - <filename>srm.conf</filename> or <filename>httpd.conf</filename> - to configure Apache to work with PHP. + &httpd.conf; to configure Apache to work with PHP. </simpara> <simpara> It is worth noting here that now the SAPI module has been @@ -235,7 +235,7 @@ </simpara> <para> - If you unziped the PHP package to c:\php\ as described + If you unziped the PHP package to <filename>c:\php\</filename> as described in the <link linkend="install.windows.manual">Manual Installation Steps</link> section, you need to insert these lines to your Apache configuration file to set @@ -264,9 +264,9 @@ </listitem> </itemizedlist> Note that the second line in the list above can be found - in the actual versions of <filename>httpd.conf</filename>, - but it is commented out. Remember also to substitute the - <filename>c:/php/</filename> for your actual path to PHP. + in the actual versions of &httpd.conf;, but it is commented out. Remember + also to substitute the <filename>c:/php/</filename> for your actual path to + PHP. </para> <warning> @@ -279,61 +279,63 @@ </warning> <para> - If you would like to use PHP as a module in Apache, - be sure to move <filename>php4ts.dll</filename> to - the windows/system (for Windows 9x/Me) or winnt/system32 - (for Windows NT/2000/XP) directory, overwriting any older file. - Then you should add the following two lines to your Apache - <filename>httpd.conf</filename> file: + If you would like to use PHP as a module in Apache, be sure to copy + <filename>php4ts.dll</filename> to the <filename>windows/system</filename> + (for Windows 9x/Me), <filename>winnt/system32</filename> (for Windows + NT/2000) or <filename>windows/system32</filename> (for Windows XP) + directory, overwriting any older file. Then you should add the following + lines to your Apache &httpd.conf; file: <itemizedlist> <listitem> <simpara> - <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: + <literal>LoadModule php4_module c:/php/sapi/php4apache.dll</literal> </simpara> </listitem> <listitem> <simpara> - <literal> - AddType application/x-httpd-php .php .phtml - </literal> + You may find after using the windows installer for Apache that you need + to define the <literal>AddModule</literal> directive for + <filename>mod_php4.c</filename>. This is especially important if the + <literal>ClearModuleList</literal> directive is defined, which you will + 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> + </listitem> + <listitem> + <simpara> + Search for a phrase similar to + <literal># AddType allows you to tweak mime.types</literal>. You will + see some <literal>AddType</literal> entries, add the following line + <emphasis>at the end</emphasis> of the list: + <literal>AddType application/x-httpd-php .php</literal>. + You can choose any extension you want to parse through PHP here. .php + is simply the one we suggest. You can even include .html, and .php3 + can be added for backwards compatibility. </simpara> </listitem> </itemizedlist> </para> <simpara> - After changing the configuration - file, remember to restart the server, for example, - <literal>NET STOP APACHE</literal> followed by - <literal>NET START APACHE</literal>, if you run Apache - as a Windows Service, or use your regular shortcuts. + After changing the configuration file, remember to restart the server, for + example, <command>NET STOP APACHE</command> followed by + <command>NET START APACHE</command>, if you run Apache as a Windows + Service, or use your regular shortcuts. </simpara> - <warning> - <simpara> - You may find after using the windows installer for Apache - that you need to define the <literal>AddModule</literal> - directive for <filename>mod_php4.c</filename> in the - configuration file (<filename>httpd.conf</filename>). - This is done by adding <literal>AddModule mod_php4.c</literal> - to the <literal>AddModule</literal> list, near the beginning - of the configuration file. This is especially important if - the <literal>ClearModuleList</literal> directive is defined. - Failure to do this may mean PHP will not be registered as an - Apache module. - </simpara> - </warning> - <simpara> There are two ways you can use the source code highlighting feature, - however their ability to work depends on your installation. - If you have configured Apache to use PHP as an SAPI module, then by - adding the following line to your configuration file - (<filename>httpd.conf</filename>) you can use this feature: - <literal>AddType application/x-httpd-php-source .phps - </literal> + however their ability to work depends on your installation. If you have + configured Apache to use PHP as an SAPI module, then by adding the + following line to your &httpd.conf; (at the same place you inserted + <literal>AddType application/x-httpd-php .php</literal>, see above) you can + use this feature: + <literal>AddType application/x-httpd-php-source .phps</literal>. </simpara> <simpara> If you chose to configure Apache to use PHP as a CGI binary, you
-- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php