Get started

Server requirements

The Exception framework has a few system requirements.
You will need to make sure your server meets the following requirements:

  • Apache or nginx webserver
  • PHP >= 7.1.3
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Ctype PHP Extension
  • JSON PHP Extension
  • GD Image PHP Extension

Installing Exception

Exception utilizes Composer to manage its dependencies so, before using Exception, make sure you have Composer installed on your machine.
You can install Exception using Composer create-project command in your terminal:

composer create-project andreapollastri/exceptionframework .


If you need a staging environment or if you need to install a VPS with Exception Framework you can use Cipi, an autodeploy tool that sets a LAMP webserver with phpmyadmin and basic security features on Linux Ubuntu 16.04 or 18.04 Server.


Public directory

After installing Exception, you should configure your web server's document / web root to be the "http" directory. The index.php in this directory serves as the front controller for all HTTP requests entering your application.

Is important to set http directory as your web root.
If you are not able to do it... use ef root CLI to change public document root settings.

Directory permissions

After installing Exception, you may need to configure some permissions.
Directories within the http/storage, http/assets and the apps/APPS-NAME/cache directories should be writable by your web server or Exception will not run.

Pretty URLs

Exception includes a http/.htaccess file that is used to provide URLs without the index.php front controller in the path. Before serving Exception with Apache, be sure to enable the mod_rewrite module so the .htaccess file will be honored by the server.

If you are using Nginx, the following directive in your site configuration will direct all requests to the index.php front controller:

location / {
   try_files $uri $uri/ /index.php?$query_string;

Do you need help?

Write me an e-mail: [email protected]