Tutorial: How to install PHP on IIS

Recently I’ve been assigned to work with servers for a new project that started last month. My supervisor told me to document all the stuff I did so that in the event they need to train a new server administrator in the future, he/she can refer to my documentations and we can get things done quicker. I decided it would be easier for everyone if I made the documentations available on my Wordpress blog, instead of some Word file saved somewhere on the company’s network. At least this way, nothing would get lost.

So here’s how to set up PHP on IIS. At the time of writing, the server is running Windows Server 2008 R2 Enterprise which came pre-installed with IIS 7.5.

  1. Make sure you have the Internet Information Service (IIS) installed and configured properly. This means you have to be able to see the IIS Welcome page when you access the server via web browser.
  2. Make sure you have CGI installed and configured properly. I would just have all the stuff under Application Development install
  3. Download the PHP installer from http://windows.php.net/download/. At the time of writing, the latest PHP version available is 5.3.3, so I cannot guarantee this guide will work with newer versions.
  4. Run the installer.
    • Set the install path to something easy to remember/use (eg. c:\php)
    • Select the modules you need (eg. mysql, etc)
    • Selecting Script Executable > Register *.php file to open automatically with PHP means you don’t have to set this manually.
  5. Click Next until you’re done.
  6. Open php.ini and unquote/edit the following. I’d recommend using Notepad++ for this just in case Notepad decides to mess up your file;
    • fastcgi.impersonate=1
    • cgi.fix_pathinfo=1
    • open_basedir = C:\inetpubwwwroot (This depends on where your www root is). This is optional. It will restrict all PHP functions to the root folder and below, so you will not be able to access say, C:\some-storage-folder, if this line is enabled. So, if you’re working with remote storage locations, you might want to disable this line.
  7. If you didn’t select “Script Executable > Register *.php file to open automatically with PHP” during the installation, here’s what you have to do to get IIS to automatically process PHP scripts. Note that if you skip this step, your PHP scripts will not work.;
    • Open the IIS Manager.
    • Open Handler Mapping.
    • Click on Add New Module Map.
    • Insert the following;
      • Request Path: *.php
      • Module: FastCgiModule
      • Executable: C:\phpphp-cgi.exe (This depends on where you install PHP)
      • Name: PHP via FastCGI (or anything you want)
  8. Restart IIS.
  9. Test PHP by putting a PHP file in the wwwroot folder and accessing it via a browser. I just created a file called phpinfo.php and wrote the following lines into the file.
   echo phpinfo();

That’s it. That’s all you have to do to get PHP working on IIS. As much as I am used to working with LAMP servers, I think Windows Server may not be so bad after all. Have fun.

Til next time, wassalam.


I created this tutorial mainly for my personal use. I am not responsible if something happens to your machines. If your machine/network/toaster/etc breaks down because you followed this guide, it is entirely your fault. If you point your finger at me, I will laugh at you.

© 2017. All rights reserved.

Powered by Hydejack v7.5.0