**********************************************************
    
    requirement.txt
    
    $Id$
    
    @author gERD Schaufelberger <gerd@exit0.net>
    @copyright 2004-2006 Wombat Web Bench
    @link http://wombat.exit0.net
    @package wombat
    @subpackage manual
    
**********************************************************

REQUIREMENTS
============

Even if Wombat is a standalone framework, it has few requirements on your
settup. 

1) Web Server
-------------
A Linux server is recommended. Apache (2.x) in combination with MySQL might be a
good choice. Actually, that's the environment Wombat was developed for. 

2) PHP 4 Or PHP 5
-----------------
Wombat is written in PHP. It was developed and runs with PHP 4.3.x. It also runs
with PHP 5 (still, as a PHP 4 project, it produces heaps of strict warnings). 

2.1) What About PHP 4.4
-----------------------
Wombat does a lot of tricks to emulate static variables. Also it does a lot of
reference juggling to avoid unecessary object instanciation. As mentioned above,
this works fine with PHP 4.3.x but it DOES NOT WORK WITH PHP 4.4 - at least on
my server!

On the contrary it runs fine with PHP 5 (5.0 and 5.1)

3) PHP modules
--------------
Rumors tell some people have some trouble because this or that PHP module was
missing. I always thougth, that my installation is quite standard... Here is a
list of modules that are defenitly required: 

 gettext
 mhash
 mysql
 session
 standard
 xml
 zip
 zlib
 
Anything missing? 

3) Third Party Software
-----------------------
The Wombat framework is based on many third party libraries and software. The
good news is that it only uses PHP libraries from two different sources: PHP
Application Tools (http://www.php-tools.net) and PEAR (http://pear.php.net). 

3.1) PHP Application Tools
The libraries from PHP Application Tools are included in Wombat. In other words,
you don't have to worry about them. 

3.2) PEAR Packages
The PEAR packages are the "recommended" PHP libraries. Usually, your PHP
installation comes with PEAR already installed. If your PHP installation does
not include PEAR packages it should at least come with the PEAR installer - a
command line tool to maintain your local PEAR installation: 

 $ pear list

You need at least the following PEAR packages: 

 Console_Getargs
 Log
 Mail
 Mail_mime
 PEAR
 XML_Parser
 XML_Serializer
 XML_Util

Anything missing? 
 
3.3) Other Third Party Software
The gallery-module also needs ImageMagick (http://www.imagemagick.org) to resize 
pictures. The reason why it does not use GD is the quality of the resulting
images. Still it is planed to use GD instead. Unfortunately the current version
of Wombat does not automatically check whether to use ImageMagick or GD. :-(