Source code transformer from PHP to C++
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 26810 commits behind facebook:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

HipHop for PHP

HipHop is a source code transformer which transforms PHP source code into highly optimized C++ and then compiles it using g++. Currently supported platforms are Linux and FreeBSD. There is no OS X support.

Required Packages

The latest information is available on the wiki

  • cmake 2.6 is the minimum version
  • g++/gcc 4.3 is the minimum version
  • Boost 1.37 is the minimum version
  • flex
  • bison
  • re2c
  • libmysql
  • libxml2
  • libmcrypt
  • libicu 4.2 is the minimum version
  • openssl
  • binutils
  • libcap
  • gd
  • zlib
  • tbb Intel's Thread Building Blocks
  • Oniguruma
  • libpcre
  • libexpat
  • libmemcached

The following packages have had slight modifications added to them. Patches are provided and should be made against the current source copies.

  • libcurl
  • src/third_party/libcurl.fb-changes.diff
  • libevent 1.4
  • src/third_party/libevent-1.4.13.fb-changes.diff OR src/third_party/libevent-1.4.14.fb-changes.diff


You may need to point CMake to the location of your custom libcurl and libevent, or to any other libraries which needed to be installed. The CMAKE_PREFIX_PATH variable is used to hint to the location.

export CMAKE_PREFIX_PATH=/home/user

To build HipHop, use the following:


cd /home/user/dev
git clone git://
cd hiphop-php
git submodule init
git submodule update
export HPHP_HOME=`pwd`
export HPHP_LIB=`pwd`/bin
cmake .

If you are using FreeBSD instead use export - setenv

Once this is done you can generate the build file. This will return you to the shell. Finally, to build, run make. If any errors occur, it may be required to remove the CMakeCache.txt directory in the checkout.


Contributing to HipHop

HipHop is licensed under the PHP and Zend licenses except as otherwise noted.

Before changes can be accepted a Contributors Licensing Agreement must be signed and returned.

Running HipHop

Please see the wiki page