RPITS install tips for Windows

These steps/tips are based on my install process on 6/14/2013.

Amended 7/4/2014 to fix dead links

Installing XAMPP and ImageMagick

1. Download XAMPP: https://www.apachefriends.org/download.html
2. Install XAMPP. C:/xampp/ is preferred/default
3. XAMPP Control Panel should run automatically. Install services for PHP and Apache. If toggles are disabled, quit XAMPP Control and start it again as an Administrator.
4. Go here: http://www.peewit.fr/imagick/ Download php_imagick.dll for the correct version of PHP under the Thread Safe header. Note the version of ImageMagick listed and make sure the listed version of PHP matches the version distributed with XAMPP.
5. Download the matching version of ImageMagick. At time of writing, this was ImageMagick 6.8.6-8-Q16-x86 (NOT 64bit!!!) - http://ftp.sunet.se/pub/multimedia/graphics/ImageMagick/binaries/ImageMagick-6.8.6-8-Q16-x86-dll.exe (Hit the /binaries/ directory and find the match if the version number has changed.
6. Install ImageMagick. Anywhere should be fine. I have mine in C:/xampp/ImageMagick.
7. Run CMD, type 'convert'. A bunch of text should display. If only one line displays, ImageMagick did not add itself to your path properly.
8. Place php_imagick.dll in {xampp}/php/ext/
9. Add 'extension=php_imagick.dll' to {xampp}/php/php.ini . Anywhere is fine, I put it with the rest of the extension definitions
10. In XAMPP Control Panel, start/restart Apache. Click Logs > php_error_log. If no errors, go to localhost/xampp/phpinfo.php. Ctrl+f "imagick". If found, success. If not, try rebooting Windows and restarting Apache. Then complain to Reilly.

Configuring XAMPP's default php.ini

1. Open {xampp}/php/php.ini
2. RPITS, for better or for worse (for worse), uses short tags. Ctrl-F 'short_open_tag = Off', set to 'On'.
3. In order to see PHP errors rather than broken images, turn off output buffering. Ctrl+F 'output_buffering = 4096', set to 'Off'.
4. Decrease error sensitivity. Ctrl+F 'error_reporting = E_ALL'. Set to 'E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED'. E_NOTICE can be useful for debugging (it points out obvious mistakes). At some point, the codebase should be cleaned up to remove warnings/notices. It's not currently "some point".
5. Restart Apache in XAMPP Control Panel.

MySQL/Database Setup

1. You'll want a database of titles. Eventually, a start-up SQL file will be provided.
2. Until then, I recommend copying the rpits and rpihockey folders out of the {mysql}/data/ directory of either the Graphics server, or from Reilly's install.

Installing RPITS

1. Clone/copy rpits in to {xampp}/htdocs/rpits/
2. Open config.sample.php and edit the MySQL server information
3. Set $system_path_prefix to the path of the root folder on Apache
4. Visit localhost/rpits/ to see if there are any warning messages. RPITS' default templates use a non-free font which is not included, causing titles to not render on a fresh install. Research into a free alternative is ongoing.

Other notes

1. XAMPP Control gets unhappy if it's not Run as an Administrator. Run it as an Administrator.
2. There may be some magic quotes issues. I can't remember.
3. On a clean install, /out/ and /thumbs/ must be added to the root directory in order for titles to render.
4. Ran in to an issue with PHP 5.4 and Imagick. writeImage paths are no longer relative, must be realpath()'d