updating install/windows and pages linking to it

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@339251 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Matt Ficken 2016-06-01 06:23:30 +00:00
parent 1d7caa1a60
commit 17fc359d7e
26 changed files with 513 additions and 171 deletions

View file

@ -493,17 +493,17 @@ cgi error:
<para>
There are several ways of doing this. If you are using Apache, read
their installation specific instructions (<link
linkend="install.windows.apache1">Apache 1</link>, <link
linkend="install.windows.apache2">Apache 2</link>), otherwise you must
linkend="install.windows.legacy.apache1">Apache 1</link>, <link
linkend="install.windows.legacy.apache2">Apache 2</link>), otherwise you must
set the <varname>PHPRC</varname> environment variable:
</para>
<para>
On Windows NT, 2000, XP and 2003:
On Windows:
<itemizedlist>
<listitem><para>
Go to Control Panel and open the System icon (Start → Settings
→ Control Panel → System, or just Start → Control Panel
→ System for Windows XP/2003)
→ System)
</para></listitem>
<listitem><para>
Go to the Advanced tab

View file

@ -192,9 +192,8 @@
</question>
<answer>
<para>
See the manual section about
<link linkend="install.windows.building">building PHP from
source on Windows</link>.
See the PHP Wiki for the latest instructions: <link xlink:href="https://wiki.php.net/internals/windows/stepbystepbuild">Step by Step Build Instructions</link>
</para>
</answer>
</qandaentry>

View file

@ -1292,7 +1292,7 @@ This is a command line PHP script with one option.
<para>
On Windows, PHP can be configured to run without the need to
supply the <filename>C:\php\php.exe</filename> or the <literal>.php</literal>
extension, as described in <link linkend="install.windows.commandline">Command
extension, as described in <link linkend="install.windows.legacy.commandline">Command
Line PHP on Microsoft Windows</link>.
</para>
</section>

View file

@ -1,15 +1,47 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.cloud.azure" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Microsoft Azure</title>
<sect1 xml:id="install.cloud.azure" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Azure App Services</title>
<para>
PHP installs on the <link xlink:href="&url.cloud.azure;">Azure cloud platform</link>.
PHP is frequently used on Azure App Services (aka Microsoft Azure, Windows Azure, Azure Web Apps).
</para>
<para>
See also the <link xlink:href="&url.cloud.azure.sdk;">Azure SDK for PHP</link>.
<para>Azure App Services manages pools of Windows Web Servers to host your web application, as an alternative to managing your own web server on your own Azure Compute VMs or other servers.
</para>
<para>PHP is already enabled for your Azure App Services web site automatically. In the Azure Portal, select your web site, and you can choose which version of PHP to use. You may want to choose a newer version than the default.
</para>
</sect1>
<para>As such, PHP and extensions will run on Azure App Services just as it will on other Windows servers.
Much of the knowledgebase is also portable, so see the <!--<link linkend="install.windows.troubleshooting">Windows Troubleshooting Page</link> too.-->
However, the management interface for Azure App Services is different:
</para>
<para>Azure portal: create, edit settings and delete web sites. <link xlink:href="https://portal.azure.com/">Azure Portal</link>
</para>
<para>Kudu Dashboard: [your web site name].azurewebsites.net Then, the Kudu dashboard is https://[your web site name].scm.azurewebsites.net/. The Dashboard gives you access to some debugging capabilities, file management and site extensions. Site extensions are an Azure mechanism to add extra programs, like PHP preview builds, to your web site.
</para>
<para>You can not use IIS Manager, Server Manager, or RDP.</para>
<para>There is also a PHP SDK for programmatically using many Azure Services from your PHP code. See <link xlink:href="https://github.com/Azure/azure-sdk-for-php">Azure SDK for PHP</link>.
</para>
<sect2>
<title>WinCache</title>
<para>WinCache is enabled by default on Azure App Services and it is recommended that you leave it enabled.
If you install your own build of PHP, you should enable WinCache on that too.
</para>
</sect2>
<sect2>
<title>Custom PHP Build</title>
<para>You may upload your own PHP build to your D:\Home (C:\ is NOT writable). Then in the Azure Portal, set SCRIPT_PROCESSOR for .php to the absolute path to php-cgi.exe file in your build.
</para>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View file

@ -92,10 +92,11 @@ $ svn checkout http://svn.php.net/repository/pecl/extname/trunk extname
Windows downloads
</simpara>
<simpara>
TODO
At this time the PHP project does not compile Windows binaries for
PECL extensions. However, to compile PHP under Windows see the
chapter titled
<link linkend="install.windows.building">building PHP for Windows</link>.
<link linkend="install.windows.legacy.building">building PHP for Windows</link>.
</simpara>
</listitem>
</itemizedlist>
@ -113,11 +114,11 @@ $ svn checkout http://svn.php.net/repository/pecl/extname/trunk extname
(see next section for the download).
</para>
<para>
To compile an extension into PHP, please refer to <link linkend="install.windows.building">
To compile an extension into PHP, please refer to <link linkend="install.windows.legacy.building">
building from source</link> documentation.
</para>
<para>
To compile a standalone extension (aka a DLL file), please refer to <link linkend="install.windows.building">
To compile a standalone extension (aka a DLL file), please refer to <link linkend="install.windows.legacy.building">
building from source</link> documentation. If the DLL file is available neither with your
PHP distribution nor in PECL, you may have to compile it before you can start using the
extension.

