This version is outdated. You should upgrade your project to Mako 9.1 or Mako 10.0!
Getting started



  • PHP 5.5.0 or higher *
  • mbstring
  • PDO

* Tested on PHP 5.5.x, 5.6.x and HHVM 3.x.x


Installing Mako is easy and can be with one single command thanks to composer:

composer create-project mako/app:4.* <project name>

Remember to make the app/storage/* directories writable.

Mako can now be updated using the following command:

composer update

You can also download a bare bones Mako application if you're unable to use composer.

Server configurations


Basic Apache configuration for a Mako application:

<VirtualHost *:80>

	DocumentRoot /srv/www/mako/htdocs/public

	<Directory /srv/www/mako/htdocs/public>

		Options -Indexes +FollowSymLinks -MultiViews
		AllowOverride All
		Order allow,deny
		allow from all

		# URL rewrite

		RewriteEngine on

		RewriteCond %{REQUEST_FILENAME} !-f
		RewriteCond %{REQUEST_FILENAME} !-d
		RewriteRule ^(.*)$ index.php/$1 [L]


	LogLevel warn
	ErrorLog /srv/www/mako/logs/error.log
	CustomLog /srv/www/mako/logs/access.log combined



Basic Nginx configuration for a Mako application:

	listen 80;

	access_log /srv/www/mako/logs/access.log;
	error_log  /srv/www/mako/logs/error.log;

	root /srv/www/mako/htdocs/public;

	index index.php;

	# "URL rewrite"

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

	# Pass URIs ending in .php to the PHP interpreter

	location ~* \.php$
		try_files       $uri =404;
		include         fastcgi_params;
		fastcgi_param   SCRIPT_FILENAME $document_root$fastcgi_script_name;