goba            Sun Jun 13 09:19:59 2004 EDT

  Modified files:              
    /phpdoc/en/install/windows  index.xml manual.xml 
  Log:
  started to revise the Windows manual installation instructions:
  
   - we also support Windows 2003
   - removed Windows 95 related note
     (since it is not supported anymore)
   - Put every part of an instruction to the
     itemizedlist
   - updated folder contents, filenames for PHP 4.3.7
   - added PHP 5 folder overview
   - mentioned the activescript dll
     TODO: add section on activescript usage
   - still need to review the last part of the file
     (there is now a warning mark in there)
  
  I am still uncertain on what to suggest people who would like to set up PHP 4 and 
PHP 5 side by side. PHPRC will not work, since that sets a single folder.
  
http://cvs.php.net/diff.php/phpdoc/en/install/windows/index.xml?r1=1.6&r2=1.7&ty=u
Index: phpdoc/en/install/windows/index.xml
diff -u phpdoc/en/install/windows/index.xml:1.6 phpdoc/en/install/windows/index.xml:1.7
--- phpdoc/en/install/windows/index.xml:1.6     Sat Jun  5 16:16:07 2004
+++ phpdoc/en/install/windows/index.xml Sun Jun 13 09:19:59 2004
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
   <chapter id="install.windows">
    <title>Installation on Windows systems</title>
    <para>
-    This section applies to Windows 98/Me and Windows NT/2000/XP.  PHP 
+    This section applies to Windows 98/Me and Windows NT/2000/XP/2003. PHP 
     will not work on 16 bit platforms such as Windows 3.1 and sometimes 
     we refer to the supported Windows platforms as Win32. Windows 95
     is no longer supported as of PHP 4.3.0.
http://cvs.php.net/diff.php/phpdoc/en/install/windows/manual.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/install/windows/manual.xml
diff -u phpdoc/en/install/windows/manual.xml:1.3 
phpdoc/en/install/windows/manual.xml:1.4
--- phpdoc/en/install/windows/manual.xml:1.3    Sun Jun 13 07:49:26 2004
+++ phpdoc/en/install/windows/manual.xml        Sun Jun 13 09:19:59 2004
@@ -1,78 +1,56 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
    <sect1 id="install.windows.manual">
     <title>Manual Installation Steps</title>
-    <simpara>
-     This install guide will help you manually install and configure PHP on your
-     Windows webserver.
-     You need to download the zip binary distribution from the downloads page at 
-     <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>. 
-    </simpara>
-
+    
     <para>
-     PHP 4 for Windows comes in three flavours - a CGI executable (php.exe), a
-     CLI executable (sapi/php.exe) and some other SAPI modules:
-     <simplelist>
-      <member>
-       <filename>php4apache.dll</filename> - Apache 1.3.x module
-      </member>
-      <member>
-       <filename>php4apache2.dll</filename> - Apache 2.0.x module
-      </member>
-      <member>
-       <filename>php4isapi.dll</filename> - ISAPI Module for ISAPI compliant
-       webservers like IIS 4.0/PWS 4.0 or newer.
-      </member>
-      <member>
-       <filename>php4nsapi.dll</filename> - Netscape/iPlanet module
-      </member>
-     </simplelist>
-     The latter form is new to PHP 4, and provides significantly improved
-     performance and some new functionality. The CLI version is designed to use
-     PHP for command line scripting. More information about CLI is available in
-     the chapter about
-     <link linkend="features.commandline">using PHP from the command line</link>
+     This install guide will help you manually install and configure PHP on your
+     Microsoft Windows webserver. You need to download the zip binary distribution
+     from the downloads page at
+     <ulink url="&url.php.downloads;">&url.php.downloads;</ulink> to get started. 
     </para>
-    <warning>
-     <simpara>
-      The SAPI modules have been significantly improved in the 4.1 release, 
-      however, you may find that you encounter possible server errors or 
-      other server modules such as ASP failing, in older systems.
-     </simpara>
-    </warning>
-    <note>
-     <title>DCOM and MDAC requirements</title>
-      <para>
-       If you choose one of the SAPI modules and use
-       <emphasis>Windows 95</emphasis>, be sure to download and install the DCOM
-       update from the <ulink url="&url.dcom.update;">Microsoft DCOM pages</ulink>.
-       If you use Microsoft <emphasis>Windows 9x/NT4</emphasis> download the
-       latest version of the Microsoft Data Access Components (MDAC) for your
-       platform. MDAC is available at <ulink url="&url.mdac;">&url.mdac;</ulink>.
+    
+    <para>
+     Although there are all-in-one installation kits and we also distribute an
+     installer for Microsoft Windows, we recommend you to take some time and set
+     up PHP yourself, since this provides better understanding of the system, and
+     enables you to install PHP extensions easily whenever you need.
+    <para>
+    
+    <note id="install.windows.manual.upgrade">
+     <title>Upgrading from a previous PHP version</title>
+     <para>
+      Previous editions of this manual suggested that you move ini files and DLLs
+      around your folders, and thus you might have PHP related files in multiple
+      folders on your hard drive. We advise you to remove all these files (php.ini
+      from the Windows folder, PHP related DLLs from the Windows system folder),
+      before going on with the installation. Make sure you have backups of those
+      DLLs, since you might be able to brake your entire system. The old ini file
+      might be useful in setting up your new PHP as well.
      </para>
