PHP Version 5.6
Ariadne 9 requires PHP version 5.6 or newer. The installer compares the reported PHP version number to be at least PHP version 5.6.2.
The server you are installing Ariadne on probably has an older version of PHP. We recommend upgrading to a new version of PHP.
DomDocument class
PHP removed the DOMDocument class from the core, so it needs to be installed seperately. This can be done by installing the php-xml package.
Install the php-xml package
Multibyte string support
Ariadne requires multibyte string support so it can work with UTF-8 encoding properly.
Install the php-mbstring package.
Database support
Ariadne has support for multiple database types, although some support is experimental. The installer checks if PHP is able to connect to MySQL or PostgreSQL databases.
Install support for the database you want into PHP.
Webserver support
We recommend running Ariadne on the Apache webserver. Installation on other webservers are known to work (IIS, NGINX) although these have not been tested as much.
Install Ariadne on an Apache webserver.
Webserver: Path info
Ariadne uses path information provided by the webserver.
Set the PATH_INFO directive in the configuration of the webserver.
PHP setting: Zend compatibility
The PHP setting Zend compatibility is not compatible with Ariadne, and will result in unpredictable behaviour.
Disable zend.ze1_compatibility_mode in php.ini.
Filesystem: ariadne.inc is readable
To use Ariadne, the configuration file named ariadne.inc must be web-readable. This file can be found in the webroot of Ariadne.
Check if
ariadne.inc exists in the Ariadne webroot, usually ariadne/www/. If not, copy if from one of the files ariadne.inc-unix or ariadne.inc-win, depending on your operating system.Give read grants for the user that the webserver runs as (usually www-data) to the file named
ariadne.inc in the Ariadne webroot.Filesystem: ariadne path
The Ariadne path variable as set in ariadne.inc must point to the Ariadne installation.
Check the path information in ariadne.inc and make sure that it points to the Ariadne installation.
Filesystem: files directory is writeable
Ariadne writes it's files in the 'files' directory within the Ariadne installation. This directory must be web-writeable.
Set write grants on the
ariadne/files/ directory for the user that the webserver runs as (usually www-data).Ariadne Base package
To install Ariadne, the Ariadne base package must be available.
Check if the file called base.ax is part of the Ariadne distribution, which should always be the case. If this file is not available, please download the complete Ariadne distribution from this site.
PHP class: Archive/Tar
Ariadne uses Tar to compress and decompress packages. This is required to decompress the installation package, so Ariadne cannot install without this.
Check if the class Archive/Tar is installed and available to PHP. The class is available from PEAR.
There is a known issue when using AppServ or Plesk that the default installation has incorrect path settings for includes and openbasedir. This makes PHP unable to find the class although it is part of the default distribution.
Recommended components:
Filesystem: Ariadne.phtml is writeable
The Ariadne installer can automatically write the configuration file for Ariadne. To do this, the configuration file must be web-writeable. If this is not the case, the installer will provide a download of this file so that it can be placed manually.
PHP: Exif support
Ariadne can use Exif information in images and pictures. If this option is not available on the server, Exif information cannot be retreived from images.
PHP: Image Magick support
Ariadne makes use of command line Image Magick to automatically scale and crop images, as well as other image manipulation options. Without Image Magick, Ariadne will not have support for image manipulation options. The check will fail if the binaries are not found (/usr/bin/convert, /usr/bin/mogrify, /usr/bin/composite, /usr/bin/identify)
SVN
Ariadne has support to store the template code in SVN. This option is only available on Linux installations. It requires commandline SVN to be installed, as well as the PHP class VersionControl/SVN. This class is based on the VersionControl/SVN class as found in PEAR, but has been extended and modified. Check out the installation instructions.
SVN Write
Ariadne uses SVN with a specific configuration directory where server certificates can be stored. If this setting is not enabled, SVN will not be able to save certificates, which means it will require the user to confirm the certificate every time an SVN operation requires it.
Set write grants on the
ariadne/lib/configs/svn/ directory for the user your webserver runs as, usually www-data.HTML Tidy
Without this, an option to use HTML Tidy in the HTML editor is not available.
Grep
Grep is used to make it easier to find text-strings within templates. Without Grep, this option will not be available.
Ariadne demo package
This check is run to see if the demo package (demo.ax) is part of the installation. If this file is not available, demo and samples cannot be installed. This package is part of the default Ariadne distribution.