diff --git a/faq/installation.xml b/faq/installation.xml
index 593f290084..1b641b712d 100644
--- a/faq/installation.xml
+++ b/faq/installation.xml
@@ -493,17 +493,17 @@ cgi error:
There are several ways of doing this. If you are using Apache, read
their installation specific instructions (Apache 1, Apache 2), otherwise you must
+ linkend="install.windows.legacy.apache1">Apache 1, Apache 2), otherwise you must
set the PHPRC environment variable:
- On Windows NT, 2000, XP and 2003:
+ On Windows:
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)
Go to the Advanced tab
diff --git a/faq/obtaining.xml b/faq/obtaining.xml
index a299be3d95..5ceb69de11 100644
--- a/faq/obtaining.xml
+++ b/faq/obtaining.xml
@@ -192,9 +192,8 @@
- See the manual section about
- building PHP from
- source on Windows.
+ See the PHP Wiki for the latest instructions: Step by Step Build Instructions
+
diff --git a/features/commandline.xml b/features/commandline.xml
index f6134cc43c..a26b8bb89c 100644
--- a/features/commandline.xml
+++ b/features/commandline.xml
@@ -1292,7 +1292,7 @@ This is a command line PHP script with one option.
On Windows, PHP can be configured to run without the need to
supply the C:\php\php.exe or the .php
- extension, as described in Command
+ extension, as described in Command
Line PHP on Microsoft Windows.
diff --git a/install/cloud/azure.xml b/install/cloud/azure.xml
index f61114edc0..38b4b18f69 100644
--- a/install/cloud/azure.xml
+++ b/install/cloud/azure.xml
@@ -1,15 +1,47 @@
-
- Microsoft Azure
+
+ Azure App Services
- PHP installs on the Azure cloud platform.
+ PHP is frequently used on Azure App Services (aka Microsoft Azure, Windows Azure, Azure Web Apps).
-
- See also the Azure SDK for PHP.
+ 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.
+
+ 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.
-
+ 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
+
+ However, the management interface for Azure App Services is different:
+
+
+ Azure portal: create, edit settings and delete web sites. Azure Portal
+
+ 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.
+
+
+ You can not use IIS Manager, Server Manager, or RDP.
+
+ There is also a PHP SDK for programmatically using many Azure Services from your PHP code. See Azure SDK for PHP.
+
+
+
+ WinCache
+ 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.
+
+
+
+
+ Custom PHP Build
+ 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.
+
+
+
+
-
- Installation on Windows systems
-
- 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.
-
+
+ Installation on Windows systems
+
+ Installing PHP on modern Microsoft Windows systems and recommended configuration with common web servers.
+
-
- Windows XP/2003 are no longer supported as of PHP 5.5.0.
-
-
-
-
- Windows 98/Me/NT4/2000 are no longer supported as of PHP 5.3.0.
-
-
-
-
- Windows 95 is no longer supported as of PHP 4.3.0.
-
-
-
- If you have a development environment such as Microsoft Visual Studio, you can also
- build
- PHP from the original source code.
-
-
- Once you have PHP installed on your Windows system, you may also
- want to load various extensions
- for added functionality.
-
-
- &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;
-
+
+ If you are looking for information about older systems, such as Windows XP, 2003, 98 or Apache 1.x, see the Legacy Info section.
+
+
+
+
+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 Step by Step Build Instructions.
+
+
+Using PHP on Windows Command line
+
+
+
+Installing PHP on Azure App Services (aka Microsoft Azure, Windows Azure, or (Windows) Azure Web Apps).
+
+
+
+
+ Install Requirements
+
+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).
+
+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: https://www.microsoft.com/en-us/download/details.aspx?id=30679
+
+PHP 7.0+ requires VC CRT 14 (Visual Studio 2015). See: https://www.microsoft.com/en-us/download/details.aspx?id=48145
+
+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).
+
+
+
+
+
+
+ PECL
+
+PECL extensions are pre-built for Windows and available from: http://windows.php.net/downloads/pecl/releases/
+
+
+ Some extensions use features specific to some Unix systems and so are not available on Windows. Otherwise, all extensions are available for Windows.
+
+
+
+
+
+
+ &install.windows.tools;
+ &install.windows.recommended;
+ &install.windows.manual;
+ &install.windows.troubleshooting;
+ &install.windows.legacy.index;
+
+-->
\ No newline at end of file
diff --git a/install/windows/legacy/apache1.xml b/install/windows/legacy/apache1.xml
index c8b6638d4c..d057eb90a0 100644
--- a/install/windows/legacy/apache1.xml
+++ b/install/windows/legacy/apache1.xml
@@ -1,16 +1,16 @@
-
+ Apache 1.3.x on Microsoft Windows
This section contains notes and hints specific to Apache 1.3.x installs
of PHP on Microsoft Windows systems. There are also
- instructions and notes
- for Apache 2 on a separate page.
+
- Please read the manual
+ Please read the manual
installation steps first!
@@ -46,7 +46,7 @@
¬e.apache.slashes;
-
+ Installing as an Apache module
You should add the following lines to your Apache &httpd.conf; file:
@@ -97,14 +97,14 @@ AddType application/x-httpd-php-source .phps
-
+
-
+ Installing as a CGI binary
If you unzipped the PHP package to C:\php\ as described
- in the Manual
+ in the Manual
Installation Steps 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:
<?php highlight_file('some_php_script.php'); ?>.
-
+
-
+
-
+ Apache 2.x on Microsoft Windows
This section contains notes and hints specific to Apache 2.x installs
of PHP on Microsoft Windows systems. We also
- have instructions and notes
- for Apache 1.3.x users on a separate page.
+
- You should read the manual
+ You should read the manual
installation steps first!
@@ -42,7 +42,7 @@
Download the most recent version of
Apache 2.x and a fitting PHP version.
- Follow the Manual Installation
+ Follow the Manual Installation
Steps and come back to go on with the integration of PHP and Apache.
@@ -53,7 +53,7 @@
¬e.apache.slashes;
-
+ Installing as an Apache handler
You need to insert the following lines into your
@@ -101,9 +101,9 @@ PHPIniDir "C:/php"
]]>
-
+
-
+ Running PHP as CGI
@@ -134,9 +134,9 @@ PHPIniDir "C:/php"
&warn.install.cgi;
-
+
-
+ Running PHP under FastCGI
@@ -172,9 +172,9 @@ FcgidWrapper "c:/php/php-cgi.exe" .php
wrapper.
-
+
-
+
-
+Building from source
This chapter teaches how to compile PHP from sources on windows, using
@@ -11,7 +11,7 @@
See the Wiki documentation at:
&url.wiki.windows.build.howto;
-
+
-
+ Command Line PHP on Microsoft Windows
This section contains notes and hints specific to getting PHP running
@@ -8,7 +8,7 @@
- You should read the manual
+ You should read the manual
installation steps first!
@@ -185,7 +185,7 @@ Windows Registry Editor Version 5.00
Microsoft forum post provides the explanation.
-
+
-
+ Installation of extensions on Windows
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
extension directive, are
not used to load these extensions. The Windows
- PHP Extensions
+ PHP Extensions
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):
BCMath,
@@ -111,7 +111,7 @@ extension=php_bz2.dll
The following table describes some of the extensions available and required
additional dlls.
-
-
+
-
+Microsoft IIS
This section contains PHP installation instructions specific to Microsoft Internet Information Services (IIS).
@@ -8,16 +8,16 @@
- Manually installing PHP on Microsoft IIS 5.1 and IIS 6.0
+ Manually installing PHP on Microsoft IIS 5.1 and IIS 6.0
- Manually installing PHP on Microsoft IIS 7.0 and later
+ Manually installing PHP on Microsoft IIS 7.0 and later
-
+
-
+Microsoft IIS 5.1 and IIS 6.0
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
- Microsoft IIS 7.0 and later.
+ Microsoft IIS 7.0 and later.
-
+ Configuring IIS to process PHP requests
Download and install PHP in accordance to the instructions described in
- manual installation steps
+ manual installation steps
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" ^
-
-
+
+ Impersonation and file system access
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)
-
-
+
+ Set index.php as a default document in IIS
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)
-
-
+
+ FastCGI and PHP Recycling configuration
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" ^
-
-
+
+ Configuring FastCGI timeout settings
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" ^
-
-
+
+ Changing the Location of php.ini file
PHP searches for php.ini file in
@@ -216,8 +216,8 @@ cscript %windir%\system32\inetsrv\fcgiconfig.js -set -section:"PHP" ^
-
-
+
+
-
+Microsoft IIS 7.0 and later
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
- Microsoft IIS 5.1 and IIS 6.0.
+ Microsoft IIS 5.1 and IIS 6.0.
-
+ Enabling FastCGI support in IIS
FastCGI module is disabled in default installation of IIS. The steps to enable it differ
@@ -79,12 +79,12 @@
-
-
+
+ Configuring IIS to process PHP requests
Download and install PHP in accordance to the instructions described in
- manual installation steps
+ manual installation steps
Non-thread-safe build of PHP is recommended when using IIS. The non-thread-safe
@@ -110,7 +110,7 @@ cgi.force_redirect = 0
Configure IIS handler mapping for PHP by using either IIS Manager user interface or a command line tool.
-
+ Using IIS Manager user interface to create a handler mapping for PHP
Follow these steps to create an IIS handler mapping for PHP in IIS Manager user interface:
@@ -171,8 +171,8 @@ cgi.force_redirect = 0
-
-
+
+ Using command line tool to create a handler mapping for PHP
Use the command shown below to create an IIS FastCGI process pool which will use php-cgi.exe
@@ -213,9 +213,9 @@ scriptProcessor='c:\PHP\php-cgi.exe',resourceType='Either']
-
-
-
+
+
+ Impersonation and file system access
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)
-
-
+
+ Set index.php as a default document in IIS
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)
-
-
+
+ FastCGI and PHP Recycling configuration
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)
-
-
+
+ FastCGI timeout settings
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)
-
-
+
+ Changing the Location of php.ini file
PHP searches for php.ini file in
@@ -362,8 +362,8 @@ appcmd.exe set config -section:system.webServer/fastCgi ^
-
-
+
+
+
+ Installation on old Windows systems
+
+ 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 XP/2003 are no longer supported as of PHP 5.5.0.
+
+
+
+
+ Windows 98/Me/NT4/2000 are no longer supported as of PHP 5.3.0.
+
+
+
+
+ Windows 95 is no longer supported as of PHP 4.3.0.
+
+
+
+ If you have a development environment such as Microsoft Visual Studio, you can also
+
+ PHP from the original source code.
+
+
+ Once you have PHP installed on your Windows system, you may also
+ want to load various extensions
+ for added functionality.
+
+
+ &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;
+
+
+
diff --git a/install/windows/legacy/manual.xml b/install/windows/legacy/manual.xml
index 69381d1c4e..a29b936cea 100644
--- a/install/windows/legacy/manual.xml
+++ b/install/windows/legacy/manual.xml
@@ -1,12 +1,12 @@
-
+ Manual Installation Steps
This section contains instructions for manually installing and configuring
PHP on Microsoft Windows.
-
+ Selecting and downloading the PHP distribution package
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 download page.
-
-
+
+ The PHP package structure and content
Unpack the content of the zip archive into a directory of your choice, for
@@ -113,8 +113,8 @@ c:\php
-
-
+
+ Changing the php.ini file
After the php package content has been extracted, copy the php.ini-production into php.ini
@@ -236,11 +236,11 @@ c:\php
In addition to running PHP via a web server, PHP can run from the command
line just like a .BAT script. See
- Command Line PHP on Microsoft
- Windows for further details.
+
-
-
+
+
-
+ Sambar Server on Microsoft Windows
This section contains notes and hints specific to the
@@ -8,7 +8,7 @@
- You should read the manual
+ You should read the manual
installation steps first!
@@ -63,7 +63,7 @@
option from within the Windows Control Panel Administation Tools.
-
+
-
+ Sun, iPlanet and Netscape servers on Microsoft Windows
This section contains notes and hints specific to Sun Java System Web Server,
@@ -9,14 +9,14 @@
From PHP 4.3.3 on you can use PHP scripts with the
NSAPI module to
- generate custom
- directory listings and error pages. Additional functions for
+
Apache compatibility are also available. For support in current web servers
- read the note about
- subrequests.
+
-
+ CGI setup on Sun, iPlanet and Netscape servers
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:
&url.netscape.cgi;
-
+
-
+ NSAPI setup on Sun, iPlanet and Netscape servers
To install PHP with NSAPI, do the following:
@@ -182,9 +182,9 @@ Service fn=php4_execute [inikey=value inikey=value ...]
(in the section "MAGNUS EDITOR").
-
+
-
+ CGI environment and recommended modifications in &php.ini;
Important when writing PHP scripts is the fact that Sun JSWS/Sun ONE
@@ -225,9 +225,9 @@ register_globals = On
]]>
-
+
-
+ Special use for error pages or self-made directory listings (PHP >= 4.3.3)
You can use PHP to generate the error pages for "404 Not Found"
@@ -259,9 +259,9 @@ Service fn="php4_execute" type="magnus-internal/directory" script="/path/to/scri
translated URI are in the variables $_SERVER['PATH_INFO'] and
$_SERVER['PATH_TRANSLATED'].
-
+
-
+ Note about nsapi_virtual and subrequests (PHP >= 4.3.3)
The NSAPI module now supports the nsapi_virtual function
@@ -303,8 +303,8 @@ Init fn=php4_init ... server_lib="ns-httpdXX.dll"
But be warned: Support for nsapi_virtual is EXPERIMENTAL!!!
-
-
+
+
-
+ Xitami on Microsoft Windows
This section contains notes and hints specific to
@@ -8,7 +8,7 @@
- You should read the manual
+ You should read the manual
installation steps first!
@@ -65,7 +65,7 @@
-
+
+
+ Manual PHP Installation on Windows
+
+ Choose Web Server
+
+ 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: https://msdn.microsoft.com/en-us/library/ms181052%28v=vs.80%29.aspx?f=255&MSPPError=-2147217396
+
+ For desktop web apps and web-development, you can also use IIS/Express or PHP Desktop
+
+ How to manually configure IIS
+
+ 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).
+
+ How to manually configure Apache2
+
+
+
+
+
+ Choose Build
+
+ Download PHP production releases from http://windows.php.net/downloads/release/.
+
+ 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.
+
+
+
+
\ No newline at end of file
diff --git a/install/windows/recommended.xml b/install/windows/recommended.xml
new file mode 100644
index 0000000000..936483bed0
--- /dev/null
+++ b/install/windows/recommended.xml
@@ -0,0 +1,83 @@
+
+
+
+Recommended Configuration on Windows systems
+
+
+ OpCache
+
+
+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.
+
+
+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
+
+
+
+
+ WinCache
+
+
+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
+
+
+
+
+ IIS Configuration
+
+ In IIS Manager, Install FastCGI module and add a handler mapping for `.php` to the path to PHP-CGI.exe (not PHP.exe)
+
+
+
+ You may use the APPCMD command line tool to script IIS configuration. See attached script TODO.
+
+
+
+
+ Database
+
+ 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.
+
+ PHP includes mysqli and pdo_mysql extensions. PHP 5.5 and 5.6 include mysql extension (deprecated in 7.0).
+
+ See https://dev.mysql.com/downloads/windows/
+
+
+
\ No newline at end of file
diff --git a/install/windows/tools.xml b/install/windows/tools.xml
new file mode 100644
index 0000000000..9281e20e80
--- /dev/null
+++ b/install/windows/tools.xml
@@ -0,0 +1,36 @@
+
+
+
+
+PHP Installer Tools on Windows
+
+
+ PHP Install Tools
+
+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).
+
+
+XAMPP, WampServer and BitNami will setup PHP applications for use with Apache on Windows.
+
+
+
+
\ No newline at end of file
diff --git a/install/windows/troubleshooting.xml b/install/windows/troubleshooting.xml
new file mode 100644
index 0000000000..88cfdcae0a
--- /dev/null
+++ b/install/windows/troubleshooting.xml
@@ -0,0 +1,34 @@
+
+
+
+
+Troubleshooting PHP on Windows
+
+
+ Check Temp Directory Permissions
+
+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.
+
+
+
+
+
\ No newline at end of file
diff --git a/language-snippets.ent b/language-snippets.ent
index e745b9c93c..d5a426c6c8 100644
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -1126,7 +1126,7 @@ this extension is still available within DLL for this
PECL extension is currently unavailable. See also the
-building on Windows
+building on Windows
section.'>
diff --git a/reference/nsapi/functions/nsapi-virtual.xml b/reference/nsapi/functions/nsapi-virtual.xml
index 9a41529cda..e130853c6a 100644
--- a/reference/nsapi/functions/nsapi-virtual.xml
+++ b/reference/nsapi/functions/nsapi-virtual.xml
@@ -38,7 +38,7 @@
Read the note about subrequests in the NSAPI section (UNIX, Windows) if you experience
+ linkend="install.windows.legacy.sun.notes">Windows) if you experience
this problem.
diff --git a/reference/nsapi/setup.xml b/reference/nsapi/setup.xml
index f78fad8388..684b961580 100644
--- a/reference/nsapi/setup.xml
+++ b/reference/nsapi/setup.xml
@@ -17,7 +17,7 @@
For PHP installation on Netscape/iPlanet/Sun webservers see the
NSAPI section (UNIX,
- Windows) in the installation
+ Windows) in the installation
chapter.