hhvm README

The project's README from github.com/facebook/hhvm. As one markdown file: README.md.

HHVM

HHVM page | HHVM documentation | Hacklang page | General group | Dev group | Twitter

HHVM is an open-source virtual machine designed for executing programs written in Hack. HHVM uses a just-in-time (JIT) compilation approach to achieve superior performance while maintaining amazing development flexibility.

HHVM should be used together with a webserver like the built in, easy to deploy Proxygen, or a FastCGI-based webserver on top of nginx or Apache.

Installing

If you're new, try our getting started guide.

You can install a prebuilt package or compile from source.

Running

You can run standalone programs just by passing them to hhvm: hhvm example.hack.

If you want to host a website:

Our getting started guide provides a slightly more detailed introduction as well as links to more information.

Contributing

We'd love to have your help in making HHVM better. If you're interested, please read our guide to contributing.

License

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

The Hack typechecker is licensed under the MIT License except as otherwise noted.

The Hack Standard Library is licensed under the MIT License except as otherwise noted.

Reporting Crashes

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

Security

For information on reporting security vulnerabilities in HHVM, see SECURITY.md.

FAQ

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

There is also a FAQ for contributors to HHVM.

hhvm (facebook/hhvm)

web-server
Searching Database…

18.7K ·GitHub
What is this?An open-source virtual machine that executes programs written in Hack, using just-in-time compilation for high performance while staying flexible to develop with.
Is this a language I write, or the thing that runs it?It is the runtime side: you write Hack, and HHVM executes it via a JIT compiler. The repo also carries the MIT-licensed Hack typechecker and Hack Standard Library.
Can I install it without building from source?Yes — install a prebuilt package; compiling from source is the alternative. Newcomers are pointed to the project's getting started guide.
How would I host a website on it?Pair it with a webserver: the built-in Proxygen (fast and easy to deploy) or a FastCGI setup behind nginx or Apache. After installing the package, start it with 'sudo /etc/init.d/hhvm start'.
Is everything under one license?No — HHVM itself uses the PHP and Zend licenses, while the Hack typechecker and the Hack Standard Library are both MIT-licensed.
What is Proxygen?The webserver built into HHVM. The README bills it as fast and easy to deploy — the no-fuss alternative to putting HHVM behind nginx or Apache over FastCGI.
Is the project still active?It looks that way: the GitHub repo dates back to 2010, is not archived, and has roughly 18.7k stars.
What are similar projects?v8, mono, coreclr, ir, wasmtime, webserver, DeepGEMM-Ascend, uWebSockets
Creator
facebook
Size
872 MB
Stars
18.7K
Age
16y
Commits · 90 Days