View file

@ -1,52 +1,75 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter xml:id="install.windows" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Installation on Windows systems</title>
<para>
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.
</para>
<chapter xml:id="install.windows" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Installation on Windows systems</title>
<para>
Installing PHP on modern Microsoft Windows systems and recommended configuration with common web servers.
</para>
<note>
<para>
Windows XP/2003 are no longer supported as of PHP 5.5.0.
</para>
</note>
<note>
<para>
Windows 98/Me/NT4/2000 are no longer supported as of PHP 5.3.0.
</para>
</note>
<note>
<para>
Windows 95 is no longer supported as of PHP 4.3.0.
</para>
</note>
<para>
If you have a development environment such as Microsoft Visual Studio, you can also
<link linkend="install.windows.building">build</link>
PHP from the original source code.
</para>
<para>
Once you have PHP installed on your Windows system, you may also
want to <link linkend="install.windows.extensions">load various extensions</link>
for added functionality.
</para>
&install.windows.legacy.manual;
&install.windows.legacy.iis;
&install.windows.legacy.iis6;
&install.windows.legacy.iis7;
&install.windows.legacy.apache1;
&install.windows.legacy.apache2;
&install.windows.legacy.sun;
&install.windows.legacy.sambar;
&install.windows.legacy.xitami;
&install.windows.legacy.building;
&install.windows.legacy.extensions;
&install.windows.legacy.commandline;
</chapter>
<para>
If you are looking for information about older systems, such as Windows XP, 2003, 98 or Apache 1.x, see the <link linkend="install.windows.legacy.index">Legacy Info</link> section.
</para>
</note>
<para>
The Official releases of PHP on Windows are recommended for production use.
However, you are welcome to build PHP from Source. You will need a Visual Studio environment. See <link xlink:href="https://wiki.php.net/internals/windows/stepbystepbuild">Step by Step Build Instructions</link>.
</para>
<para>
<link linkend="install.windows.legacy.commandline">Using PHP on Windows Command line</link>
<!--&install.windows.manual;-->
<link linkend="install.cloud.azure">Installing PHP on Azure App Services</link> (aka Microsoft Azure, Windows Azure, or (Windows) Azure Web Apps).
</para>
<sect1>
<title>Install Requirements</title>
<para>PHP 5.5+ require at least Windows 2008/Vista, or 2008r2, 2012, 2012r2, 2016 or 7, 8, 8.1, 10. Either 32-Bit or 64-bit (aka X86 or X64. PHP does not run on Windows RT/WOA/ARM).</para>
<para>PHP requires the Visual C runtime(CRT). Many applications require that so it may already be installed.
PHP 5.4, 5.5, 5.6 requires VC CRT 11 (Visual Studio 2012). See: <link xlink:href="https://www.microsoft.com/en-us/download/details.aspx?id=30679">https://www.microsoft.com/en-us/download/details.aspx?id=30679</link>
PHP 7.0+ requires VC CRT 14 (Visual Studio 2015). See: <link xlink:href="https://www.microsoft.com/en-us/download/details.aspx?id=48145">https://www.microsoft.com/en-us/download/details.aspx?id=48145</link>
You MUST download the x86 CRT for PHP x86 builds and the x64 CRT for PHP x64 builds.
If CRT is already installed, the installer will tell you that and not change anything.
The CRT installer supports the /quiet and /norestart command-line switches, so you can script running it.
VC11 CRT DLLs can be copied from your local machine to a remote machine(a `Copy Deployment` installation) instead of running the installer on the remote machine (such as a web server you have restricted access to). See: http://www.sitepoint.com/install-php53-windows/
VC14 CRT does not support a `Copy Deployment` installation. VC14 CRT has many more DLLs(most in files with names starting with api-*). If you can find them all and copy them, it will also work (try a tool like Resource Hacker to get a list of all the DLLs to copy).
</para>
</sect1>
<sect1>
<title>PECL</title>
<para>PECL extensions are pre-built for Windows and available from: <link xlink:href="http://windows.php.net/downloads/pecl/releases/">http://windows.php.net/downloads/pecl/releases/</link>
</para>
<para>Some extensions use features specific to some Unix systems and so are not available on Windows. Otherwise, all extensions are available for Windows.
</para>
</sect1>
<!-- Critical: ensure all pages in install/windows and that install/windows/legacy/index are referenced here!
otherwise you will get IDREF attribute errors for all links -->
&install.windows.tools;
&install.windows.recommended;
&install.windows.manual;
&install.windows.troubleshooting;
&install.windows.legacy.index;
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@ -66,4 +89,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

