Skip to content

Commit 17fc359

Browse files
author
Matt Ficken
committed
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
1 parent 1d7caa1 commit 17fc359

26 files changed

Lines changed: 513 additions & 171 deletions

‎faq/installation.xml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -493,17 +493,17 @@ cgi error:
493493
<para>
494494
There are several ways of doing this. If you are using Apache, read
495495
their installation specific instructions (<link
496-
linkend="install.windows.apache1">Apache 1</link>, <link
497-
linkend="install.windows.apache2">Apache 2</link>), otherwise you must
496+
linkend="install.windows.legacy.apache1">Apache 1</link>, <link
497+
linkend="install.windows.legacy.apache2">Apache 2</link>), otherwise you must
498498
set the <varname>PHPRC</varname> environment variable:
499499
</para>
500500
<para>
501-
On Windows NT, 2000, XP and 2003:
501+
On Windows:
502502
<itemizedlist>
503503
<listitem><para>
504504
Go to Control Panel and open the System icon (Start → Settings
505505
→ Control Panel → System, or just Start → Control Panel
506-
→ System for Windows XP/2003)
506+
→ System)
507507
</para></listitem>
508508
<listitem><para>
509509
Go to the Advanced tab

‎faq/obtaining.xml‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -192,9 +192,8 @@
192192
</question>
193193
<answer>
194194
<para>
195-
See the manual section about
196-
<link linkend="install.windows.building">building PHP from
197-
source on Windows</link>.
195+
See the PHP Wiki for the latest instructions: <link xlink:href="https://wiki.php.net/internals/windows/stepbystepbuild">Step by Step Build Instructions</link>
196+
198197
</para>
199198
</answer>
200199
</qandaentry>

‎features/commandline.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1292,7 +1292,7 @@ This is a command line PHP script with one option.
12921292
<para>
12931293
On Windows, PHP can be configured to run without the need to
12941294
supply the <filename>C:\php\php.exe</filename> or the <literal>.php</literal>
1295-
extension, as described in <link linkend="install.windows.commandline">Command
1295+
extension, as described in <link linkend="install.windows.legacy.commandline">Command
12961296
Line PHP on Microsoft Windows</link>.
12971297
</para>
12981298
</section>

‎install/cloud/azure.xml‎

Lines changed: 38 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,47 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<sect1 xml:id="install.cloud.azure" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4-
<title>Microsoft Azure</title>
3+
<sect1 xml:id="install.cloud.azure" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<title>Azure App Services</title>
55
<para>
6-
PHP installs on the <link xlink:href="&url.cloud.azure;">Azure cloud platform</link>.
6+
PHP is frequently used on Azure App Services (aka Microsoft Azure, Windows Azure, Azure Web Apps).
77
</para>
8-
<para>
9-
See also the <link xlink:href="&url.cloud.azure.sdk;">Azure SDK for PHP</link>.
8+
<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.
9+
</para>
10+
<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.
11+
</para>
12+
13+
<para>As such, PHP and extensions will run on Azure App Services just as it will on other Windows servers.
14+
15+
Much of the knowledgebase is also portable, so see the <!--<link linkend="install.windows.troubleshooting">Windows Troubleshooting Page</link> too.-->
16+
17+
However, the management interface for Azure App Services is different:
18+
</para>
19+
20+
<para>Azure portal: create, edit settings and delete web sites. <link xlink:href="https://portal.azure.com/">Azure Portal</link>
21+
</para>
22+
<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.
23+
</para>
24+
25+
<para>You can not use IIS Manager, Server Manager, or RDP.</para>
26+
27+
<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>.
28+
</para>
29+
30+
<sect2>
31+
<title>WinCache</title>
32+
<para>WinCache is enabled by default on Azure App Services and it is recommended that you leave it enabled.
33+
34+
If you install your own build of PHP, you should enable WinCache on that too.
35+
</para>
36+
</sect2>
37+
38+
<sect2>
39+
<title>Custom PHP Build</title>
40+
<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.
1041
</para>
11-
</sect1>
42+
</sect2>
1243

44+
</sect1>
1345
<!-- Keep this comment at the end of the file
1446
Local variables:
1547
mode: sgml

‎install/pecl.xml‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -92,10 +92,11 @@ $ svn checkout http://svn.php.net/repository/pecl/extname/trunk extname
9292
Windows downloads
9393
</simpara>
9494
<simpara>
95+
TODO
9596
At this time the PHP project does not compile Windows binaries for
9697
PECL extensions. However, to compile PHP under Windows see the
9798
chapter titled
98-
<link linkend="install.windows.building">building PHP for Windows</link>.
99+
<link linkend="install.windows.legacy.building">building PHP for Windows</link>.
99100
</simpara>
100101
</listitem>
101102
</itemizedlist>
@@ -113,11 +114,11 @@ $ svn checkout http://svn.php.net/repository/pecl/extname/trunk extname
113114
(see next section for the download).
114115
</para>
115116
<para>
116-
To compile an extension into PHP, please refer to <link linkend="install.windows.building">
117+
To compile an extension into PHP, please refer to <link linkend="install.windows.legacy.building">
117118
building from source</link> documentation.
118119
</para>
119120
<para>
120-
To compile a standalone extension (aka a DLL file), please refer to <link linkend="install.windows.building">
121+
To compile a standalone extension (aka a DLL file), please refer to <link linkend="install.windows.legacy.building">
121122
building from source</link> documentation. If the DLL file is available neither with your
122123
PHP distribution nor in PECL, you may have to compile it before you can start using the
123124
extension.

