Author: Date: 12/27/10
NOTE: This document is out of date and no longer maintained. Please upgrade ; your version of the WebPI and view the new WebPI 3.0 installation guide
Windows Azure offers a "local cloud development platform", which lets you test and debug on your local Windows machine before you actually deploy to the cloud. Alternatively you can choose to manually install and configure all the required elements (see the article, " Getting the Windows Azure Pre-Requisites Via Manual Installation"). It's easier to use the Web Platform installer, but installing and configuring manually gives you a better understanding of all the pieces that are working together.
This tutorial gets you setup with a development environment to do PHP programming on Microsoft Windows. I'm going to focus on the minimal set of tools you will need to get quickly running with PHP on Microsoft's cloud computing platform, Windows Azure. I am going to describe getting a simple PHP info page up and running for test purposes with Windows Azure.
1. I am going to use the Microsoft Web Platform Installer 2.0 (I'll refer to it as WebPI from now on) to rapidly get the appropriate tools and software dependencies. This lightweight but powerful tool will help us get all the tools we need to have a development ready box. Click the button "Download It Now" at http://www.microsoft.com/web/downloads/platform.aspx to start the process:
2. This will run the launcher and pop up any download or security warnings in order for it to run the initial installer. ; You may see windows similar to the ones below. ; I am using Internet Explorer and see these:
3. Once you go through the popups you should see the splash screen for WebPI and it should begin on the "Web Platform" tab with some a list of latest frameworks, tools, and web application at your disposal. You may launch the tool at any time to install these and I recommend checking out some of the items when you get comfortable with the tool.
4. Click on the "Web Platform" tab on the left, under the "Frameworks and Runtimes" heading, click on "Customize".
5. Select "PHP 5.2.14". ; ; The "PHP Manager for IIS"
product may also be selected. Leave it selected.
6. Next we'll want to install the Azure SDK, but before we do so, we will need to add another additional selection. You'll find this in the "Web Platform" tab. Click on "Customize" under the "Web Server" subheading.
7. Select "ASP.NET" under "Application Development".
8. Click on the "Web Platform" tab or the "Back to Web Platform" hyperlink.
9. Now we will install the Windows Azure SDK, but it is hidden from the normal view. Click on the "Option" hyperlink in the lower-left corner of the window. ; In the "Change Options" window, select the "Developer Tools" check box and click "OK".
10. Now, back on first splash screen on the "What's New" tab, you'll notice a new tab for "Developer Tools" based on the selection we made in the "Change Options" window:
11. Click on the "Developer Tools" tab, and then click on the "Click to include the recommended products" link under "Windows Azure Platform Tools" subheading, it will say "Click to remove the included products" when selected with two check marks on "Windows Azure Platform Tools" and "Visual Studio Tools". Leave them as they are and click "Install":
12. The "Web Platform Installation" window will now come up listing the applications, products and components that will be required by the "Windows Azure Command-line Tools for PHP". ; Some of the dependencies that will be installed include PHP (5.2.14), the Windows Azure SDK and some settings to setup and configure Internet Information Server (IIS7) so that Windows Azure and PHP work well together. ; The screen below shows some of the dependencies as well as where the tools you selected will be downloaded and installed from. ; Click on "I Accept" to confirm and continue.
13. You will then come to a screen which will prompt you for an authentication mode for SQL Server Express to be used by the Windows Azure SDK Development Store. Make sure the dialog box called "Mixed Mode Authentication" is selected, enter a strong password (something with characters, symbols and numbers. Try and not forget it!) in the text fields and then click the "Continue" button.
14. The "Web Platform" Installation process will start and will it will start downloading the components and run the Installers for the components, applications and tools. ; Sometimes the download and installation process can be sensitive to heavy Web traffic or internet usage. ; Should the install fail to start, simply close the program and begin again, starting at Step 1.
15. When the "Microsoft Web Platform Installer" pops up, stating that the Microsoft .NET Framework 4.0 has installed successfully, a pop-up such as the one below will appear. ; Click "Yes" and your machine will RESTART/REBOOT and continue the installation workflow.
16. When the machine reboots and you have logged in to your desktop, you will be presented with a "User Account Control" popup. ; Click "Yes" to continue.
17. The install will progress; you do not have to do anything.
18. The "Windows Azure SDK" wizard will disappear and you should have the "Web Platform Installation" window appear with a message "Congratulations! You have successfully installed the following products", and a list of all the components you have installed. ; There may be errors or warnings if anything did not complete, and you can click on the links to remedy any steps you might have missed or need to redo. ; Once you are satisfied, click on "Finish".
19. You will return to the "Web Platform Installer 2.0" window. ; You can click on "Exit" to finish.
20. Alternatively you may want to Click the "Start Button" , then click "All Programs" and you should see "Windows Azure SDK v1.3" and "PHP 5" folders and the "Microsoft Web Platform Installer" icon (click this if you want to launch WebPI in the future, instead of navigating to the website). ; Navigate to the "Windows Azure SDK v1.3" folder and Click on the "Windows Azure SDK Command Prompt".
21. You should see the window entitled "Windows Azure SDK Environment".
22. To test if the Windows Azure SDK has installed we will type
in the following:
csrun ; /devfabric:start
23. "User Account Control" popups will appear, click "Yes" on them.
NOTE: check the taskbar for others, make sure you have said "Yes" on all.
24. On the taskbar, ; on the bottom right, click the double-arrows/chevron/triangle in the notification area to reveal a Windows Azure Icon (blue Windows logo). ; Right-clicking on the icon will show some menu items.
25. Next click "Start Storage Emulator" to test the development storage server. ; You will receive a window "Development Storage Initialization" which will create some ports on your local web server for the fabric to test with, a database entry with permissions for your account and a message stating that the development storage service is ready. ; Click "OK" to close the window.
26. Now let's test PHP. ; In the command-prompt you have open enter "php -v". ; ; (You may use alternative flags to check your configuration.)
You are now set up to install the Windows Azure SDK for PHP, the Windows Azure Command-Line Tool for PHP or any of the other tools available from this site!
NOTE: If you find that you receive an error such as the one below, please see the article, " Troubleshooting an MSVCR71.dll Error"
- Understanding the Windows Azure Platform
- Get Started with the Windows Azure Companion
- Get Started with the Windows Azure SDK for PHP
- Get Started with the Windows Azure Command-Line Tool for PHP