-    </note>    
+    </note>
+    
     <para>
      The following steps should be performed on all installations before any
      server specific instructions.
      <itemizedlist>
       <listitem>
-       <simpara>
+       <para>
         Extract the distribution file to a directory of your choice,
-        <filename class="directory">c:\</filename> is a good start. The zip package 
expands to a
-        foldername like <filename>php-4.3.1-Win32</filename> which is assumed to
-        be renamed to <filename>php</filename>. For the sake of convenience and
-        to be version independent the following steps assume your extracted
-        version of PHP lives in <filename class="directory">c:\php</filename>. You 
might choose
-        any other location but you probably do not want to use a path in which
-        spaces are included (for example:
-        <filename class="directory">C:\Program Files\PHP</filename> is not a good 
idea). Some web
-        servers will crash if you do. The structure of your directory you
-        extracted the zip file will look like:
-       </simpara>
-      </listitem>
-     </itemizedlist>
-     <informalexample>
-      <programlisting>
+        <filename class="directory">c:\</filename> is a good start. The zip
+        package expands to a foldername like <filename>php-4.3.7-Win32</filename>
+        which is assumed to be renamed to <filename>php</filename>. For the sake
+        of convenience and to be version independent, the following steps assume
+        your extracted version of PHP lives in <filename
+        class="directory">c:\php</filename>. You might choose any other location but
+        you probably do not want to use a path in which spaces are included. Using
+        a folder, like <filename class="directory">C:\Program Files\PHP</filename>
+        is not a good idea. Some web servers will crash if you do. The structure of
+        your directory you extracted the zip file will look like:
+       </para>
+       <example>
+        <title>PHP 4 package structure</title>
+        <programlisting>
 <![CDATA[
 
 c:\php
@@ -81,8 +59,7 @@
    |  |
    |  |-php.exe           -- CLI executable - ONLY for commandline scripting
    |
-   |
-   +--dlls                -- support dlls for extensions --> Windows system directory
+   +--dlls                -- support DLLs required by some extensions
    |  |
    |  |-expat.dll
    |  |
@@ -90,7 +67,7 @@
    |  |
    |  |-...
    |
-   +--extensions          -- extension dlls for PHP
+   +--extensions          -- extension DLLs for PHP
    |  |
    |  |-php_bz2.dll
    |  |
@@ -100,24 +77,24 @@
    |
    +--mibs                -- support files for SNMP
    |
-   |
    +--openssl             -- support files for Openssl
    |
-   |
    +--pdf-related         -- support files for PDF
    |
-   |
-   +--sapi                -- SAPI dlls
+   +--sapi                -- SAPI (server module support) DLLs
+   |  |
+   |  |-php4activescript.dll
    |  |
    |  |-php4apache.dll
    |  |
    |  |-php4apache2.dll
    |  |
-   |  |-php4isapi.dll
-   |  |
    |  |-..
    |
-   |-install.txt
+   +--PEAR                -- initial copy of PEAR
+   |
+   |
+   |-go-pear.bat          -- PEAR setup script
    |
    |-..
    |
@@ -125,38 +102,156 @@
    |
    |-..
    |
-   |-php.ini-dist
+   |-php.ini-dist         -- default php.ini settings
    |
-   |-php.ini-recommended
+   |-php.ini-recommended  -- recommended php.ini settings
    | 
-   |-php4ts.dll           -- main dll --> Windows system directory
+   |-php4ts.dll           -- core PHP DLL
    | 
    |-...
 
+]]>
+        </programlisting>
+       </example> 
+       <para>
+        In case you have downloaded and extracted PHP 5, it has a somewhat
+        different folder structure:
+       </para>
+       <example>
+        <title>PHP 5 package structure</title>
+        <programlisting>
+<![CDATA[
+
+c:\php
+   |
+   +--dev
+   |  |
+   |  |-php5ts.lib
+   |
+   +--ext                 -- extension DLLs for PHP
+   |  |
+   |  |-php_bz2.dll
+   |  |
+   |  |-php_cpdf.dll
+   |  |
+   |  |-..
+   |
+   +--extras
+   |  |
+   |  +--mibs             -- support files for SNMP
+   |  |
+   |  +--openssl          -- support files for Openssl
+   |  |
+   |  +--pdf-related      -- support files for PDF
+   |  |
+   |  |-mime.magic
+   |
+   +--pear                -- initial copy of PEAR
+   |
+   |
+   |-go-pear.bat          -- PEAR setup script
+   |
+   |-fdftk.dll
+   |
+   |-..
+   |
+   |-php-cgi.exe          -- CGI executable
+   |
+   |-php-win.exe          -- executes scripts without an opened command prompt
+   |
+   |-php.exe              -- CLI executable - ONLY for command line scripting
+   |
+   |-..
+   |
+   |-php.ini-dist         -- default php.ini settings
+   |
+   |-php.ini-recommended  -- recommended php.ini settings
+   | 
+   |-php5activescript.dll
+   | 
+   |-..
+   |
+   |-php5ts.dll           -- core PHP DLL
+   | 
+   |-...
 
 ]]>
