The "AMP" (Apache, MySQL, PHP) Stack

To install and run SwiftRiver, the following software packages must be installed in your development or production environment:

• PHP 5.3 or greater
• Apache HTTP Server 2.x
• MySQL Database Server 5.1 or greater

Apache Modules

SwiftRiver is bundled with a .htaccess file that contains URL rewriting rules. For these rewrite rules to be honored, Apache's mod_rewrite needs to be installed and enabled on your web server. The sections below outline how to enable mod_rewrite on OS X and Linux (Debian, Ubuntu and CentOS)

CentOS and OS X

Uncomment the following line in your httpd.conf

LoadModule rewrite_module

Debian/Ubuntu

Run the following command from the shell prompt:

$ sudo a2enmod rewrite

Restart your web server for the changes to take effect.

Required PHP Extensions

In addition to the software packages outlined above, the following PHP libraries MUST be installed and enabled in your PHP configuration file (php.ini)

• cURL for accessing remote sites
• OpenSSL for secure communication
• MySQL for database access
• mcrypt for cryptography services
• PCNTL for processing control
• GD for image processing

The sections that follow outline how to install the required extension on OS X and Linux (Ubuntu, Debian and CentOS)

OS X Installation via MacPorts

$ sudo port install php5-curl
$ sudo port install php5-mcrypt
$ sudo port install php5-mysql
$ sudo port install php5-pcntl
$ sudo port install php5-openssl
$ sudo port install php5-gd

Restart Apache:

$sudo /path/to/apachectl restart

Debian/Ubuntu Installation

$ sudo apt-get install php5-curl php5-mcrypt php5-mysql php5-pcntl php5-openssl php5-gd

Restart Apache:

$ sudo service apache2 restart

or:

$ sudo /etc/init.d/apache2 restart

CentOS (and other RPM-based distributions) Installation via Yum

$ sudo yum install php5-curl php5-mcrypt php5-mysql php5-pcntl php5-openssl php5-apc php5-gd

Restart Apache:

$ sudo service httpd restart