[prev in list] [next in list] [prev in thread] [next in thread]
List: php-doc-cvs
Subject: [DOC-CVS] =?utf-8?q?svn:_/phpdoc/en/trunk/install/_cloud/azure.xml_windows/index.xml_windows/legacy/
From: Christoph_Michael_Becker <cmb () php ! net>
Date: 2016-05-24 11:47:37
Message-ID: svn-cmb-1464090457-339222-1465083743 () svn ! php ! net
[Download RAW message or body]
cmb Tue, 24 May 2016 11:47:37 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=339222
Log:
Reverse merged revision(s) 339219-339218 from phpdoc/en/trunk:
revamping the Windows install instructions for modern PHP and modern Windows versions.
.......
These commits break the doc build.
Changed paths:
U phpdoc/en/trunk/install/cloud/azure.xml
U phpdoc/en/trunk/install/windows/index.xml
U phpdoc/en/trunk/install/windows/legacy/commandline.xml
D phpdoc/en/trunk/install/windows/manual.xml
D phpdoc/en/trunk/install/windows/recommended.xml
D phpdoc/en/trunk/install/windows/tools.xml
D phpdoc/en/trunk/install/windows/troubleshooting.xml
["svn-diffs-339222.txt" (text/x-diff)]
Modified: phpdoc/en/trunk/install/cloud/azure.xml
===================================================================
--- phpdoc/en/trunk/install/cloud/azure.xml 2016-05-24 06:56:44 UTC (rev 339221)
+++ phpdoc/en/trunk/install/cloud/azure.xml 2016-05-24 11:47:37 UTC (rev 339222)
@@ -1,43 +1,13 @@
<?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>Azure App Services</title>
+ <title>Microsoft Azure</title>
<para>
- PHP is frequently used on Azure App Services (aka Microsoft Azure, Windows Azure, \
Azure Web Apps). + PHP installs on the <link xlink:href="&url.cloud.azure;">Azure \
cloud platform</link>. </para>
<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. + See also the <link \
xlink:href="&url.cloud.azure.sdk;">Azure SDK for PHP</link>. </para>
-
- <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 \
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>
-
- <h2>WinCache</h2>
- <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>
-
- <h2>Custom PHP Build</h2>
- <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>
-
</sect1>
<!-- Keep this comment at the end of the file
Modified: phpdoc/en/trunk/install/windows/index.xml
===================================================================
--- phpdoc/en/trunk/install/windows/index.xml 2016-05-24 06:56:44 UTC (rev 339221)
+++ phpdoc/en/trunk/install/windows/index.xml 2016-05-24 11:47:37 UTC (rev 339222)
@@ -1,76 +1,51 @@
<?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.iis">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 \
href="https://wiki.php.net/internals/windows/stepbystepbuild">Step by Step Build \
Instructions</link>.
- </para>
-
- <link linkend="install.windows.commandline">Using PHP on Windows Command \
line</link>
-
- <link linkend="install.windows.tools">Install Tools</link>
-
- <link linkend="install.windows.manual">Manual Installation</link>
-
- <link linkend="install.cloud.azure">Installing PHP on Azure App Services</link> \
(aka Microsoft Azure, Windows Azure, or (Windows) Web Apps).
-
-
- <h2>Install Requirements</h2>
-
- <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: \
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(`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>
-
- <link linkend="install.windows.recommended">Recommended Configuration</link>
-
-
-
-
-
- <h2>PECL</h2>
-
- <para>PECL extensions are pre-built for Windows and available from: <link \
href="http://windows.php.net/downloads/pecl/releases/">http://windows.php.net/downloads/pecl/releases/</link>
-
+<!-- $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>
-
- <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>
-
-
- <link linkend="install.windows.troubleshooting">Troubleshooting Common \
Problems</link>
-
-
+ <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>
-
-
-</chapter>
+ &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>
<!-- Keep this comment at the end of the file
Local variables:
Modified: phpdoc/en/trunk/install/windows/legacy/commandline.xml
===================================================================
--- phpdoc/en/trunk/install/windows/legacy/commandline.xml 2016-05-24 06:56:44 UTC \
(rev 339221)
+++ phpdoc/en/trunk/install/windows/legacy/commandline.xml 2016-05-24 11:47:37 UTC \
(rev 339222) @@ -6,11 +6,6 @@
This section contains notes and hints specific to getting PHP running
from the command line for Windows.
</para>
- <para>
- To get to the command line interface(CLI) on Windows, click/press Start and \
either search for Command Prompt, or click run and type cmd.exe and \
press enter.
-
- The Windows Command prompt lets you run PHP just like you would with Bash on \
Linux/UNIX. Other programs or commands are different than on Bash \
though.
- </para>
<note>
<para>
You should read the <link linkend="install.windows.manual">manual
Deleted: phpdoc/en/trunk/install/windows/manual.xml
===================================================================
--- phpdoc/en/trunk/install/windows/manual.xml 2016-05-24 06:56:44 UTC (rev 339221)
+++ phpdoc/en/trunk/install/windows/manual.xml 2016-05-24 11:47:37 UTC (rev 339222)
@@ -1,43 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-
-<chapter 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>
-
-<h2>Choose Web Server</h2>
- <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: \
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
-
- <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>
-
- <h2>Choose Build</h2>
- <para>
- Download PHP production releases from <link \
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>
-</chapter>
Deleted: phpdoc/en/trunk/install/windows/recommended.xml
===================================================================
--- phpdoc/en/trunk/install/windows/recommended.xml 2016-05-24 06:56:44 UTC (rev \
339221)
+++ phpdoc/en/trunk/install/windows/recommended.xml 2016-05-24 11:47:37 UTC (rev \
339222) @@ -1,58 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-
-<chapter 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>
-
-<h3>OpCache</h3>
-
- <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>
-
- <h3>WinCache</h3>
-
- <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>
-
- <h2>IIS Configuration</h2>
-
- <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>
-
- <h2>Database</h2>
-
- <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 https://dev.mysql.com/downloads/windows/</para>
-
-</chapter>
Deleted: phpdoc/en/trunk/install/windows/tools.xml
===================================================================
--- phpdoc/en/trunk/install/windows/tools.xml 2016-05-24 06:56:44 UTC (rev 339221)
+++ phpdoc/en/trunk/install/windows/tools.xml 2016-05-24 11:47:37 UTC (rev 339222)
@@ -1,14 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-
-<chapter 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>
-
-<h1>PHP Install Tools</h1>
- <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>
-
-</chapter>
Deleted: phpdoc/en/trunk/install/windows/troubleshooting.xml
===================================================================
--- phpdoc/en/trunk/install/windows/troubleshooting.xml 2016-05-24 06:56:44 UTC (rev \
339221)
+++ phpdoc/en/trunk/install/windows/troubleshooting.xml 2016-05-24 11:47:37 UTC (rev \
339222) @@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-
-<chapter 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>
-
-<h3>Check Temp Directory Permissions</h3>
-
- <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>
-</chapter>
--
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic