From 1aed4887625b4c341442b8e38bc90cfcbbe81895 Mon Sep 17 00:00:00 2001 From: Sean Harvey Date: Tue, 11 Sep 2012 14:35:31 +1200 Subject: [PATCH] Simplify IIS installation instructions, refer to stable download The documentation was quite verbose, and most of this can be replaced with instructions on using PHP Manager for IIS which sets up most of the PHP configuration for us, with small tweaks done afterwards. In addition, there were references to SVN version control locations which are long since used, we now refer to stable download locations on silverstripe.org instead, for SilverStripe as well as the mssql module. --- docs/en/installation/windows-manual-iis-7.md | 240 +++++-------------- 1 file changed, 66 insertions(+), 174 deletions(-) diff --git a/docs/en/installation/windows-manual-iis-7.md b/docs/en/installation/windows-manual-iis-7.md index 59662f157..b59cd1bf4 100644 --- a/docs/en/installation/windows-manual-iis-7.md +++ b/docs/en/installation/windows-manual-iis-7.md @@ -27,11 +27,13 @@ We'll also install SQL Server 2008 R2, and support for connecting to it in PHP. * Internet Information Services (IIS) 7.x * SQL Server 2008 R2 - * PHP 5.3 - * SilverStripe 2.4 + * PHP 5.4 (PHP 5.3.2+ also works, but we'll install with the latest PHP stable) + * SilverStripe 3 * [Microsoft URL Rewrite Module 2.0](http://www.iis.net/download/URLRewrite) * [IIS 7 Administration Pack](http://www.iis.net/download/AdministrationPack) (ONLY required for Windows Vista or Server 2008) - * [Microsoft Drivers for PHP for SQL Server 2.0](http://www.microsoft.com/downloads/en/details.aspx?FamilyID=80E44913-24B4-4113-8807-CAAE6CF2CA05&displaylang=en) + * [PHP Manager](http://phpmanager.codeplex.com/releases/view/69115) + * [Microsoft Drivers for PHP for SQL Server 3.0](http://www.microsoft.com/downloads/en/details.aspx?FamilyID=80E44913-24B4-4113-8807-CAAE6CF2CA05&displaylang=en) + * [Microsoft SQL Server Native Client](http://www.microsoft.com/en-nz/download/details.aspx?id=29065) (ONLY if connecting to SQL Server from PHP) ## Install IIS @@ -44,8 +46,8 @@ IIS 7.x comes with Windows. However, it needs to be installed. Follow these step * Check **Web Server (IIS)** (if a popup appears, confirm you want to proceed with the change) * Click Next > * Check CGI in the list - you'll find find it under Application Development - * Scroll down and check IIS Management Scripts and Tools - * OPTIONAL: For remote management capability, check Management Service + * Scroll down and check **IIS Management Scripts and Tools** + * OPTIONAL: For remote management capability, check **Management Service** **NOTE**: These instructions are slightly different for Windows Vista and Windows 7. Instead of a Server Manager popup, you'll just get a list of features to enable. Do the same as above except click the **Internet Information Services** checkbox when the Windows Features popup appears and then expand this node and select **CGI** under World Wide Web Services > Application Development Features. @@ -54,7 +56,7 @@ Once the installation is finished, browse to http://localhost in your browser. I ## IIS URL Rewrite Module * Go to http://www.iis.net/extensions/URLRewrite - * Click x86 or x64 on the right, depending on whether you installed a x86 or x64 version of Windows + * Choose x86 or x64, depending on whether you installed a x86 or x64 version of Windows * Run the downloaded file to install and enable the URL Rewrite Module ## IIS Administration Pack @@ -64,6 +66,15 @@ Once the installation is finished, browse to http://localhost in your browser. I * [Download IIS Administration Pack](http://www.iis.net/extensions/AdministrationPack) * Run the downloaded file to enable the IIS Administration Pack (make sure it's x86 or x64 depending on your Windows version) +## SQL Server Native Client + +This is only required if you're connecting to a SQL Server database. + + * Go to http://www.microsoft.com/en-nz/download/details.aspx?id=29065 + * Scroll down to "Native Client" + * Choose x86 or x64 depending on whether you installed a x86 or x64 version of Windows + * Run the downloaded file to install and enable the SQL Server Native Client + ## Install SQL Server 2008 R2 SQL Server doesn't come with Windows. It must be separately installed. @@ -80,119 +91,57 @@ Ensure these features are installed with your copy of SQL Server. Installing SQL Server should be relatively straightforward. Keep a note of the password you create for the "sa" user. We'll need this for later when we connect to the database server via PHP to test connectivity. -## Install PHP +### Install PHP -From http://windows.php.net/download, pick **VC9 x86 Non Thread Safe** of the latest PHP version and click "Installer" to download the PHP installer. + * Install PHP Manager from http://phpmanager.codeplex.com/releases/view/69115 (choose x86 or x64 depending on your Windows architecture) + * Download the latest stable PHP 5.4 (VC9, x86) zip from http://windows.php.net/download + * Extract zip contents to **C:\php** + * Open PHP Manager in IIS and register **C:\php\php-cgi.exe** to enable PHP for IIS -**NOTE**: We chose the "Non Thread Safe" version because we'll run PHP as a FastCGI process through IIS. FastCGI ensures a single threaded execution environment so thread safety checks are not required. This provides significant performance gains over using the thread safe version of PHP. +### Install SQL Server drivers for PHP -Once finished downloading, run the installer to get PHP up and running. +This is the PHP extension allowing it to connect to SQL Server databases. -When prompted, select **IIS FastCGI** for the web server setup. When asked for which items to install, expand the Extensions tree and check **LDAP** and **Multi-Byte String**. You'll probably need one or both of these in the future, so it's a safe option to install them. LDAP is required for retrieving data from an Active Directory server, for example. + * Download 3.0 executable from http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=20098 + * Extract contents to a temporary location, such as C:\sqlsrv + * Copy **php_sqlsrv_54_nts_vc9.dll** to C:\php\ext + * Rename the file to **php_sqlsrv.dll** + * Open PHP Manager and go to **Enable or disable an extension** + * Right click **php_sqlsrv.dll** and hit **Enable** -Now we need to set up Handler Mappings in IIS to support PHP scripts. +### Install wincache extension for PHP -Open up Internet Information Services (IIS) Manager and click on the second node that appears on the tree to the left. +This is an op-code cacher which speeds up PHP execution on Windows. - * Click Handler Mappings + * Download the latest wincache (for PHP 5.4, x86) from http://www.iis.net/download/wincacheforphp + * Extract zip contents to a temporary location, such as C:\wincache + * Copy php_wincache.dll to C:\php\ext + * Open PHP Manager and go to **Eanble or disable an extension** + * Right click **php_wincache.dll** and hit **Enable* -**NOTE**: If you already see an entry for PHP, continue to "Configure FastCGI in IIS" below. +### Configuring PHP - * Click Add Module Mapping located on the right hand Actions bar - * Enter ***.php** into the Request path field - * Select FastCGIModule from the Module dropdown menu - * Enter **"C:\Program Files (x86)\PHP\php-cgi.exe"** (including the quotes) into the Executable (optional) field - * Enter **PHP** into the Name field + * First of all, restart IIS to apply all changes + * Go to **Check phpinfo()** PHP Manager + * Ensure that **wincache** and **sqlsrv** details can be found in the information + * Go to **Enable or disable an extension** and disable everything, except for these: -You can also do the same via the command line. Run these commands if you prefer to do it the CLI way: + php_curl.dll + php_gd2.dll + php_mbstring.dll + php_sqlsrv.dll + php_wincache.dll + php_tidy.dll - C:\windows\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI /+[fullPath='"c:\Program Files (x86)\PHP\php-cgi.exe"'] - C:\windows\system32\inetsrv\appcmd set config /section:system.webServer/handlers /+[name='PHP_via_FastCGI',path='*.php',verb='*',modules='FastCgiModule',scriptProcessor='"c:\Program Files (x86)\PHP\php-cgi.exe"',resourceType='Unspecified'] + * Go to **Configure error reporting** and check **Development machine** + * Go to **Manage all settings** and set the following: -## Configure FastCGI in IIS + date.timezone = "Pacific/Auckland" (or choose from the list here: http://nz.php.net/manual/en/timezones.php) + post_max_size = 64M + memory_limit = 256M + upload_max_filesize = 64M -There's some best practice configuration we need to apply to FastCGI so that our websites will run optimally. - - * Click FastCGI Settings in the IIS Manager - * Click the PHP entry that appears in the list, and click Edit in the right hand Actions panel - * Look for InstanceMaxRequests and change the value to **10000** - * Look for ActivityTimeout and change the value to **900** - * Look for RequestTimeout and change the value to **900** - * Click the (Collection) field and press the ... button that appears to the right - * Click Add when the dialog box appears - * On the right, enter **PHP_FCGI_MAX_REQUESTS** for the entry to the Name field - * On the right, enter **10000** for the entry to the Value field - -Again, like adding the handler mappings, the same procedures can be done using the command line: - - C:\windows\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /[fullPath='"c:\Program Files (x86)\PHP\php-cgi.exe"'].instanceMaxRequests:10000 - C:\windows\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /[fullPath='"c:\Program Files (x86)\PHP\php-cgi.exe"'].ActivityTimeout:900 - C:\windows\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /[fullPath='"c:\Program Files (x86)\PHP\php-cgi.exe"'].RequestTimeout:900 - C:\windows\system32\inetsrv\appcmd set config -section:system.webServer/fastCgi /+"[fullPath='"c:\Program Files (x86)\PHP\php-cgi.exe'].environmentVariables.[name='PHP_FCGI_MAX_REQUESTS',value='10000']" - -The [official guide configuring IIS for PHP applications is available](http://learn.iis.net/page.aspx/771/configure-and-optimize-the-microsoft-web-platform-for-php-applications/) for reference. - -## Add index.php as default document - -This is good practise, so if you browse to http://localhost/silverstripe then it will automatically run index.php. IIS needs to be told which default documents should be checked for when accessing a directory in the URL. - -To add index.php as a default document: - - * Open Internet Information Services (IIS) Manager - * Click your server name on the left when the program opens - * Double click the **Default Document** icon - * Verify that index.php doesn't already exist in the file list - * Click **Add** on the right sidebar to add a new entry - * Enter **index.php** when the dialog box pops up and hit **OK** - -## Install the SQL Server Driver for PHP - -The following steps will install the SQL Server Driver for PHP from Microsoft: - - * Download [Microsoft Drivers for PHP for SQL Server (2.0)](http://www.microsoft.com/downloads/en/details.aspx?FamilyID=80E44913-24B4-4113-8807-CAAE6CF2CA05&displaylang=en) - * Run the downloaded file, extracting to C:\sqlsrv - * In Windows Explorer, browse to C:\sqlsrv - you should see a bunch of DLL files - * Copy **php_sqlsrv_53_nts_vc9.dll** to C:\Program Files (x86)\PHP\ext - * Open C:\Program Files (x86)\PHP\php.ini using Notepad - -At the bottom of the file, add this line: **extension=php_sqlsrv_53_nts_vc9.dll** - -## Configure PHP - -PHP is installed and works with IIS, but the configuration needs a bit of minor tweaking. - -Open Windows Explorer. Browse to C:\Program Files (x86)\PHP and open php.ini. - -Note: You may need to run Notepad as administrator (right click Notepad.exe and click "Run as administrator"). From inside Notepad, open C:\Program Files (x86)\PHP\php.ini. - -First of all, look for **;date.timezone** and replace it with this one (replacing Pacific/Auckland to your timezone if you're not in New Zealand). - - date.timezone = Pacific/Auckland - -Secondly, look for **display_errors** and **display_startup_errors**. Replace the Off value for each of these with **On**. - -Thirdly, PHP has a very low maximum file size of 2 megabytes for file uploads. Look for **post_max_size**, and **upload_max_filesize**. Change 2M and 8M respectively, to **128M**. This is important to allow large uploads from users, such as video. If you feel you don't require as much, change it to **64M** for both, which is a sensible limit. - -Again, look for **max_input_time**. Replace the 60 value with **900**. The reason we're doing this is to match the 900 value we set earlier in IIS. - -Lastly, there's one FastCGI setting we need to apply, and it's missing in the configuration by default. Look for **fastcgi.impersonate=1** and add this line below it: - - cgi.fix_pathinfo=1 - -SilverStripe sites will email errors to developers which are crucial for debugging. It's also needed for any emails generated by the website. PHP needs to know where your SMTP server is located, and which port it listens on to be able to send emails. - -In php.ini, look for this block of code: - - [mail function] - ; For Win32 only. - ; http://php.net/smtp - SMTP = localhost - ; http://php.net/smtp-port - smtp_port = 25 - -Make sure that the SMTP and smtp_port are set to your mail server's hostname and port respectively. - -That should do it for the PHP configuration. +Tweak the above values as necessary if your requirements differ. ## Folder permissions for PHP @@ -205,32 +154,13 @@ You will need to give the IIS permission to write to these folders. This can be Other important folders to give these permissions to are `assets` and `silverstripe-cache` (if used) in your web root. -## Test PHP installation - -Now that we've got PHP configured how we want it, let's test that PHP is working correctly. - -First things first, restart IIS using IIS Manager. - -Create a new file using Notepad called test.php if you haven't already, inside **C:\inetpub\wwwroot** - -Inside the file, add this content: - - tag, and make sure that everything is tabbed out correctly. +**A:** One of the reasons why this could be happening is the web.config file inside the ss directory has XML that is not well formed. Make sure there are NO spaces before the starting tag, and make sure that everything is tabbed out correctly. One other thing you can do is make sure Show friendly HTTP error messages is unchecked in Internet Explorer. You can find this in Tools > Internet Options > Advanced. @@ -397,7 +289,7 @@ If this still doesn't help, enable Failed Request Tracing in IIS. You could also **A:** A non-thread safe of PHP is recommended for use with IIS. Thread safety checks are not required, and you'll get a performance boost by not using a thread safe version. If possible, use a version compiled in VC9 instead of VC6. VC9 versions require you to have the [Microsoft 2008 C++ Runtime (x86)](http://www.microsoft.com/downloads/details.aspx?FamilyID=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF) or the [Microsoft 2008 C++ Runtime (x64)](http://www.microsoft.com/downloads/details.aspx?familyid=bd2a6171-e2d6-4230-b809-9a8d7548c1b6&displaylang=en) installed You should also ensure you are using the latest version of the [Microsoft Drivers for PHP for SQL Server](http://www.microsoft.com/downloads/en/details.aspx?FamilyID=80E44913-24B4-4113-8807-CAAE6CF2CA05&displaylang=en) driver. -If possible, you should also use PHP 5.3 which provides performance improvements over 5.2. +If possible, you should also use PHP 5.4 which provides performance improvements over 5.2 and 5.3. Try increasing the IIS **MaxInstances** in IIS Manager > FastCGI from 4 to a higher value. For quad core CPUs, a higher value such as **32** should prove to provide a performance enhancement.