php-doc-en/install/windows/index.xml
Christoph Michael Becker 9581609f43 Fix MSVCRT version information
Only master needs CRT 16, as correctly pointed out in user note 124611.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@348910 c90b9560-bf6c-de11-be94-00142212c4b1
2020-01-14 12:11:44 +00:00

116 lines
4.6 KiB
XML

<?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>
Installing PHP on modern Microsoft Windows systems and recommended configuration with common web servers.
</para>
<note>
<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>
<itemizedlist spacing="compact">
<listitem>
<para>
<link linkend="install.windows.legacy.commandline">Using PHP on Windows Command line</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="install.cloud.azure">Installing PHP on Azure App Services</link> (aka Microsoft Azure, Windows Azure, or (Windows) Azure Web Apps).
</para>
</listitem>
</itemizedlist>
</para>
<sect1 xml:id="install.windows.requirements">
<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).
As of PHP 7.2.0 Windows 2008 and Vista are no longer supported.
</para>
<para>
PHP requires the Visual C runtime(CRT). Many applications require that so it may already be installed.
</para>
<para>
PHP 5.5 and 5.6 require 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>
</para>
<para>
PHP 7.0 and 7.1 require VC CRT 14 (Visual Studio 2015).
PHP 7.2, 7.3 and 7.4 require VC CRT 15 (Visual Studio 2017).
The Microsoft Visual C++ Redistributable for Visual Studio 2019 is suitable
for all these PHP versions, see
<link xlink:href="https://visualstudio.microsoft.com/downloads/">https://visualstudio.microsoft.com/downloads/</link>.
</para>
<para>
You MUST download the x86 CRT for PHP x86 builds and the x64 CRT for PHP x64 builds.
</para>
<para>
If CRT is already installed, the installer will tell you that and not change anything.
</para>
<para>
The CRT installer supports the /quiet and /norestart command-line switches, so you can script running it.
</para>
<para>
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).
</para>
<para>
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 xml:id="install.windows.pecl">
<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
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
-->