View file

@ -1,16 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.apache1" xmlns="http://docbook.org/ns/docbook">
<sect2 xml:id="install.windows.legacy.apache1" xmlns="http://docbook.org/ns/docbook">
<title>Apache 1.3.x on Microsoft Windows</title>
<para>
This section contains notes and hints specific to Apache 1.3.x installs
of PHP on Microsoft Windows systems. There are also
<link linkend="install.windows.apache2">instructions and notes
for Apache 2</link> on a separate page.
<!--<link linkend="install.windows.legacy.apache2">instructions and notes
for Apache 2</link> on a separate page.-->
</para>
<note>
<para>
Please read the <link linkend="install.windows.manual">manual
Please read the <link linkend="install.windows.legacy.manual">manual
installation steps</link> first!
</para>
</note>
@ -46,7 +46,7 @@
&note.apache.slashes;
<sect2 xml:id="install.windows.apache1.module">
<sect3 xml:id="install.windows.legacy.apache1.module">
<title>Installing as an Apache module</title>
<para>
You should add the following lines to your Apache &httpd.conf; file:
@ -97,14 +97,14 @@ AddType application/x-httpd-php-source .phps
</programlisting>
</example>
</para>
</sect2>
</sect3>
<sect2 xml:id="install.windows.apache1.cgi">
<sect3 xml:id="install.windows.legacy.apache1.cgi">
<title>Installing as a CGI binary</title>
<para>
If you unzipped the PHP package to <filename>C:\php\</filename> as described
in the <link linkend="install.windows.manual">Manual
in the <link linkend="install.windows.legacy.manual">Manual
Installation Steps</link> section, you need to insert
these lines to your Apache configuration file to set
up the CGI binary:
@ -140,9 +140,9 @@ SetEnv PHPRC C:/php
do this simply create a PHP script file and add this code:
<literal>&lt;?php highlight_file('some_php_script.php'); ?&gt;</literal>.
</simpara>
</sect2>
</sect3>
</sect1>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,16 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Apache 2.x on Microsoft Windows</title>
<para>
This section contains notes and hints specific to Apache 2.x installs
of PHP on Microsoft Windows systems. We also
have <link linkend="install.windows.apache1">instructions and notes
for Apache 1.3.x users on a separate page</link>.
<!--have <link linkend="install.windows.legacy.apache1">instructions and notes
for Apache 1.3.x users on a separate page</link>.-->
</para>
<note>
<para>
You should read the <link linkend="install.windows.manual">manual
You should read the <link linkend="install.windows.legacy.manual">manual
installation steps</link> first!
</para>
</note>
@ -42,7 +42,7 @@
<para>
Download the most recent version of <link xlink:href= "&url.apache;">
Apache 2.x</link> and a fitting PHP version.
Follow the <link linkend="install.windows.manual">Manual Installation
Follow the <link linkend="install.windows.legacy.manual">Manual Installation
Steps</link> and come back to go on with the integration of PHP and Apache.
</para>
@ -53,7 +53,7 @@
&note.apache.slashes;
<sect2 xml:id="install.windows.apache2.module">
<sect3 xml:id="install.windows.apache2.legacy.module">
<title>Installing as an Apache handler</title>
<para>
You need to insert the following lines into your
@ -101,9 +101,9 @@ PHPIniDir "C:/php"
]]>
</programlisting>
</example>
</sect2>
</sect3>
<sect2 xml:id="install.windows.apache2.cgi">
<sect3 xml:id="install.windows.apache2.legacy.cgi">
<title>Running PHP as CGI</title>
<para>
@ -134,9 +134,9 @@ PHPIniDir "C:/php"
</example>
</para>
&warn.install.cgi;
</sect2>
</sect3>
<sect2 xml:id="install.windows.apache2.fastcgi">
<sect3 xml:id="install.windows.apache2.legacy.fastcgi">
<title>Running PHP under FastCGI</title>
<para>
@ -172,9 +172,9 @@ FcgidWrapper "c:/php/php-cgi.exe" .php
wrapper.
</para>
</sect2>
</sect3>
</sect1>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.building" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.building" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Building from source</title>
<para>
This chapter teaches how to compile PHP from sources on windows, using
@ -11,7 +11,7 @@
See the Wiki documentation at:
<link xlink:href="&url.wiki.windows.build.howto;">&url.wiki.windows.build.howto;</link>
</para>
</sect1>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Command Line PHP on Microsoft Windows</title>
<para>
This section contains notes and hints specific to getting PHP running
@ -8,7 +8,7 @@
</para>
<note>
<para>
You should read the <link linkend="install.windows.manual">manual
You should read the <link linkend="install.windows.legacy.manual">manual
installation steps</link> first!
</para>
</note>
@ -185,7 +185,7 @@ Windows Registry Editor Version 5.00
Microsoft forum post</link> provides the explanation.
</para>
</note>
</sect1>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.extensions" xmlns="http://docbook.org/ns/docbook">
<sect2 xml:id="install.windows.legacy.extensions" xmlns="http://docbook.org/ns/docbook">
<title>Installation of extensions on Windows</title>
<para>
After installing PHP and a web server on Windows, you will probably want to
@ -17,7 +17,7 @@
of PHP. This means additional DLL files, and the
<link linkend="ini.extension">extension</link> directive, are
<emphasis>not</emphasis> used to load these extensions. The Windows
<link linkend ="install.windows.extensions.overview">PHP Extensions</link>
<link linkend ="install.windows.legacy.extensions.overview">PHP Extensions</link>
table lists extensions that require, or used to require, additional PHP
DLL files. Here's a list of built in extensions (updated PHP 5.0.4):
<link linkend="book.bc">BCMath</link>,
@ -111,7 +111,7 @@ extension=php_bz2.dll
<para>
The following table describes some of the extensions available and required
additional dlls.
<table xml:id="install.windows.extensions.overview">
<table xml:id="install.windows.legacy.extensions.overview">
<title>PHP Extensions</title>
<tgroup cols="3">
<thead>
@ -390,7 +390,7 @@ extension=php_bz2.dll
</tgroup>
</table>
</para>
</sect1>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.iis" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.iis" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Microsoft IIS</title>
<para>
This section contains PHP installation instructions specific to Microsoft Internet Information Services (IIS).
@ -8,16 +8,16 @@
<itemizedlist>
<listitem>
<simpara>
<link linkend="install.windows.iis6">Manually installing PHP on Microsoft IIS 5.1 and IIS 6.0</link>
<link linkend="install.windows.legacy.iis6">Manually installing PHP on Microsoft IIS 5.1 and IIS 6.0</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="install.windows.iis7">Manually installing PHP on Microsoft IIS 7.0 and later</link>
<link linkend="install.windows.legacy.iis7">Manually installing PHP on Microsoft IIS 7.0 and later</link>
</simpara>
</listitem>
</itemizedlist>
</sect1>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,20 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.iis6" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.iis6" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Microsoft IIS 5.1 and IIS 6.0</title>
<para>
This section contains instructions for manually setting up Internet Information
Services (IIS) 5.1 and IIS 6.0 to work with PHP on Microsoft Windows XP and Windows
Server 2003. For instructions on setting up IIS 7.0 and later versions on Windows
Vista, Windows Server 2008, Windows 7 and Windows Server 2008 R2 refer to
<link linkend="install.windows.iis7">Microsoft IIS 7.0 and later</link>.
<link linkend="install.windows.legacy.iis7">Microsoft IIS 7.0 and later</link>.
</para>
<sect2 xml:id="install.windows.iis6.fastcgi">
<sect3 xml:id="install.windows.legacy.iis6.fastcgi">
<title>Configuring IIS to process PHP requests</title>
<para>
Download and install PHP in accordance to the instructions described in
<link linkend="install.windows.manual">manual installation steps</link>
<link linkend="install.windows.legacy.manual">manual installation steps</link>
<note>
<para>
Non-thread-safe build of PHP is recommended when using IIS. The non-thread-safe
@ -66,8 +66,8 @@ cscript %windir%\system32\inetsrv\fcgiconfig.js -add -section:"PHP" ^
</para>
</note>
</para>
</sect2>
<sect2 xml:id="install.windows.iis6.impersonation">
</sect3>
<sect3 xml:id="install.windows.legacy.iis6.impersonation">
<title>Impersonation and file system access</title>
<para>
It is recommended to enable FastCGI impersonation in PHP when using IIS. This
@ -123,8 +123,8 @@ icacls C:\inetpub\wwwroot\upload /grant IUSR:(OI)(CI)(M)
</programlisting>
</example>
</para>
</sect2>
<sect2 xml:id="install.windows.iis6.defaultdoc">
</sect3>
<sect3 xml:id="install.windows.legacy.iis6.defaultdoc">
<title>Set <filename>index.php</filename> as a default document in IIS</title>
<para>
The IIS default documents are used for HTTP requests that do not specify a document name. With PHP applications,
@ -151,8 +151,8 @@ icacls C:\inetpub\wwwroot\upload /grant IUSR:(OI)(CI)(M)
</imageobject>
</mediaobject>
</para>
</sect2>
<sect2 xml:id="install.windows.iis6.recycling">
</sect3>
<sect3 xml:id="install.windows.legacy.iis6.recycling">
<title>FastCGI and PHP Recycling configuration</title>
<para>
Configure IIS FastCGI extension settings for recycling of PHP processes by using the commands shown below.
@ -174,8 +174,8 @@ cscript %windir%\system32\inetsrv\fcgiconfig.js -set -section:"PHP" ^
</programlisting>
</example>
</para>
</sect2>
<sect2 xml:id="install.windows.iis6.timeouts">
</sect3>
<sect3 xml:id="install.windows.legacy.iis6.timeouts">
<title>Configuring FastCGI timeout settings</title>
<para>
Increase the timeout settings for FastCGI extension if there are applications that have long running PHP scripts.
@ -195,8 +195,8 @@ cscript %windir%\system32\inetsrv\fcgiconfig.js -set -section:"PHP" ^
</programlisting>
</example>
</para>
</sect2>
<sect2 xml:id="install.windows.iis6.phpinilocation">
</sect3>
<sect3 xml:id="install.windows.legacy.iis6.phpinilocation">
<title>Changing the Location of <filename>php.ini</filename> file</title>
<para>
PHP searches for <filename>php.ini</filename> file in
@ -216,8 +216,8 @@ cscript %windir%\system32\inetsrv\fcgiconfig.js -set -section:"PHP" ^
</programlisting>
</example>
</para>
</sect2>
</sect1>
</sect3>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,16 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.iis7" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.iis7" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Microsoft IIS 7.0 and later</title>
<para>
This section contains instructions for manually setting up Internet Information
Services (IIS) 7.0 and later to work with PHP on Microsoft Windows Vista SP1,
Windows 7, Windows Server 2008 and Windows Server 2008 R2. For instructions
on setting up IIS 5.1 and IIS 6.0 on Windows XP and Windows Server 2003 refer to
<link linkend="install.windows.iis6">Microsoft IIS 5.1 and IIS 6.0</link>.
<link linkend="install.windows.legacy.iis6">Microsoft IIS 5.1 and IIS 6.0</link>.
</para>
<sect2 xml:id="install.windows.iis7.fastcgi.enable">
<sect3 xml:id="install.windows.legacy.iis7.fastcgi.enable">
<title>Enabling FastCGI support in IIS</title>
<para>
FastCGI module is disabled in default installation of IIS. The steps to enable it differ
@ -79,12 +79,12 @@
</imageobject>
</mediaobject>
</para>
</sect2>
<sect2 xml:id="install.windows.iis7.fastcgi.conf">
</sect3>
<sect3 xml:id="install.windows.legacy.iis7.fastcgi.conf">
<title>Configuring IIS to process PHP requests</title>
<para>
Download and install PHP in accordance to the instructions described in
<link linkend="install.windows.manual">manual installation steps</link>
<link linkend="install.windows.legacy.manual">manual installation steps</link>
<note>
<para>
Non-thread-safe build of PHP is recommended when using IIS. The non-thread-safe
@ -110,7 +110,7 @@ cgi.force_redirect = 0
<para>
Configure IIS handler mapping for PHP by using either IIS Manager user interface or a command line tool.
</para>
<sect3 xml:id="install.windows.iis7.fastcgi.conf.ui">
<sect4 xml:id="install.windows.legacy.iis7.fastcgi.conf.ui">
<title>Using IIS Manager user interface to create a handler mapping for PHP</title>
<para>
Follow these steps to create an IIS handler mapping for PHP in IIS Manager user interface:
@ -171,8 +171,8 @@ cgi.force_redirect = 0
</imageobject>
</mediaobject>
</para>
</sect3>
<sect3 xml:id="install.windows.iis7.fastcgi.conf.cmd">
</sect4>
<sect4 xml:id="install.windows.legacy.iis7.fastcgi.conf.cmd">
<title>Using command line tool to create a handler mapping for PHP</title>
<para>
Use the command shown below to create an IIS FastCGI process pool which will use <filename>php-cgi.exe</filename>
@ -213,9 +213,9 @@ scriptProcessor='c:\PHP\php-cgi.exe',resourceType='Either']
</para>
</note>
</para>
</sect3>
</sect2>
<sect2 xml:id="install.windows.iis7.impersonation">
</sect4>
</sect3>
<sect3 xml:id="install.windows.legacy.iis7.impersonation">
<title>Impersonation and file system access</title>
<para>
It is recommended to enable FastCGI impersonation in PHP when using IIS. This
@ -274,8 +274,8 @@ icacls C:\inetpub\wwwroot\upload /grant IUSR:(OI)(CI)(M)
</programlisting>
</example>
</para>
</sect2>
<sect2 xml:id="install.windows.iis7.defaultdoc">
</sect3>
<sect3 xml:id="install.windows.legacy.iis7.defaultdoc">
<title>Set <filename>index.php</filename> as a default document in IIS</title>
<para>
The IIS default documents are used for HTTP requests that do not specify a
@ -293,8 +293,8 @@ icacls C:\inetpub\wwwroot\upload /grant IUSR:(OI)(CI)(M)
</programlisting>
</example>
</para>
</sect2>
<sect2 xml:id="install.windows.iis7.recycling">
</sect3>
<sect3 xml:id="install.windows.legacy.iis7.recycling">
<title>FastCGI and PHP Recycling configuration</title>
<para>
Configure IIS FastCGI settings for recycling of PHP processes by using the commands shown below.
@ -318,8 +318,8 @@ icacls C:\inetpub\wwwroot\upload /grant IUSR:(OI)(CI)(M)
</programlisting>
</example>
</para>
</sect2>
<sect2 xml:id="install.windows.iis7.timeouts">
</sect3>
<sect3 xml:id="install.windows.legacy.iis7.timeouts">
<title>FastCGI timeout settings</title>
<para>
Increase the timeout settings for FastCGI if it is expected to have long running PHP scripts.
@ -340,8 +340,8 @@ icacls C:\inetpub\wwwroot\upload /grant IUSR:(OI)(CI)(M)
</programlisting>
</example>
</para>
</sect2>
<sect2 xml:id="install.windows.iis7.phpinilocation">
</sect3>
<sect3 xml:id="install.windows.legacy.iis7.phpinilocation">
<title>Changing the Location of <filename>php.ini</filename> file</title>
<para>
PHP searches for <filename>php.ini</filename> file in
@ -362,8 +362,8 @@ appcmd.exe set config -section:system.webServer/fastCgi ^
</programlisting>
</example>
</para>
</sect2>
</sect1>
</sect3>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -0,0 +1,69 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 339222 $ -->
<sect1 xml:id="install.windows.legacy.index" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Installation on old Windows systems</title>
<para>
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.
</para>
<note>
<para>
Windows XP/2003 are no longer supported as of PHP 5.5.0.
</para>
</note>
<note>
<para>
Windows 98/Me/NT4/2000 are no longer supported as of PHP 5.3.0.
</para>
</note>
<note>
<para>
Windows 95 is no longer supported as of PHP 4.3.0.
</para>
</note>
<para>
If you have a development environment such as Microsoft Visual Studio, you can also
<!--<link linkend="install.windows.legacy.building">build</link>-->
PHP from the original source code.
</para>
<para>
Once you have PHP installed on your Windows system, you may also
want to <link linkend="install.windows.legacy.extensions">load various extensions</link>
for added functionality.
</para>
&install.windows.legacy.manual;
&install.windows.legacy.iis;
&install.windows.legacy.iis6;
&install.windows.legacy.iis7;
&install.windows.legacy.apache1;
&install.windows.legacy.apache2;
&install.windows.legacy.sun;
&install.windows.legacy.sambar;
&install.windows.legacy.xitami;
&install.windows.legacy.building;
&install.windows.legacy.extensions;
&install.windows.legacy.commandline;
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.manual" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.manual" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Manual Installation Steps</title>
<para>
This section contains instructions for manually installing and configuring
PHP on Microsoft Windows.
</para>
<sect2 xml:id="install.windows.manual.download">
<sect3 xml:id="install.windows.legacy.manual.download">
<title>Selecting and downloading the PHP distribution package</title>
<para>
Download the PHP zip binary distribution from
@ -14,8 +14,8 @@
There are several different versions of the zip package - to choose the right version for you,
follow the detailed guide on the <link xlink:href="&url.php.win.downloads;">download page</link>.
</para>
</sect2>
<sect2 xml:id="install.windows.manual.package">
</sect3>
<sect3 xml:id="install.windows.legacy.manual.package">
<title>The PHP package structure and content</title>
<para>
Unpack the content of the zip archive into a directory of your choice, for
@ -113,8 +113,8 @@ c:\php
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 xml:id="install.windows.manual.phpini">
</sect3>
<sect3 xml:id="install.windows.legacy.manual.phpini">
<title>Changing the <filename>php.ini</filename> file</title>
<para>
After the php package content has been extracted, copy the <filename>php.ini-production</filename> into <filename>php.ini</filename>
@ -236,11 +236,11 @@ c:\php
<para>
In addition to running PHP via a web server, PHP can run from the command
line just like a <literal>.BAT</literal> script. See
<link linkend="install.windows.commandline">Command Line PHP on Microsoft
Windows</link> for further details.
<!--<link linkend="install.windows.legacy.commandline">Command Line PHP on Microsoft
Windows</link> for further details.-->
</para>
</sect2>
</sect1>
</sect3>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.sambar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.sambar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Sambar Server on Microsoft Windows</title>
<para>
This section contains notes and hints specific to the
@ -8,7 +8,7 @@
</para>
<note>
<para>
You should read the <link linkend="install.windows.manual">manual
You should read the <link linkend="install.windows.legacy.manual">manual
installation steps</link> first!
</para>
</note>
@ -63,7 +63,7 @@
option from within the Windows Control Panel Administation Tools.
</para>
</note>
</sect1>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.sun" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.sun" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Sun, iPlanet and Netscape servers on Microsoft Windows</title>
<para>
This section contains notes and hints specific to Sun Java System Web Server,
@ -9,14 +9,14 @@
<para>
From PHP 4.3.3 on you can use PHP scripts with the
<link linkend="ref.nsapi">NSAPI module</link> to
<link linkend="install.windows.sun.specialpages">generate custom
directory listings and error pages</link>. Additional functions for
<!--<link linkend="install.windows.legacy.sun.specialpages">generate custom
directory listings and error pages</link>. Additional functions for-->
Apache compatibility are also available. For support in current web servers
read the <link linkend="install.windows.sun.notes">note about
subrequests</link>.
<!--read the <link linkend="install.windows.legacy.sun.notes">note about
subrequests</link>.-->
</para>
<sect2 xml:id="install.windows.sun.cgi">
<sect3 xml:id="install.windows.legacy.sun.cgi">
<title>CGI setup on Sun, iPlanet and Netscape servers</title>
<para>
To install PHP as a CGI handler, do the following:
@ -66,9 +66,9 @@ ftype PHPScript=c:\php\php.exe %1 %*
PHP as a CGI executable can be found here:
<link xlink:href="&url.netscape.cgi;">&url.netscape.cgi;</link>
</para>
</sect2>
</sect3>
<sect2 xml:id="install.windows.sun.nsapi">
<sect3 xml:id="install.windows.legacy.sun.nsapi">
<title>NSAPI setup on Sun, iPlanet and Netscape servers</title>
<para>
To install PHP with NSAPI, do the following:
@ -182,9 +182,9 @@ Service fn=php4_execute [inikey=value inikey=value ...]
(in the section &quot;MAGNUS EDITOR&quot;).
</para>
</note>
</sect2>
</sect3>
<sect2 xml:id="install.windows.sun.phpini">
<sect3 xml:id="install.windows.legacy.sun.phpini">
<title>CGI environment and recommended modifications in &php.ini;</title>
<para>
Important when writing PHP scripts is the fact that Sun JSWS/Sun ONE
@ -225,9 +225,9 @@ register_globals = On
]]>
</programlisting>
</para>
</sect2>
</sect3>
<sect2 xml:id="install.windows.sun.specialpages">
<sect3 xml:id="install.windows.legacy.sun.specialpages">
<title>Special use for error pages or self-made directory listings (PHP &gt;= 4.3.3)</title>
<para>
You can use PHP to generate the error pages for <literal>"404 Not Found"</literal>
@ -259,9 +259,9 @@ Service fn="php4_execute" type="magnus-internal/directory" script="/path/to/scri
translated URI are in the variables <varname>$_SERVER['PATH_INFO']</varname> and
<varname>$_SERVER['PATH_TRANSLATED']</varname>.
</para>
</sect2>
</sect3>
<sect2 xml:id="install.windows.sun.notes">
<sect3 xml:id="install.windows.legacy.sun.notes">
<title>Note about <function>nsapi_virtual</function> and subrequests (PHP &gt;= 4.3.3)</title>
<para>
The NSAPI module now supports the <function>nsapi_virtual</function> function
@ -303,8 +303,8 @@ Init fn=php4_init ... server_lib="ns-httpdXX.dll"
But be warned: Support for <function>nsapi_virtual</function> is EXPERIMENTAL!!!
</para>
</note>
</sect2>
</sect1>
</sect3>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.xitami" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<sect2 xml:id="install.windows.legacy.xitami" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Xitami on Microsoft Windows</title>
<para>
This section contains notes and hints specific to
@ -8,7 +8,7 @@
</para>
<note>
<para>
You should read the <link linkend="install.windows.manual">manual
You should read the <link linkend="install.windows.legacy.manual">manual
installation steps</link> first!
</para>
</note>
@ -65,7 +65,7 @@
</listitem>
</itemizedlist>
</para>
</sect1>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -0,0 +1,65 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.manual" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Manual PHP Installation on Windows</title>
<sect2>
<title>Choose Web Server</title>
<para>
IIS is builtin to Windows.
On Windows Server, use Server Manager to add the IIS role. Be sure to include the CGI Role Feature.
On Windows Desktop, use Control Panel's Add/Remove Programs to add IIS. See: <link xlink:href="https://msdn.microsoft.com/en-us/library/ms181052%28v=vs.80%29.aspx?f=255&amp;MSPPError=-2147217396">https://msdn.microsoft.com/en-us/library/ms181052%28v=vs.80%29.aspx?f=255&amp;MSPPError=-2147217396</link>
For desktop web apps and web-development, you can also use IIS/Express or PHP Desktop
<link linkend="install.windows.legacy.iis7">How to manually configure IIS</link>
There are several builds of Apache2 for Windows.
We support ApacheLounge, but other options include XAMPP, WampServer and BitNami, which provide automatic installer tools.
You may use mod_php or mod_fastcgi to load PHP on Apache.
If you use mod_php, you MUST use a TS build of Apache built with same version of Visual C and same CPU (x86 or x64).
<link linkend="install.windows.legacy.apache2">How to manually configure Apache2</link>
</para>
</sect2>
<sect2>
<title>Choose Build</title>
<para>
Download PHP production releases from <link xlink:href="http://windows.php.net/downloads/release/">http://windows.php.net/downloads/release/</link>.
A lot of testing and optimization is already done on the snapshot and qa releases, but you are welcome to help us do more.
There are 4 types of PHP builds:
Thread-Safe(TS) - use for single process web serves, like Apache with mod_php
Non-Thread-Safe(NTS) - use for IIS and other FastCGI web servers (Apache with mod_fastcgi) and recommended for command-line scripts
x86 - production use of PHP 5.5 or 5.6 or 7.0.
x64 - production use of PHP 7.0+ unless its a 32-bit only version of Windows. 5.5 and 5.6 x64 are expiremental.
</para>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,83 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.recommended" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Recommended Configuration on Windows systems</title>
<sect2>
<title>OpCache</title>
<para>
Highly Recommended that you enable OpCache. This extension is included with PHP for Windows. It compiles and optimizes PHP scripts and caches them in memory so that they aren't compiled every time the page is loaded.
</para>
<para>
In your php.ini, set zend_extension=php_opcache.dll opcache.enable=On opcache.cli_anble=On
And restart your web server.
For more info, see: http://php.net/manual/en/opcache.configuration.php
</para>
</sect2>
<sect2>
<title>WinCache</title>
<para>
Recommended that you use WinCache if using IIS, especially if in a shared web hosting environment or using networked file storage (NAS).
All PHP Applications automatically benefit from WinCache's file cache feature. File system operations are cached in memory.
WinCache also can cache user objects in memory and share them between php.exe or php-cgi.exe processes (share objects between requests).
Many major web applications have a plugin or extension or configuration option to make use of the WinCache user object cache.
If you need high performance, you should use the object cache in your applications.
See: http://pecl.php.net/package/WinCache to download a WinCache DLL (or tgz) to your PHP extensions directory (extensions_dir in your php.ini).
In your php.ini, set extension=php_wincache.dll wincache.fcenabled=1 wincache.ocenabled=1
For more info, see: http://php.net/manual/en/wincache.configuration.php
</para>
</sect2>
<sect2>
<title>IIS Configuration</title>
<para>In IIS Manager, Install FastCGI module and add a handler mapping for `.php` to the path to PHP-CGI.exe (not PHP.exe)</para>
<para>
You may use the APPCMD command line tool to script IIS configuration. See attached script TODO.
</para>
</sect2>
<sect2>
<title>Database</title>
<para>You'll probably need a Database Server. Popular databases provide PHP extensions to use them. If your web site doesn't get a lot of traffic, you can run your database server on the same server as your web server. Many popular database servers run on Windows.</para>
<para>PHP includes mysqli and pdo_mysql extensions. PHP 5.5 and 5.6 include mysql extension (deprecated in 7.0).</para>
<para>See <link xlink:href="https://dev.mysql.com/downloads/windows/">https://dev.mysql.com/downloads/windows/</link></para>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

