Skip to content
This repository has been archived by the owner on Mar 15, 2018. It is now read-only.


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

Heroku Buildpack for HHVM

Build Status

This is a Heroku buildpack (and Cloud Foundry Buildpack) for PHP apps to run on HHVM.

The buildpack will detect your app as PHP if it has a index.php or composer.json file in the root.


To use it with a new app:

heroku create --buildpack

Or to convert your existing PHP app:

heroku config:set BUILDPACK_URL=
<make some git change and commit it>
git push

If your app needs a custom config.hdf just save it in the root of your project. Otherwise, a default one will be applied with the following settings:

Server {
  DefaultDocument = index.php


The buildpack can't set environment variables (slug compilation takes place on different dynos). If you plan to run HHVM from CLI, you can define LD_LIBRARY_PATH by running:

heroku config:add LD_LIBRARY_PATH=vendor/hhvm/


You should see anywhere between 2x and 10x performance gains on your app. This means you will need fewer dynos to serve the same amount of traffic.


If you have some PHP code that won't run with HHVM, we would love you to send us example code and open an issue. HHVM's goal is to support all open source projects, so please report any and all issues.


No releases published


No packages published