README.md

   1 # HipHop for PHP
   2
   3 HipHop is a high performance PHP toolchain. Currently supported platforms are Linux and FreeBSD. There is no OS X support.
   4
   5 * [Developer Mailing List](http://groups.google.com/group/hiphop-php-dev)
   6 * [Wiki](http://wiki.github.com/facebook/hiphop-php)
   7 * [Issue Tracker](http://github.com/facebook/hiphop-php/issues)
   8
   9 ## Required Packages
  10
  11 The latest information is available on the [wiki](http://wiki.github.com/facebook/hiphop-php/building-and-installing)
  12
  13 * cmake *2.6 is the minimum version*
  14 * g++/gcc *4.3 is the minimum version*
  15 * Boost *1.37 is the minimum version*
  16 * flex
  17 * bison
  18 * re2c
  19 * libmysql
  20 * libxml2
  21 * libmcrypt
  22 * libicu *4.2 is the minimum version*
  23 * openssl
  24 * binutils
  25 * libcap
  26 * gd
  27 * zlib
  28 * tbb *Intel's Thread Building Blocks*
  29 * [Oniguruma](http://www.geocities.jp/kosako3/oniguruma/)
  30 * libpcre
  31 * libexpat
  32 * libmemcached
  33 * google-glog (http://code.google.com/p/google-glog/)
  34
  35 The following packages have had slight modifications added to them. Patches are provided and should be made against the current source copies.
  36
  37 * [libcurl](http://curl.haxx.se/download.html)
  38 * src/third_party/libcurl.fb-changes.diff
  39 * [libevent 1.4](http://www.monkey.org/~provos/libevent/)
  40 * src/third_party/libevent-1.4.13.fb-changes.diff       OR src/third_party/libevent-1.4.14.fb-changes.diff
  41
  42 ## Installation
  43
  44 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.
  45
  46     export CMAKE_PREFIX_PATH=/home/user
  47
  48 To build HipHop, use the following:
  49
  50 Linux:
  51
  52     cd /home/user/dev
  53     git clone git://github.com/facebook/hiphop-php.git
  54     cd hiphop-php
  55     git submodule init
  56     git submodule update
  57     export HPHP_HOME=`pwd`
  58     export HPHP_LIB=`pwd`/bin
  59     cmake .
  60
  61 If you are using FreeBSD instead use export - setenv
  62
  63 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.
  64
  65     make
  66
  67 ## Contributing to HipHop
  68 HipHop is licensed under the PHP and Zend licenses except as otherwise noted.
  69
  70 Before changes can be accepted a [Contributors Licensing Agreement](http://developers.facebook.com/opensource/cla) must be signed and returned.
  71
  72 ## Running HipHop
  73
  74 Please see [the wiki page](http://wiki.github.com/facebook/hiphop-php/running-hiphop)