‎install/windows/index.xml‎

Lines changed: 69 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,75 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
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-
This section applies to Windows 98/Me and Windows NT/2000/XP/2003. PHP
7-
will not work on 16 bit platforms such as Windows 3.1 and sometimes
8-
we refer to the supported Windows platforms as Win32.
9-
</para>
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>
108
<note>
11-
<para>
12-
Windows XP/2003 are no longer supported as of PHP 5.5.0.
13-
</para>
14-
</note>
15-
<note>
16-
<para>
17-
Windows 98/Me/NT4/2000 are no longer supported as of PHP 5.3.0.
18-
</para>
19-
</note>
20-
<note>
21-
<para>
22-
Windows 95 is no longer supported as of PHP 4.3.0.
23-
</para>
24-
</note>
25-
<para>
26-
If you have a development environment such as Microsoft Visual Studio, you can also
27-
<link linkend="install.windows.building">build</link>
28-
PHP from the original source code.
29-
</para>
30-
<para>
31-
Once you have PHP installed on your Windows system, you may also
32-
want to <link linkend="install.windows.extensions">load various extensions</link>
33-
for added functionality.
34-
</para>
35-
36-
&install.windows.legacy.manual;
37-
&install.windows.legacy.iis;
38-
&install.windows.legacy.iis6;
39-
&install.windows.legacy.iis7;
40-
&install.windows.legacy.apache1;
41-
&install.windows.legacy.apache2;
42-
&install.windows.legacy.sun;
43-
&install.windows.legacy.sambar;
44-
&install.windows.legacy.xitami;
45-
&install.windows.legacy.building;
46-
&install.windows.legacy.extensions;
47-
&install.windows.legacy.commandline;
48-
</chapter>
9+
<para>
10+
11+
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.
12+
</para>
13+
</note>
14+
15+
<para>
16+
The Official releases of PHP on Windows are recommended for production use.
17+
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>.
18+
</para>
19+
<para>
20+
<link linkend="install.windows.legacy.commandline">Using PHP on Windows Command line</link>
21+
22+
<!--&install.windows.manual;-->
23+
24+
<link linkend="install.cloud.azure">Installing PHP on Azure App Services</link> (aka Microsoft Azure, Windows Azure, or (Windows) Azure Web Apps).
25+
</para>
26+
27+
28+
<sect1>
29+
<title>Install Requirements</title>
30+
31+
<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>
32+
33+
<para>PHP requires the Visual C runtime(CRT). Many applications require that so it may already be installed.
34+
35+
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>
36+
37+
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>
38+
39+
You MUST download the x86 CRT for PHP x86 builds and the x64 CRT for PHP x64 builds.
40+
41+
If CRT is already installed, the installer will tell you that and not change anything.
42+
43+
The CRT installer supports the /quiet and /norestart command-line switches, so you can script running it.
44+
45+
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/
46+
47+
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).
48+
49+
</para>
50+
51+
</sect1>
52+
53+
<sect1>
54+
<title>PECL</title>
55+
56+
<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>
57+
</para>
58+
59+
<para>Some extensions use features specific to some Unix systems and so are not available on Windows. Otherwise, all extensions are available for Windows.
60+
</para>
61+
</sect1>
62+
63+
4964

65+
<!-- Critical: ensure all pages in install/windows and that install/windows/legacy/index are referenced here!
66+
otherwise you will get IDREF attribute errors for all links -->
67+
&install.windows.tools;
68+
&install.windows.recommended;
69+
&install.windows.manual;
70+
&install.windows.troubleshooting;
71+
&install.windows.legacy.index;
72+
</chapter>
5073
<!-- Keep this comment at the end of the file
5174
Local variables:
5275
mode: sgml
@@ -66,4 +89,4 @@ End:
6689
vim600: syn=xml fen fdm=syntax fdl=2 si
6790
vim: et tw=78 syn=sgml
6891
vi: ts=1 sw=1
69-
-->
92+
-->

