Version 3 end of life
This version of Silverstripe CMS will not recieve any additional bug fixes or documentation updates. Go to documentation for the most recent stable version.

Nginx and HHVM

HHVM is a faster alternative to PHP, in that it runs in a virtual machine and uses just-in-time (JIT) compilation to achieve better performance over standard PHP.

Installation on Debian or Ubuntu is relatively straightforward, in that HHVM already provide packages available to use.

Install apt sources on Debian 7 (wheezy):

	wget -O - http://dl.hhvm.com/conf/hhvm.gpg.key | sudo apt-key add -
	echo deb http://dl.hhvm.com/debian wheezy main | sudo tee /etc/apt/sources.list.d/hhvm.list
	wget -O - http://dl.hhvm.com/conf/hhvm.gpg.key | sudo apt-key add -
	echo deb http://dl.hhvm.com/ubuntu trusty main | sudo tee /etc/apt/sources.list.d/hhvm.list
	sudo apt-get update
	sudo apt-get install hhvm libgmp-dev libmemcached-dev
	sudo update-rc.d hhvm defaults

installation options.

Assuming you already have nginx installed, you can then run a script to enable support for nginx and/or apache2 depending on whether they are installed or not:

	sudo /usr/share/hhvm/install_fastcgi.sh

your nginx server definitions to provide support for PHP requests.

In order to get SilverStripe working, you need to add some custom nginx configuration.

Create /etc/nginx/silverstripe.conf and add this configuration:

	fastcgi_buffer_size 32k;
	fastcgi_busy_buffers_size 64k;
	fastcgi_buffers 4 32k;
	
	location / {
		try_files $uri /framework/main.php?url=$uri&$query_string;
	}
	
	error_page 404 /assets/error-404.html;
	error_page 500 /assets/error-500.html;
	
	location ^~ /assets/ {
		try_files $uri =404;
	}
	location ~ /(mysite|framework|cms)/.*\.(php|php3|php4|php5|phtml|inc)$ {
		deny all;
	}
	location ~ /\.. {
		deny all;
	}
	location ~ \.ss$ {
		satisfy any;
		allow 127.0.0.1;
		deny all;
	}
	location ~ web\.config$ {
		deny all;
	}
	location ~ \.ya?ml$ {
		deny all;
	}
	location ^~ /vendor/ {
		deny all;
	}
	location ~* /silverstripe-cache/ {
		deny all;
	}
	location ~* composer\.(json|lock)$ {
		deny all;
	}
	location ~* /(cms|framework)/silverstripe_version$ {
		deny all;
	}

hhvm.conf being included prior so that php requests are handled.

Now in your nginx server configuration you can then include the hhvm.conf and silverstripe.conf files to complete the configuration required for PHP/HHVM and SilverStripe.

e.g. /etc/nginx/sites-enabled/mysite:

	server {
		listen 80;
		root /var/www/mysite;
		server_name www.mysite.com;
	
		error_log /var/log/nginx/mysite.error.log;
		access_log /var/log/nginx/mysite.access.log;
	
		include /etc/nginx/hhvm.conf;
		include /etc/nginx/silverstripe.conf;
	}