36
install/windows/tools.xml Normal file
View file

@ -0,0 +1,36 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.tools" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>PHP Installer Tools on Windows</title>
<sect2>
<title>PHP Install Tools</title>
<para>
If you want to setup PHP, some common PHP applications and are using IIS, the easiest way is to use Microsoft's Web Platform Installer (WebPI).
</para>
<para>XAMPP, WampServer and BitNami will setup PHP applications for use with Apache on Windows.</para>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,34 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<sect1 xml:id="install.windows.troubleshooting" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Troubleshooting PHP on Windows</title>
<sect2>
<title>Check Temp Directory Permissions</title>
<para>Right-click temp directory in File Explorer to get the permissions. For IIS, check that user IIS_User has MODIFY permission. You can get the temporary directory from the configuration or php info.
</para>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -1126,7 +1126,7 @@ this extension is still available within <acronym xmlns="http://docbook.org/ns/d
<!ENTITY pecl.windows.download 'A <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> for this
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> extension is currently unavailable. See also the
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.building">building on Windows</link>
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.legacy.building">building on Windows</link>
section.'>
<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>

View file

@ -38,7 +38,7 @@
<para>
Read the note about subrequests in the NSAPI section (<link
linkend="install.unix.sun.notes">UNIX</link>, <link
linkend="install.windows.sun.notes">Windows</link>) if you experience
linkend="install.windows.legacy.sun.notes">Windows</link>) if you experience
this problem.
</para>
</note>

View file

@ -17,7 +17,7 @@
<para>
For PHP installation on Netscape/iPlanet/Sun webservers see the
NSAPI section (<link linkend="install.unix.sun">UNIX</link>,
<link linkend="install.windows.sun">Windows</link>) in the installation
<link linkend="install.windows.legacy.sun">Windows</link>) in the installation
chapter.
</para>
</section>