‎install/windows/legacy/apache1.xml‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<sect1 xml:id="install.windows.apache1" xmlns="http://docbook.org/ns/docbook">
3+
<sect2 xml:id="install.windows.legacy.apache1" xmlns="http://docbook.org/ns/docbook">
44
<title>Apache 1.3.x on Microsoft Windows</title>
55
<para>
66
This section contains notes and hints specific to Apache 1.3.x installs
77
of PHP on Microsoft Windows systems. There are also
8-
<link linkend="install.windows.apache2">instructions and notes
9-
for Apache 2</link> on a separate page.
8+
<!--<link linkend="install.windows.legacy.apache2">instructions and notes
9+
for Apache 2</link> on a separate page.-->
1010
</para>
1111
<note>
1212
<para>
13-
Please read the <link linkend="install.windows.manual">manual
13+
Please read the <link linkend="install.windows.legacy.manual">manual
1414
installation steps</link> first!
1515
</para>
1616
</note>
@@ -46,7 +46,7 @@
4646

4747
&note.apache.slashes;
4848

49-
<sect2 xml:id="install.windows.apache1.module">
49+
<sect3 xml:id="install.windows.legacy.apache1.module">
5050
<title>Installing as an Apache module</title>
5151
<para>
5252
You should add the following lines to your Apache &httpd.conf; file:
@@ -97,14 +97,14 @@ AddType application/x-httpd-php-source .phps
9797
</programlisting>
9898
</example>
9999
</para>
100-
</sect2>
100+
</sect3>
101101

102-
<sect2 xml:id="install.windows.apache1.cgi">
102+
<sect3 xml:id="install.windows.legacy.apache1.cgi">
103103
<title>Installing as a CGI binary</title>
104104

105105
<para>
106106
If you unzipped the PHP package to <filename>C:\php\</filename> as described
107-
in the <link linkend="install.windows.manual">Manual
107+
in the <link linkend="install.windows.legacy.manual">Manual
108108
Installation Steps</link> section, you need to insert
109109
these lines to your Apache configuration file to set
110110
up the CGI binary:
@@ -140,9 +140,9 @@ SetEnv PHPRC C:/php
140140
do this simply create a PHP script file and add this code:
141141
<literal>&lt;?php highlight_file('some_php_script.php'); ?&gt;</literal>.
142142
</simpara>
143-
</sect2>
143+
</sect3>
144144

145-
</sect1>
145+
</sect2>
146146

147147
<!-- Keep this comment at the end of the file
148148
Local variables:

‎install/windows/legacy/apache2.xml‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<sect1 xml:id="install.windows.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<sect2 xml:id="install.windows.legacy.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<title>Apache 2.x on Microsoft Windows</title>
55
<para>
66
This section contains notes and hints specific to Apache 2.x installs
77
of PHP on Microsoft Windows systems. We also
8-
have <link linkend="install.windows.apache1">instructions and notes
9-
for Apache 1.3.x users on a separate page</link>.
8+
<!--have <link linkend="install.windows.legacy.apache1">instructions and notes
9+
for Apache 1.3.x users on a separate page</link>.-->
1010
</para>
1111
<note>
1212
<para>
13-
You should read the <link linkend="install.windows.manual">manual
13+
You should read the <link linkend="install.windows.legacy.manual">manual
1414
installation steps</link> first!
1515
</para>
1616
</note>
@@ -42,7 +42,7 @@
4242
<para>
4343
Download the most recent version of <link xlink:href= "&url.apache;">
4444
Apache 2.x</link> and a fitting PHP version.
45-
Follow the <link linkend="install.windows.manual">Manual Installation
45+
Follow the <link linkend="install.windows.legacy.manual">Manual Installation
4646
Steps</link> and come back to go on with the integration of PHP and Apache.
4747
</para>
4848

@@ -53,7 +53,7 @@
5353

5454
&note.apache.slashes;
5555

56-
<sect2 xml:id="install.windows.apache2.module">
56+
<sect3 xml:id="install.windows.apache2.legacy.module">
5757
<title>Installing as an Apache handler</title>
5858
<para>
5959
You need to insert the following lines into your
@@ -101,9 +101,9 @@ PHPIniDir "C:/php"
101101
]]>
102102
</programlisting>
103103
</example>
104-
</sect2>
104+
</sect3>
105105

106-
<sect2 xml:id="install.windows.apache2.cgi">
106+
<sect3 xml:id="install.windows.apache2.legacy.cgi">
107107
<title>Running PHP as CGI</title>
108108

109109
<para>
@@ -134,9 +134,9 @@ PHPIniDir "C:/php"
134134
</example>
135135
</para>
136136
&warn.install.cgi;
137-
</sect2>
137+
</sect3>
138138

139-
<sect2 xml:id="install.windows.apache2.fastcgi">
139+
<sect3 xml:id="install.windows.apache2.legacy.fastcgi">
140140
<title>Running PHP under FastCGI</title>
141141

142142
<para>
@@ -172,9 +172,9 @@ FcgidWrapper "c:/php/php-cgi.exe" .php
172172
wrapper.
173173
</para>
174174

175-
</sect2>
175+
</sect3>
176176

177-
</sect1>
177+
</sect2>
178178

179179
<!-- Keep this comment at the end of the file
180180
Local variables:

0 commit comments

Comments
 (0)