README.md

   1 # HHVM [![Build Status](https://travis-ci.org/facebook/hhvm.svg)](https://travis-ci.org/facebook/hhvm)
   2
   3 HHVM (aka the HipHop Virtual Machine) is an open-source virtual machine designed for executing programs written in [Hack](http://hacklang.org) and PHP. HHVM uses a just-in-time compilation approach to achieve superior performance while maintaining the flexibility that PHP developers are accustomed to. To date, HHVM (and its predecessor HPHPc before it) has realized over a 9x increase in web request throughput and over a 5x reduction in memory consumption for Facebook compared with the PHP 5.2 engine + APC.
   4
   5 HHVM should be used together with a FastCGI-based webserver like [nginx](https://github.com/facebook/hhvm/wiki/FastCGI#making-it-work-with-nginx) or [apache](https://github.com/facebook/hhvm/wiki/FastCGI#making-it-work-with-apache).
   6
   7 * HHVM page: http://hhvm.com
   8 * Hack page: http://hacklang.org
   9
  10 ## FAQ
  11
  12 Our [FAQ](https://github.com/facebook/hhvm/wiki/FAQ) has answers to many common questions about HHVM, from [general questions](https://github.com/facebook/hhvm/wiki/FAQ#general) to questions geared towards those that want to [use](https://github.com/facebook/hhvm/wiki/FAQ#users) or [contribute](https://github.com/facebook/hhvm/wiki/FAQ#contributors) to HHVM.
  13
  14
  15 ## Installing
  16
  17 You can install a [prebuilt package](https://github.com/facebook/hhvm/wiki#installing-pre-built-packages-for-hhvm) or [compile from source](https://github.com/facebook/hhvm/wiki#building-hhvm).
  18
  19
  20 ## Running
  21
  22 You can run standalone programs just by passing them to hhvm: `hhvm my_script.php`.
  23
  24 If you want to host a website:
  25 * Install your favorite webserver
  26 * Install our [package](https://github.com/facebook/hhvm/wiki#installing-pre-built-packages-for-hhvm)
  27 * Start your webserver
  28 * Run `sudo /etc/init.d/hhvm start`
  29 * Visit your site at http://.../index.php
  30
  31 ## Contributing
  32
  33 We'd love to have your help in making HHVM better.
  34
  35 Before changes can be accepted a [Contributor License Agreement](http://code.facebook.com/cla) ([pdf](https://github.com/facebook/hhvm/raw/master/hphp/doc/FB_Individual_CLA.pdf) - print, sign, scan, link) must be signed.
  36
  37 If you run into problems, please open an [issue](http://github.com/facebook/hhvm/issues), or better yet, [fork us and send a pull request](https://github.com/facebook/hhvm/pulls). Join us on [#hhvm on freenode](http://webchat.freenode.net/?channels=hhvm).
  38
  39 If you want to help but don't know where to start, try fixing some of the [PHP5 tests that don't pass](hphp/test/zend/bad). You can run them with [hphp/test/run](hphp/test/run). When they work, move them to [zend/good](hphp/test/zend/good) and send a pull request.
  40
  41 All the open issues tagged [php5 incompatibility](https://github.com/facebook/hhvm/issues?labels=php5+incompatibility&page=1&state=open) are real issues reported by the community in existing PHP code and [frameworks](https://github.com/facebook/hhvm/wiki/OSS-PHP-Frameworks-Unit-Testing:-General) that could use some attention. Please add appropriate test cases as you make changes; see [here](hphp/test) for more information. Travis-CI is integrated with this GitHub project and will provide test results automatically on all pulls.
  42
  43
  44 ## License
  45
  46 HHVM is licensed under the PHP and Zend licenses except as otherwise noted.
  47
  48 ## Reporting Crashes
  49
  50 See [Reporting Crashes](https://github.com/facebook/hhvm/wiki/Reporting-Crashes) for helpful tips on how to report crashes in an actionable manner.