added new section: migrate configuration files

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

appendices/migration5.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
  <appendix id="migration5">
   <title>Migrating from PHP 4 to PHP 5</title>
 
@@ -70,6 +70,51 @@
    </itemizedlist>
   </section>
 
+  <section id="migration5.configuration">
+   <title>Migrating Configuration Files</title>
+   <para>
+    Since the ISAPI modules changed their names, from php4xxx to php5xxx, you
+    need to make some changes in the configuration files. There were also
+    changes in the CLI and CGI filenames. Please refer to the corresponding
+    section for more information.
+   </para>
+   <para>
+    Migrate the Apache configuration is extremely easy. See the example below
+    to check the change you need to do:
+    <informalexample>
+     <programlisting role="apache">
+<![CDATA[
+# change this line:    
+LoadModule php4_module /php/sapi/php4apache2.dll
+
+# with this one:
+LoadModule php5_module /php/php5apache2.dll
+]]>
+     </programlisting>
+    </informalexample>
+   </para>
+   <para>
+    If your webserver is running PHP in CGI mode, you should note that the
+    CGI version has changed its name from php.exe to php-cgi.exe.
+    In Apache you should do something like this:
+    <informalexample>
+     <programlisting role="apache">
+<![CDATA[
+# change this line:    
+Action application/x-httpd-php "/php/php.exe" 
+
+# with this one:
+Action application/x-httpd-php "/php/php-cgi.exe" 
+]]>
+     </programlisting>
+    </informalexample>
+   </para>
+   <para>
+    In other webservers you need to change either the CGI or the ISAPI module
+    filenames.
+   </para>
+  </section>
+
  </appendix>