-      </programlisting>
-     </informalexample> 
-    </para>
-    <para>
-     The  CGI binary - <filename>c:\php\php.exe</filename> -, the CLI binary
-     - <filename>c:\php\cli\php.exe</filename> -, and the SAPI modules
-     - <filename>c:\php\sapi\*.dll</filename> -  rely on the main dll
-     <filename>c:\php\php4ts.dll</filename>. You have to make sure, that this
-     dll can be found by your PHP installation. The search order for this dll
-     is as follows:
-     <simplelist>
-      <member>
-       The same directory from where <filename>php.exe</filename> is called.
-       In case you use a SAPI module the same directory from where your 
-       webserver loads the dll (e.g. <filename>php4apache.dll</filename>).
-      </member>
-      <member>
-       Any directory in your Windows <varname>PATH</varname> environment variable.
-      </member>
-     </simplelist>
-     <itemizedlist>
-      <listitem> 
+        </programlisting>
+       </example> 
+    
+       <para>
+        Note that PHP 4 and PHP 5 for Windows both have a CGI executable, a CLI
+        executable and server modules, but they are located in different folders.
+        While PHP 4 packages have the server modules in the sapi folder, these
+        are included right in the PHP folder in PHP 5 distributions. The supporting
+        DLLs for PHP extensions are also in the main PHP 5 folder. Watch out for
+        the different locations of the CGI and CLI executables too!
+       </para>
+       <para>
+        Here is a list of server modules shipped with PHP 4 and PHP 5.
+        <simplelist>
+         <member>
+          <filename>sapi/php4activescript.dll (php5activescript.dll)</filename> -
+          <link linkend="install.windows.activescript">ActiveScript engine</link>,
+          allowing you to embed PHP in your Windows applications.
+         </member>
+         <member>
+          <filename>sapi/php4apache.dll (php5apache.dll)</filename> - Apache 1.3.x 
module.
+         </member>
+         <member>
+          <filename>sapi/php4apache2.dll (php5apache2.dll)</filename> - Apache 2.0.x 
module.
+         </member>
+         <member>
+          <filename>sapi/php4isapi.dll (php5isapi.dll)</filename> - ISAPI Module
+          for ISAPI compliant webservers like IIS 4.0/PWS 4.0 or newer.
+         </member>
+         <member>
+          <filename>sapi/php4nsapi.dll (php5nsapi.dll)</filename> - 
Sun/iPlanet/Netscape
+          server module.
+         </member>
+         <member>
+          <filename>sapi/php4pi3web.dll (no equivalent in PHP5)</filename> - Pi3Web 
server module.
+         </member>
+         <!-- TODO: servlets? -->
+        </simplelist>
+       <para>
+       <para>
+        Server modules provide significantly better performance and some more
+        functionality compared to the CGI binary. The CLI version is designed
+        to let you use PHP for command line scripting. More information about
+        CLI is available in the chapter about <link
+        linkend="features.commandline">using PHP from the command line</link>.
+       </para>
+       <warning>
+        <simpara>
+         The SAPI modules have been significantly improved in the 4.1 release, 
+         however, you may find that you encounter possible server errors or 
+         other server modules such as ASP failing, in older systems.
+        </simpara>
+       </warning>
+
+       <para>
+        The CGI and CLI binaries, and the web server modules all require the
+        <filename>php4ts.dll<filename> (<filename>php5ts.dll<filename>) file
+        to be available to them. You have to make sure, that this file can be
+        found by your PHP installation. The search order for this DLL is as
+        follows:
+        <simplelist>
+         <member>
+          The same directory from where <filename>php.exe</filename> is
+          called. In case you use a SAPI module the same directory from
+          where your webserver loads the dll
+          (e.g. <filename>php4apache.dll</filename>).
+         </member>
+         <member>
+          Any directory in your Windows <varname>PATH</varname> environment
+          variable.
+         </member>
+        </simplelist>
+       </para>
+       
+<!-- WARNING: the instructions presented below still need serious revision!!!!!!! -->
+       
        <para>
         The best bet is to make <filename>php4ts.dll</filename> available,
         regardless which interface (CGI or SAPI module) you plan to use. To do so,

Reply via email to