Tutorial

How To Install HHVM (HipHop Virtual Machine) on an Ubuntu 13.10 VPS

Published on March 18, 2014
author

Jay Martinez

How To Install HHVM (HipHop Virtual Machine) on an Ubuntu 13.10 VPS

Introduction

This article will walk through the steps required to install HHVM on Ubuntu 13.10 on a Digital Ocean VPS. The article will also illustrate how HHVM can be used by creating:

  1. A command line ‘Hello World’ script in PHP

  2. A web based ‘Hello World’ script written in PHP and served by the HHVM server

Prerequisites

The only prerequisite for this tutorial is a VPS with Ubuntu 13.10 x64 installed. Note that HHVM doesn’t support any 32 bit operating system and they have no plans to add support for 32 bit operating systems.

You will need to execute commands from the command line which you can do in one of two ways:

  1. Use SSH to access the droplet.

  2. Use the ‘Console Access’ from the Digital Ocean Droplet Management Panel

What is HHVM?

HipHop Virtual Machine (HHVM) is a virtual machine developed and open sourced by Facebook to process and execute programs and scripts written in PHP. Facebook developed HHVM because the regular Zend+Apache combination isn’t as efficient to serve large applications built in PHP.

According to their website, HHVM has realized over a 9x increase in web request throughput and over a 5x reduction in memory consumption for Facebook compared with the Zend PHP engine + APC (which is the current way of hosting a large majority of PHP applications).

Installing HHVM

Installing HHVM is quite straightforward and shouldn’t take more than a few minutes. Executing the following 4 commands from the command line will have HHVM installed and ready:

wget -O - http://dl.hhvm.com/conf/hhvm.gpg.key | apt-key add -
echo deb http://dl.hhvm.com/ubuntu saucy main | tee /etc/apt/sources.list.d/hhvm.list
apt-get update
apt-get install hhvm

To confirm that HHVM has been installed, type the following command:

hhvm --help

This will show details of how the hhvm command can be used from the command line. Here is a sample screenshot that illustrates this:

hhvm --help screenshot

Test a ‘Hello World’ script in PHP From the Command Line using HHVM

Type the following command on the command line:

cat > hello_world.php

This will create a file named hello_world.php and allow you to enter its contents. Type in (or copy and paste) the following code and then press Ctrl + D to save the file.

<?php

echo "\nHello World\n\n";

Note: If you are familiar with editors like nano or vim, you can use those to create and save this file.

Once this file has been created, hhvm can be used to execute it using the following command:

hhvm hello_world.php

Here is a screenshot to illustrate the creation and execution of this Hello World script:

Command Line Hello World

Test a ‘Hello World’ script in PHP Using the HHVM Server (accessible from the browser)

First create a directory (public) that will serve as the public folder and contain the PHP file. Note that you can name this directory anything and place it anywhere. Execute the following commands to create this directory and enter it:

mkdir public
cd public

Now type the following command on the command line:

cat > hello.php

This will create a file named hello.php in the public directory and allow you to enter its contents. Type in (or copy and paste) the following code and then press Ctrl + D to save the file.

<?php

echo '<h1>Hello World</h1>';

Note: If you are familiar with editors like nano or vim, you can use those to create and save this file.

Once this file has been created, hhvm can be used from the command line to start the server in the following manner:

hhvm -m server

Here is a screenshot to illustrate the creation and execution of this Hello World script:

Web Based Hello World Commands

This command will start the server (on port 80) and the hello.php file can now be accessed from the browser. If the IP address of the droplet is 128.199.212.7, this newly created file can be accessed at:

http://128.199.212.7/hello.php

Note: Replace 128.199.212.7 with the IP address or domain name used by your droplet.

Accessing this URL should display a webpage similar to the one in the following screenshot:

Web Based Hello World Screenshot

Porting Your PHP Application to HHVM

In order to start serving a PHP application using HHVM instead of Zend/Apache on port 80 (the standard port for websites), the Apache service needs to be stopped. This can be done using the following command:

service apache2 stop

This command will stop Apache and free up port 80 for HHVM to use. The next step is to start the HHVM server in the root directory of your PHP application. The most common location of this root directory on Ubuntu is /var/www.

Switch to this directory using the following command:

cd /var/www

Once you are in this directory, all you need to do is start the HHVM server:

hhvm -m server

This command will start the HHVM server, which will begin serving your PHP application from the current directory.

Using HHVM in the FastCGI Mode

Starting with version 3.0, HHVM can no longer be used in the server mode. This section will help you configure HHVM in the FastCGI mode with the Apache and Nginx servers.

With Apache

Configuring HHVM to work in the FastCGI mode with Apache is extremely simple. All you need to do is execute the following following script:

