Phalanger on Windows Vista

This tutorial describes how to run Phalanger on Windows Vista (and IIS7). Currently Phalanger can run only in classic mode, but we’re planning to support IIS 7 directly when “Longhorn” Server will be closer to the release date.

First, you’ll need the latest Phalanger release:

• Phalanger Releases page at CodePlex

Installation on Windows Vista works, except configuration of samples on IIS. If you checked installation of IIS virtual directories you’ll need to do the following manual update - open IIS configuration and right click on the created virtual directory (you’ll need to do this for all three directories - Extensions, SimpleScripts and Tests). In the menu select “Advanced settings”. The dialog appears:

In this dialog, you need to change “Application Pool” to “Classic .NET AppPool”. And samples should be working!

To configure Phalanger, first open the Internet Information Services (IIS) Manager. If you already see the directory with your PHP application in the tree (you probably extracted the files to C:\inetpub\wwwroot), right click on the directory and select “Convert to Application”. If you want to select the directory with the application, right click on the “Default Web Site” and select “Add Application”.

This tutorial describes how to configure Phalanger when you want to create application running on http://localhost/some_app, if you want something like http://localhost:8080 than you’ll need to select “Add Web Site”. The rest of the configuration will be similar.

When adding the web application, you need to enter alias, directory with PHP source files and application pool. It is very important to select the Classic .NET AppPool in this dialog:

After creating the application, we need to configure ASP.NET to handle requests for *.php files. To do this select the “Handler mappings” option in IIS:

And click “Add Script map” link in the Actions bar. In the dialog that appears, enter the “*.php” as a request path and select aspnet_isapi.dll executable, which is typically located in C:\Windows\Microsoft.NET\Framework\v2.0.50727\ directory:

Finally, we’ll add index.php to the list of default documents, so that IIS redirects requests to start page of PHP application. This can be done in the “Default document” configuration:

And that’s all ! You may need to add web.config file with some additional configuration, depending on the application you’re installing. You can find more information in the applications running on Phalanger section.