Installation on Windows systems

Using IIS

These are the installation instructions when you want to run PHP with IIS. If you want to use Apache for windows, goto the part titled 'Using Apache'.

1. Install PHP 4

Download the PHP 4 windows binaries from http://www.php.net/downloads.php or one of its mirrors.

Unzip PHP and install it somewhere (e.g.: C:\PHP\ ). Now download our patched version of the isapi dll from ftp://ftp.muze.nl/ and copy it over the original. (which you can find at C:\PHP\sapi\php4isapi.dll)

This patch fixes a problem with IIS and PHP which prevents PHP from finding the correct script to execute if you add path info in the url. Ariadne will not run without this.

Read the install.txt file for further instructions. Don't forget to install the isapi version of PHP.

2. Configure IIS

Start the 'Internet Services Manager', you can find it from the Start menu -> Programs -> Administrative Tools -> Internet Services Manager.

Now create a new website for Ariadne by rightclicking on the folder with the name of your system and selecting new -> website. Alternatively you can install it in an existing website if you like. Do make sure that the Web Site Access Permissions are set to 'read' and 'execute'.

Tip: If you don't use IIS's 'default' website, we advise you to disable it. This will help to make your system more secure.

Make sure that PHP is enabled in the Ariadne website. You can read instructions for this in the PHP installation instructions (install.txt).

You can now continue the installation with the part title 'Common Installation' further in this document.

Using Apache

These are the installation instructions when you want to run PHP with Apache for windows. If you want to use IIS instead, finish the previous part titled 'Using IIS' first, then continue the installation with the part titled 'Common Installation'.

1. Stop IIS

If you are not already running Internet Information Services (IIS) you can skip this step.

If you want to run Ariadne on the default webserver port (80), you need to stop IIS permanently. Ariadne requires Apache and Apache cannot run on the same port as IIS. To stop the webservice of IIS, go to start->programs->aministrative tools->services and right-click on 'World Wide Web publishing services'. Select 'Properties' and click on the 'Stop' button if it is enabled. Then select 'disabled' in the startup-type selection box.

2. Install Apache

Apache can be downloaded from http://httpd.apache.org/ or one of its mirrors.

The installation wizard will guide you through the initial installation of Apache. Remember the installation path you selected for Apache.

3. Install PHP 4

Download the PHP 4 windows binaries from http://www.php.net/downloads.php or one of its mirrors.

Unzip PHP and install it somewhere (e.g.: C:\PHP\). Read the install.txt file for further instructions. Remember: you need to install PHP as a module in Apache, don't install the CGI version.

5. Configure Apache

Apache itself is not configured yet. Browse to the conf directory under the Apache installation directory and open the httpd.conf file for editting (it is text file). Search for the text 'LoadModule'. Between the list of modules there's probably a line like this:

#LoadModule php4_module modules/apachemodulephp.dll

Change this line to this:

LoadModule php4_module modules/php4apache.dll

Note: the name of the module has also changed.

Then search for the text 'AddType'. Between the list of application type's, you can find the line:

#AddType application/x-httpd-php .php

Change this line to this:

AddType application/x-httpd-php .php

Finally search for this line:

DirectoryIndex index.html index.shtml

And add index.php at the end of the line.

The file httpd.conf contains numerous other configuration settings, for more information on configuring Apache for Windows goto http://www.apache.org/.

Now you need to test whether Apache will run with PHP installed. First youwill need to restart the Apache service. You can do this from the Start menu -> Programs -> Apache -> Restart Apache.

To check if everything is installed correctly, create a file with the name 'info.php' in the Apache document root (e.g.: C:\Program Files\Apache Group\Apache\htdocs\) with the following contents:

<?php
 phpinfo();
?>

Start a web browser and go to http://localhost/info.php. If everything installed ok, you should see a formatted page displaying some information about PHP and Apache.

Now move on to the platform independent post-installation steps.