install/windows/index.xml
8e732e84a1425cf0ab3a5b0da8fe113c7a6da85e
...
...
@@ -1,98 +1,84 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
3
<chapter xml:id="install.windows" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4
-
<title>Installation on Windows systems</title>
5
-
<para>
6
-
Installing PHP on modern Microsoft Windows systems and recommended configuration with common web servers.
7
-
</para>
8
-
<note>
9
-
<para>
10
-
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.
11
-
</para>
12
-
</note>
13
-

14
-
<para>
15
-
The Official releases of PHP on Windows are recommended for production use.
16
-
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>.
17
-
</para>
18
-
<para>
19
-
<itemizedlist spacing="compact">
20
-
<listitem>
21
-
<para>
22
-
<link linkend="install.windows.legacy.commandline">Using PHP on Windows Command line</link>
23
-
</para>
24
-
</listitem>
25
-
<listitem>
26
-
<para>
27
-
<link linkend="install.cloud.azure">Installing PHP on Azure App Services</link> (aka Microsoft Azure, Windows Azure, or (Windows) Azure Web Apps).
28
-
</para>
29
-
</listitem>
30
-
</itemizedlist>
31
-
</para>
32
-

33
-
<sect1 xml:id="install.windows.requirements">
34
-
<title>Install Requirements</title>
35
-

36
-
<para>
37
-
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).
38
-
As of PHP 7.2.0 Windows 2008 and Vista are no longer supported.
39
-
</para>
40
-

41
-
<para>
42
-
PHP requires the Visual C runtime(CRT). Many applications require that so it may already be installed.
43
-
</para>
44
-

45
-
<para>
46
-
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>
47
-
</para>
48
-

4
+
<title>Installation on Windows systems</title>
5
+
<para>
6
+
Installing PHP on modern Microsoft Windows systems and recommended configuration with common web servers.
7
+
</para>
8
+

9
+
<para>
10
+
The Official releases of PHP on Windows are recommended for production use.
11
+
However, you are welcome to build PHP from Source.
12
+
You will need a Visual Studio environment.
13
+
See <link xlink:href="&url.install.windows.stepbystep;">Step by Step Build Instructions</link>.
14
+
</para>
15
+
<para>
16
+
<itemizedlist spacing="compact">
17
+
<listitem>
49
18
<para>
50
-
PHP 7.0 and 7.1 require VC CRT 14 (Visual Studio 2015).
51
-
PHP 7.2, 7.3 and 7.4 require VC CRT 15 (Visual Studio 2017).
52
-
The Microsoft Visual C++ Redistributable for Visual Studio 2019 is suitable
53
-
for all these PHP versions, see
54
-
<link xlink:href="https://visualstudio.microsoft.com/downloads/">https://visualstudio.microsoft.com/downloads/</link>.
19
+
<link linkend="install.windows.commandline">Using PHP on Windows Command line</link>
55
20
</para>
56
-

21
+
</listitem>
22
+
<listitem>
57
23
<para>
58
-
You MUST download the x86 CRT for PHP x86 builds and the x64 CRT for PHP x64 builds.
24
+
<link linkend="install.cloud.azure">Installing PHP on Azure App Services</link>
25
+
(aka Microsoft Azure, Windows Azure, or (Windows) Azure Web Apps).
59
26
</para>
27
+
</listitem>
28
+
</itemizedlist>
29
+
</para>
60
30

61
-
<para>
62
-
If CRT is already installed, the installer will tell you that and not change anything.
63
-
</para>
31
+
<sect1 xml:id="install.windows.requirements">
32
+
<title>Install Requirements</title>
64
33

65
-
<para>
66
-
The CRT installer supports the /quiet and /norestart command-line switches, so you can script running it.
67
-
</para>
68
-

69
-
<para>
70
-
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).
71
-
</para>
34
+
<para>
35
+
PHP requires at least Windows 2008/Vista.
36
+
Either 32-Bit or 64-bit (<acronym>AKA</acronym> X86 or X64. PHP does not run on Windows RT/WOA/ARM).
37
+
As of PHP 7.2.0 Windows 2008 and Vista are no longer supported.
38
+
</para>
72
39

73
-
<para>
74
-
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).
75
-
</para>
40
+
<para>
41
+
PHP requires the Visual C runtime (CRT). Many applications require that so it may already be installed.
42
+
</para>
76
43

77
-
</sect1>
44
+
<para>
45
+
The Microsoft Visual C++ Redistributable for Visual Studio 2019 is suitable
46
+
for all these PHP versions, see
47
+
<link xlink:href="https://visualstudio.microsoft.com/downloads/">https://visualstudio.microsoft.com/downloads/</link>.
48
+
</para>
78
49

79
-
<sect1 xml:id="install.windows.pecl">
80
-
<title>PECL</title>
50
+
<para>
51
+
You MUST download the x86 CRT for PHP x86 builds and the x64 CRT for PHP x64 builds.
52
+
</para>
81
53

82
-
<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>
83
-
</para>
54
+
<para>
55
+
If CRT is already installed, the installer will tell you that and not change anything.
56
+
</para>
84
57

85
-
<para>Some extensions use features specific to some Unix systems and so are not available on Windows. Otherwise, all extensions are available for Windows.
86
-
</para>
87
-
</sect1>
58
+
<para>
59
+
The CRT installer supports the /quiet and /norestart command-line switches, so you can script running it.
60
+
</para>
61
+
</sect1>
88
62

89
-
<!-- Critical: ensure all pages in install/windows and that install/windows/legacy/index are referenced here!
90
-
otherwise you will get IDREF attribute errors for all links -->
91
-
&install.windows.tools;
92
-
&install.windows.recommended;
93
-
&install.windows.manual;
94
-
&install.windows.troubleshooting;
95
-
&install.windows.legacy.index;
63
+
<sect1 xml:id="install.windows.pecl">
64
+
<title>PECL</title>
65
+
<para>
66
+
PECL extensions are pre-built for Windows and available from:
67
+
<link xlink:href="http://windows.php.net/downloads/pecl/releases/">http://windows.php.net/downloads/pecl/releases/</link>
68
+
</para>
69
+
<para>
70
+
Some extensions use features specific to some Unix systems and so are not available on Windows.
71
+
Otherwise, all extensions are available for Windows.
72
+
</para>
73
+
</sect1>
74
+

75
+
&install.windows.tools;
76
+
&install.windows.recommended;
77
+
&install.windows.manual;
78
+
&install.windows.building;
79
+
&install.windows.commandline;
80
+
&install.windows.apache2;
81
+
&install.windows.troubleshooting;
96
82
</chapter>
97
83
<!-- Keep this comment at the end of the file
98
84
Local variables:
99
85