Installation: Requirements

Manifesto runs properly with Apache 1.3x on Linux boxes. PHP is officially unsupported with Apache 2.x, but Manifesto has been made to work with it. It requires an additional configuration change, but allows Manifesto to run on other Unix flavors in addition to Linux. The following is a more-or-less comprehensive list of the software you need installed on your server to run a Manifesto site:

• Apache 1.3.22 (may work with slightly earlier versions)
• MySQL 3.23.23 or higher (needs FULLTEXT indexing)
• PHP 4.2 or higher (4.3 highly recommended, especially for multi-lingual sites)
• cURL 7.8 or higher (for cron jobs)
• gd 1.6.2 or higher (for image resizing)
• phpMyAdmin is essential for quick, raw database access (handy!)
• …and recent versions of common libraries (libtiff,libjpeg,zlib,etc).

PHP was compiled with the following options. Also read the important notes below.

./configure —with-config-file-path=/usr/local —with-mysql (*) —with-gettext (*) —with-gd (*) —with-jpeg-dir (*) —with-png-dir (*) —with-curl (*) —enable-ftp (*) —enable-trans-sid (*) —with-tiff-dir —with-ttf —enable-bcmath —enable-inline-optimization —enable-sysvsem —enable-sysvshm —enable-shared-pdflib —with-zlib —with-regex=system —enable-sockets —with-apxs=/usr/sbin/apxs

Not all of these are essential to Manifesto, which doesn't currently use things like LDAP or the PDFlib, but the options marked with (*) are essential. If you're already using PHP and don't know what options are enabled, create a page with on it to display them. If you are using RedHat RPMs, some of these options may be added to your PHP configuration through Dynamic Object modules, and not compiled in directly.

PHP 4.2 now defaults to having the register_globals directive set to off. Manifesto since version .95 has been rewritten to work with register_globals OFF, so it is safe to leave it off. Manifesto will certainly work fine with it set to ON as well.

PHP must be compiled with gettext() support if you wish to support multiple languages. For English only, Manifesto will work without gettext() support.

If you wish to use a remote content server for your images, you must have FTP support compiled into PHP.

Apache 2.x: Manifesto uses a URL-parsing technique to maintain clean URLs. This technique requires a modification to the Apache configuration file for support in Apache 2.x. In the Apache configuration file, either in the global scope, or within the VirtualHost directive covering your Manifesto site, add the directive
AcceptPathInfo on
inside the VirtualHost directive governing your site. This has been made to work in the past, but officially, Manifesto is not supported with Apache2 (since PHP isn't officially supported under Apache2).

The GD libraries are needed for resizing images and creating thumbnails automatically. It isn't essential, and there are checks in place to see whether or not it's installed, but things can get confusing if you install only some of the components, like GD, but not libjpeg. So if you compile GD support, be sure you also include libpng, libjpg, and ideally, libtiff. PHP version 4.3 includes a bundled GD library that allows for the resizing of GIF images. Since Manifesto version .96, support for the external software ImageMagick has been added to replace the functionality of the GD library.

phpMyAdmin is highly recommended for quick administrative access to the databases. Get it here.