Getting started

This page explains how to install the ensemble system. A few requirements are listed before it is possible to install ensemble. After everything went well, a last configuration step is required to adjust it to your needs.

Requirements

Ensemble is a php framework and requires php and a SQL database. It is developed with Apache as webserver, but since ensemble is based on the Zend Framework 2, it should also run fine with nginx or IIS.

Installation

First, you need to get this Github repository onto the machine you want to test on (probably your local computer). So clone:

git clone git://github.com/ensemble/SampleApplication.git

Next get into the SampleApplication directory and use Composer to load all dependencies of ensemble:

curl -s http://getcomposer.org/installer | php
php composer.phar install

This might take a while, but all dependencies are downloaded and an autoload file is generated. When finished you need to setup your webserver to point to the public directory of ensemble. For Apache, you can use something like this is you downloaded ensemble into /var/www and want to test the app on cmf.localhost:

<VirtualHost *:80>
  DocumentRoot /var/www/SampleApplication/public
  ServerName cmf.localhost
</VirtualHost>

Don't forget to add cmf.localhost to your /etc/hosts file for 127.0.0.1 otherwise your machine cannot resolve the DNS.

Next you need to open the file config/autoload/module.doctrine_orm.local.php.dist and save it as config/autoload/module.doctrine_orm.local.php. Update the values to your needs (especially the username, password and database name under the connection section).

As a last step, load the data/schema.sql file into your database and see if you can open cmf.localhost and watch the Twitter bootstrap site!