Moodle is usually easy to install once you’ve got Apache/PHP 5/MySQL running.

But the installation script for Moodle 1.8 fails- hitting ‘Next’ after entering the database information gave me a blank screen.

The install works fine under XP. But the problem isn’t limited to Vista: John McGrath and others on moodle.org report a similar problem under XAMPP/Win2000. John manually built his configuration file to get Moodle running (http://moodle.org/mod/forum/discuss.php?d=64692).

I was able to install Moodle 1.8 successfully under Vista following his approach.

1. Install the Apache webserver. I’m using Apache 2.2.4.
2. Install MySQL 5 (The most recent installer (5.0.41) works without a hitch under Vista. Don’t forget to unblock port 3306 in your firewall, and set sql-mode=”” in your my.ini file; Moodle doesn’t like strict mode).
3. Install PHP 5. I’m using version 5.2.3.
4. Download the latest stable build of 1.8+ from http://download.moodle.org/download.php/stable18/moodle-latest-18.zip.
5. Unzip the file into your Apache document root (c:\apache\htdocs, if you follow the instructions linked in step one). I renamed the directory c:\apache\htdocs\moodle18, so I could install multiple versions of moodle later for testing.
6. Create a directory for storing data that is outside the document root (I used c:\apache\htdata).
7. Create an empty database for Moodle 1.8. I used

I initially tried the msi installer for PHP 5. Unfortunately, it installs only PHP under CGI, which although it has some performance and security issues, might be ok for a quick and dirty development environment.

But the installer is badly broken. You’ll get an error something like

PHP Fatal error:  require_once()[function.require]: Failed opening
required 'SAM/php_sam.php' (include_path='.;C:php5pear') in
sam_factory on line 1

After fighting this for a couple of hours, I ended up installing manually anyway. I used this procedure to get PHP 5 running under Vista:

1. Install the Apache webserver.
2. Get the current version of PHP 5 from http://www.php.net/downloads.php#v5. (It’s 5.2.3 at this time). Get both the zip file and the PECL zip file (which includes extensions).
3. Uninstall any previous installations of PHP 5 (Start > Control Panel > Programs and Features). You may have to reboot your machine.
4. Disconnect from the Internet. Turn off your firewall. Turn off your virus checker.
5. Turn off User Account Control (UAC).
6. Get an administrator prompt by going to All Programs > Accessories. Right-Click “Command Prompt” and choose “Run as Administrator”
7. Use the command prompt to manually remove directories containing previous PHP installations (like C:\Program Files\PHP…)
8. Go to the directory where you’ve downloaded

Installing Apache under Windows XP was trivial. Not so, under Vista. Creation of the Apache service fails. The conf directory can’t be set up by the installer, probably due to permission problems.

I finally got it working with the following procedure. I used the latest version of Apache (2.2.4) and Windows Vista Home Premium.

1. Uninstall any previous installations of Apache Web server (Start > Control Panel > Programs and Features).
2. Turn off your firewall (Control Panel).
3. Stop User Account Control (UAC).
4. Get the most recent version of apache from http://httpd.apache.org/download.cgi and put it on your desktop. Rename it to apache.msi
5. Start > All Programs > Accessories
6. Right-Click “Command Prompt” and choose “Run as Administrator”
7. Manually remove directories containing previous apache installations (like C:\Program Files\Apache Software Foundation…)
8. Change to your desktop folder (At prompt type cd desktop)
9. Type “msiexec /i apache.msi” on the command prompt.
10. Run through the Apache installer. I’m running a development server, so I left the domain and computer name blank. Choose the default server on port 80 for all users option. Change the installation directory to c:\apache.
11. Reboot.
12. The little Apache feather won’t appear on the task bar under Vista with the present version of Apache (2.2.4). To remove