• Home /
  • Installation

Installation

Install Sifo in 5 minutes. So to speak.

In order to install Sifo you need to have at least an Apache/Nginx running with PHP. Depending on your needs a variety of other services can be needed, such as Mysql, Sphinx, Redis... etc. If you want to start playing with Sifo or if you intend to do local development first the most convenient way to work is install Sifo inside a Virtual Machine.

Sifo requirements

Installation

If you are comfortable with a terminal, this is the way to install Sifo. The installation of the Sifo framework basically consists in the following steps:

Let's get started!

Clone the app

Clone the sifo-app which is a sample application using Sifo for an easier start.

git clone https://github.com/sifophp/sifo-app.git

If you don't want to do it this way and prefer a ZIP file or tarball you can still visit the download page and get a copy without git.

Install dependencies

To install the dependencies (including SIFO itself) you need composer. If you have never installed it then:

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

Once composer is installed then you should be able to run composer:

composer install

Configure the web server

This is the part where you tell your webserver where to point to, where the code is. To do so you need to create a VirtualHost in your server. Depending on the technology you use the procedure is different, we provide detailed instructions for Apache and Nginx.

If you have a shared hosting where you can't tune your server configuration there are instructions too, but we can't cover all specific services so we used Webfaction as a sample.

Create your project [recommended]

After downloading the code you should create your own instance, you can see the structure in one of the existing folders, although you can start playing with the existing code.

Important note

It is recommended that you start building your application with a fake domain that will be used for development. We usually use the fake top level domain .local, so if we want to create in the internet an app named mywebapp.com then we create the instance like mywebapp.local

You'll need to add in your /etc/hosts (Linux and Mac) an entry mywebapp.local with the IP of the server. In case you are planning to have multiple and dynamic subdomains a DNS server is recommended (as we suggested with Vagrant installation).

Example of hosts

192.168.1.1       mywebapp.local www.mywebapp.local

At this point, if you have configured the web server pointing to the new instance you should be able to see the page http://mywebapp.local

Download a pre-configured Vagrant box (virtual machine)

Hold on to the seats, this is all you need to do to have Sifo running in your local machine inside a Virtual machine:

  • Download and install Vagrant (do not be scared, this is a double-click installation)
  • Automatically download and install the machine by:

Copy/paste:

git clone --recursive git@bitbucket.org:obokaman/centos-6.3-lamp-with-vagrant-for-sifo.git vmSifo
cd vmSifo
vagrant up

That's all. No kidding. These commands will download a running Sifo via Vagrant

Now to access the running site: