philip Tue Mar 29 01:49:55 2005 EDT
Modified files:
/phpdoc/en/install/windows iis.xml
Log:
Added a new "General considerations" section that documents many things needed
for installing PHP on IIS. Gathered much of this from various tutorials and
user notes.
Also removed some unneeded information.
http://cvs.php.net/diff.php/phpdoc/en/install/windows/iis.xml?r1=1.10&r2=1.11&ty=u
Index: phpdoc/en/install/windows/iis.xml
diff -u phpdoc/en/install/windows/iis.xml:1.10
phpdoc/en/install/windows/iis.xml:1.11
--- phpdoc/en/install/windows/iis.xml:1.10 Mon Mar 28 21:38:37 2005
+++ phpdoc/en/install/windows/iis.xml Tue Mar 29 01:49:49 2005
@@ -1,36 +1,82 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
<sect1 id="install.windows.iis">
<title>Microsoft IIS / PWS</title>
<para>
This section contains notes and hints specific to IIS (Microsoft
- Internet Information Server). We have included installation
- instructions for <link linkend="install.windows.iis.iis3">PWS/IIS 3</link>,
- <link linkend="install.windows.iis.pws4">PWS 4 or newer</link> and
- <link linkend="install.windows.iis.iis4">IIS 4 or newer</link> versions.
+ Internet Information Server).
</para>
- <note>
- <title>Important for CGI users</title>
+ &warn.install.cgi;
+
+ <sect2 id="install.windows.iis.general">
+ <title>General considerations for all installations of PHP with IIS</title>
<para>
- Read the <link linkend="faq.installation.forceredirect">faq
- on cgi.force_redirect</link> for important details. This
- directive needs to be set to <literal>0</literal>.
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ First, read the <link linkend="install.windows.manual">Manual
+ Installation Instructions</link>. Do not skip this step as it
+ provides crucial information for installing PHP on Windows.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ CGI users must set the <link linkend="ini.cgi.force-redirect">
+ cgi.force_redirect</link> PHP directive to <literal>0</literal>
+ inside &php.ini;. Read the
+ <link linkend="faq.installation.forceredirect">faq on
+ cgi.force_redirect</link> for important details.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ The PHP 4 CGI is named <filename>php.exe</filename> while in PHP 5 it's
+ <filename>php-cgi.exe</filename>. In PHP 5, <filename>php.exe</filename>
+ is the CLI, and not the CGI.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Modify the Windows <literal>PATH</literal> environment variable to
+ include the PHP directory. This way the PHP DLL files, PHP executables,
+ and &php.ini; can all remain in the PHP directory without cluttering
+ up the Windows system directory. For more details, see the FAQ on
+ <link linkend="faq.installation.addtopath">Setting the PATH</link>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Be sure the <link linkend="ini.extension-dir">extension_dir</link>
+ and <link linkend="ini.doc-root">doc_root</link> PHP directives are
+ appropriately set in &php.ini;. These directives depend on the system
+ that PHP is being installed on. In PHP 4, the extension_dir is
+ <filename>extensions</filename> while with PHP 5 it's
+ <filename>ext</filename>. So, an example PHP 5 extensions_dir value is
+ <filename>"c:\php\ext"</filename> and an example IIS doc_root value is
+ <filename>"c:\Inetpub\wwwroot"</filename>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ PHP extension DLL files, such as <filename>php_mysql.dll</filename> and
+ <filename>php_curl.dll</filename>, are found in the zip package of the
+ PHP download (not the PHP installer). In PHP 5, many extensions are part
+ of PECL and can be downloaded in the "Collection of PECL modules"
+ package. Files such as <filename>php_zip.dll</filename> and
+ <filename>php_ssh2.dll</filename>.
+ <ulink url="&url.php.downloads;">Download PHP files here</ulink>.
+ </simpara>
+ </listitem>
+ </itemizedlist>
</para>
- </note>
- &warn.install.cgi;
+ </sect2>
<sect2 id="install.windows.iis.iis4">
- <title>Windows NT/2000/XP and IIS 4 or newer</title>
-
- <simpara>
- To install PHP on an NT/2000/XP Server running IIS 4 or newer,
- follow these instructions. You have two options to set up
- PHP, using the CGI binary (<filename>php.exe</filename> in PHP 4, or
- <filename>php-cgi.exe</filename> in PHP 5) or with the ISAPI module.
- </simpara>
+ <title>Windows NT/200x/XP and IIS 4 or newer</title>
<simpara>
+ PHP may be installed as a CGI binary, or with the ISAPI module.
In either case, you need to start the Microsoft Management
Console (may appear as 'Internet Services Manager', either
in your Windows NT 4.0 Option Pack branch or the Control