/usr/share/hhvm/install_fastcgi.sh

Running this script configures Apache to start using HHVM to process the PHP code. It’ll also restart the Apache server so you don’t have to do anything else.

With Nginx

If you are using Nginx with PHP-FPM, you’ll have to modify the configuration file to disable the use of PHP-FPM. This file is normally located at /etc/nginx/sites-available/default

Look for the following section and make sure it’s all commented (by adding a # at the beginning of each line)

# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
#
#location ~ \.php$ {
#       fastcgi_split_path_info ^(.+\.php)(/.+)$;
#       # NOTE: You should have "cgi.fix_pathinfo = 0;" in php.ini
#
#       # With php5-cgi alone:
#       fastcgi_pass 127.0.0.1:9000;
#       # With php5-fpm:
#       fastcgi_pass unix:/var/run/php5-fpm.sock;
#       fastcgi_index index.php;
#       include fastcgi_params;
#}

After doing this, execute the following script:

/usr/share/hhvm/install_fastcgi.sh

Executing this script configures Nginx to start using HHVM to process the PHP code. It’ll also restart the Nginx server so you don’t have to do anything else.

Confirming that Apache/Nginx is Using HHVM

After you have configured your server to start using HHVM, it’s always a good idea to confirm that the server (Apache or Nginx) is indeed using HHVM to process PHP.

You can do this by creating a test PHP file, let’s say info.php and putting it in the public folder of your server (typically /var/www for Apache and /usr/share/nginx/html for Nginx). Now put the following content in this file:

<?php

echo  defined('HHVM_VERSION')?'Using HHVM':'Not using HHVM';

Now if everything is set up fine, when you access this file in the browser, you should see the following message:

Using HHVM

Important Note

HHVM has incorporated a lot of commonly used PHP extensions, making it easy to port a large number of applications without much fuss. However, if an application uses a PHP extension that hasn’t been incorporated yet, choosing HHVM will break the application. The complete list of PHP extensions that have been ported over to HHVM can be found here

Final Word

If you have reached this far, you are now well equipped to start using HHVM to serve your PHP based websites. Being several times more efficient than the regular Zend PHP engine + APC combination, HHVM can help you serve a lot more visitors to your website with much lower hardware requirements!

<div class=“author”>Submitted by: <a href=“http://javascript.asia”>Jay</a></div>

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about our products

About the authors
Default avatar
Jay Martinez

author

Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
10 Comments


This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

I have droplext with ubuntu 14.04, with nginx, if I install HHVM, does that conflict with my existing installation or they can work parallel

With minor tweaks I got it working, HHVM 3.4 on a Ubuntu 14.04 with NginX 1.4.6. Now heading for WordPress and Varnish. Great help, thanks.

If you had this message: “The following packages have unmet dependencies: hhvm-dbg : Depends: libmemcached10 but it is not installable Depends: librtmp0 but it is not installable”

You must insert in “/etc/apt/sources.list.d/hhvm.list” this line (in ubuntu 14.04).

deb http://cz.archive.ubuntu.com/ubuntu trusty main

If you have Ubuntu 13, you must put (not tested): deb http://cz.archive.ubuntu.com/ubuntu saucy main

I am using Ubuntu 12.04 . I followed this article with success, but i want to install Wordpress and configure nginx accordingly. Maybe there is some article on DO community about this, but i couldn’t find it. Instead i found this tutorial and it helped me with my purpose.

@Kamal: Got a small problem: hhvm executing on cli works fine, if I enter domain.tld/index.php it works too but if I enter domain.tld it downloads the index.php file.

Any hint what I’m doing wrong?`

Kamal Nasser
DigitalOcean Employee
DigitalOcean Employee badge
April 7, 2014

@edk.ceosc: We’ll update the article soon to work with HHVM 3.0.0. Meanwhile, check out the links Iko posted.

Kamal Nasser
DigitalOcean Employee
DigitalOcean Employee badge
April 7, 2014

@gchumillas: Prepending the apt-key command with sudo works fine as well. I’ll update the article to include sudo commands where appropriate. Thanks!

@edk.ceosc: Here is a link and guide you want to test or use it.

Sorry for this lame question. I got:

Uncaught exception: HHVM no longer supports the built-in webserver as of 3.0.0. Please use your own webserver (nginx or apache) talking to HHVM over fastcgi. https://github.com/facebook/hhvm/wiki/FastCGI\n

So well… How do I use my own apache/nginx server ? Thanks :C

Note that you should be logged as root user. This will NOT work: sudo wget -O - http://dl.hhvm.com/conf/hhvm.gpg.key | apt-key add -

Use these two commands instead: sudo su wget -O - http://dl.hhvm.com/conf/hhvm.gpg.key | apt-key add -

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Featured on Community

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more