This diff introduces assert_throw, assert_log, and always_assert_ versions of the two. They behave similarly to assert, but assert_throw throws a FailedAssertion exception instead of calling abort. This lets us catch the exception and add additional debug info to the stacktrace file. In the case of the IR, this is the current Trace. assert_log takes the condition to check and a lambda that is expected to return a std::string. If the condition fails, the lambda will be evaluated and the text returned will be included in the stacktrace file. I've left assert_throw off by default so people have to opt into it locally or in Perflab (see the comment in assert_throw.h)
HipHop for PHP
HipHop is a high performance PHP toolchain. 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
- google-glog (http://code.google.com/p/google-glog/)
- libc-client2007
- libdwarf
- libelf
- libunwind
The following packages have had slight modifications added to them. Patches are provided and should be made against the current source copies.
- libcurl
- hphp/third_party/libcurl.fb-changes.diff
- libevent 1.4
- hphp/third_party/libevent-1.4.14.fb-changes.diff
Installation
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:
Linux:
cd /home/user/dev
git clone git://github.com/facebook/hiphop-php.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.
make
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