Added Caudium installation instructions.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@39999 c90b9560-bf6c-de11-be94-00142212c4b1

chapters/install.xml

@@ -2490,6 +2490,24 @@ Paul Mckay.
       </listitem>
      </varlistentry>
 
+     <varlistentry id="install.configure.with-caudium">
+      <term>
+       <parameter>--with-caudium[=DIR]</parameter>
+      </term>
+      <listitem>
+       <para>
+        PHP 3: Option not available in PHP 3
+       </para>
+       <para>
+        PHP 4: Build PHP as a Pike module for use with the Caudium
+	webserver.  DIR is the Caudium base directory. If no directory
+	is specified $prefix/caudium/server is used. The prefix is
+	controlled by the --prefix option and is /usr/local per
+	default.
+       </para>
+      </listitem>
+     </varlistentry>
+
      <varlistentry id="install.configure.with-fhttpd">
       <term>
        <parameter>--with-fhttpd[=DIR]</parameter>
@@ -3298,6 +3316,54 @@ Paul Mckay.
    </para>
   </sect1>
 
+  <sect1 id="install.caudium">
+   <title>Caudium Server installs</title>
+   <para>
+    PHP4 can be build as a Pike module for the Caudium webserver. Note
+    that this is not supported with PHP3. Follow the simple
+    instructions below to install PHP4 for Caudium.
+   </para>
+   <example id="install.caudium.instructions">
+    <title>Caudium Installation Instructions</title>
+    <programlisting>
+1.  Make sure you have Caudium installed prior to attempting to
+    install PHP4. For PHP4 to work correctly, you will need Pike
+    7.0.268 or newer. For the sake of this example we assume that
+    Caudium is installed in /opt/caudium/server/.
+2.  Change directory to php-x.y.z (where x.y.z is the version number).
+3.  ./configure --with-caudium=/opt/caudium/server --enable-track-vars
+4.  make
+5.  make install
+6.  Restart Caudium if it's currently running.
+7.  Log into the graphical configuration interface and go to the
+    virtual server where you want to add PHP4 support.
+8.  Click Add Module and locate and add the PHP4 Script Support module.
+9.  If the documentation says that the 'PHP4 interpreter isn't
+    available', make sure that you restarted the server. If you did
+    check /opt/caudium/logs/debug/default.1 for any errors related to
+    PHP4.so.  Also make sure that caudium/server/lib/[pike-version]/PHP4.so
+    is present.
+10. Configure the PHP Script Support module if needed.
+    </programlisting>
+   </example>
+   <para>
+    You can of course compile your Caudium module with support for the
+    various extension modules available in PHP4. See the 
+    <link linkend="install.configure">complete list of configure
+    options</link> for an exhaustive rundown. 
+   </para>
+   <note>
+    <para>
+     When compiling PHP4 with MySQL support you must make sure that
+     the normal MySQL client code is used. Otherwise there might be
+     conflicts if your Pike already has MySQL support. You do this by
+     specifying a MySQL install directory <link
+     linkend="install.configure.with-mysql">the --with-mysql
+     option</link>.
+    </para>
+   </note>
+  </sect1>
+
   <sect1 id="install.iis">
    <title>IIS/PWS Server installs</title>
    <para>