[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/legacy/commandline.xml_wi
From: Matt_Ficken <mattficken () php ! net>
Date: 2016-05-24 2:38:39
Message-ID: svn-mattficken-1464057519-339219-747000674 () svn ! php ! net
[Download RAW message or body]
mattficken Tue, 24 May 2016 02:38:39 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=339219
Log:
revamping the Windows install instructions for modern PHP and modern Windows versions.
Changed paths:
U phpdoc/en/trunk/install/cloud/azure.xml
U phpdoc/en/trunk/install/windows/legacy/commandline.xml
A phpdoc/en/trunk/install/windows/manual.xml
A phpdoc/en/trunk/install/windows/recommended.xml
A phpdoc/en/trunk/install/windows/tools.xml
A phpdoc/en/trunk/install/windows/troubleshooting.xml
["svn-diffs-339219.txt" (text/x-diff)]
Modified: phpdoc/en/trunk/install/cloud/azure.xml
===================================================================
--- phpdoc/en/trunk/install/cloud/azure.xml 2016-05-22 20:08:23 UTC (rev 339218)
+++ phpdoc/en/trunk/install/cloud/azure.xml 2016-05-24 02:38:39 UTC (rev 339219)
@@ -1,13 +1,43 @@
<?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>Microsoft Azure</title>
+ <title>Azure App Services</title>
<para>
- PHP installs on the <link xlink:href="&url.cloud.azure;">Azure cloud \
platform</link>. + PHP is frequently used on Azure App Services (aka Microsoft \
Azure, Windows Azure, Azure Web Apps). </para>
<para>
- See also the <link xlink:href="&url.cloud.azure.sdk;">Azure SDK for PHP</link>.
+ 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. </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/legacy/commandline.xml
===================================================================
--- phpdoc/en/trunk/install/windows/legacy/commandline.xml 2016-05-22 20:08:23 UTC \
(rev 339218)
+++ phpdoc/en/trunk/install/windows/legacy/commandline.xml 2016-05-24 02:38:39 UTC \
(rev 339219) @@ -6,6 +6,11 @@
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
Added: phpdoc/en/trunk/install/windows/manual.xml
===================================================================
--- phpdoc/en/trunk/install/windows/manual.xml (rev 0)
+++ phpdoc/en/trunk/install/windows/manual.xml 2016-05-24 02:38:39 UTC (rev 339219)
@@ -0,0 +1,43 @@
+<?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>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>
Property changes on: phpdoc/en/trunk/install/windows/manual.xml
___________________________________________________________________
Added: svn:eol-style
+ native
Added: svn:keywords
+ Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy \
HeadURL URL
Added: phpdoc/en/trunk/install/windows/recommended.xml
===================================================================
--- phpdoc/en/trunk/install/windows/recommended.xml (rev 0)
+++ phpdoc/en/trunk/install/windows/recommended.xml 2016-05-24 02:38:39 UTC (rev \
339219) @@ -0,0 +1,58 @@
+<?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>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>
Property changes on: phpdoc/en/trunk/install/windows/recommended.xml
___________________________________________________________________
Added: svn:keywords
+ Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy \
HeadURL URL
Added: svn:eol-style
+ native
Added: phpdoc/en/trunk/install/windows/tools.xml
===================================================================
--- phpdoc/en/trunk/install/windows/tools.xml (rev 0)
+++ phpdoc/en/trunk/install/windows/tools.xml 2016-05-24 02:38:39 UTC (rev 339219)
@@ -0,0 +1,14 @@
+<?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>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>
Property changes on: phpdoc/en/trunk/install/windows/tools.xml
___________________________________________________________________
Added: svn:keywords
+ Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy \
HeadURL URL
Added: svn:eol-style
+ native
Added: phpdoc/en/trunk/install/windows/troubleshooting.xml
===================================================================
--- phpdoc/en/trunk/install/windows/troubleshooting.xml (rev \
0)
+++ phpdoc/en/trunk/install/windows/troubleshooting.xml 2016-05-24 02:38:39 UTC (rev \
339219) @@ -0,0 +1,11 @@
+<?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>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>
Property changes on: phpdoc/en/trunk/install/windows/troubleshooting.xml
___________________________________________________________________
Added: svn:eol-style
+ native
Added: svn:keywords
+ Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy \
HeadURL URL
--
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