/hhvm

HipHop VM (HHVM) is an open-source virtual machine designed for executing programs written in PHP.

Primary LanguageC++OtherNOASSERTION

HipHop VM for PHP Build Status

HipHop VM (HHVM) is a new open-source virtual machine designed for executing programs written in PHP. HHVM uses a just-in-time compilation approach to achieve superior performance while maintaining the flexibility that PHP developers are accustomed to. HipHop VM (and before it HPHPc) has realized > 5x increase in throughput for Facebook compared with Zend PHP 5.2.

HipHop is most commonly run as a standalone server, replacing both Apache and modphp.

FAQ

Our FAQ has answers to many common questions about HHVM, from general questions to questions geared towards those that want to use or contribute to HHVM.

Installing

You can install a prebuilt package or compile from source.

Running

You can run standalone programs just by passing them to hhvm: hhvm my_script.php.

HipHop bundles in a webserver. So if you want to run on port 80 in the current directory:

sudo hhvm -m server

For anything more complicated, you'll want to make a config.hdf and run sudo hhvm -m server -c config.hdf.

Contributing

We'd love to have your help in making HipHop better.

Before changes can be accepted a Contributor License Agreement (pdf - print, sign, scan, link) must be signed.

If you run into problems, please open an issue, or better yet, fork us and send a pull request. Join us on #hhvm on freenode.

If you want to help but don't know where to start, try fixing some of the Zend tests that don't pass. You can run them with hphp/test/run. When they work, move them to zend/good and send a pull request.

All the open issues tagged Zend incompatibility are real issues reported by the community in existing PHP code and frameworks that could use some attention. Please add appropriate test cases as you make changes; see here for more information. Travis-CI is integrated with this GitHub project and will provide test results automatically on all pulls.

License

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

Reporting Crashes

See Reporting Crashes for helpful tips on how to report crashes in an actionable manner.