Getting Started
如果你之前没有接触过 HHVM,这个快速指南可以让你快速上手,当然了,作为快速指南,说明这里不会展开太多复杂的细节,如果你需要查看完整的文档,请点击这里
概览
用 HHVM 来运行你的代码是非常简单的,你只需要准备:
- HHVM 本身
- Hack 代码
在安装的时候,虽然不同版本的 Debian 和 Ubuntu 你都能获取到官方编译的 HHVM,但还是建议你在最新的 Ubuntu LTS 上安装以获得最佳安装体验。
安装 HHVM
请参阅我们关于安装预编译包的说明.
你也可以选择采用源码编译 HHVM,不过会比较复杂且费时,因此,除非你已经熟悉 HHVM 了且你有特殊的需求,否则我们不推荐你采用源码编译的方式来装
测试 HHVM
安装完 HHVM 之后,切换到你项目的代码目录,然后启动 HHVM:
hhvm -m server -p 8080
-m
表示工作模式,这里我们指定 HHVM 以 HTTP server 的模式来启动
-p
指定 HHVM 在 HTTP 模式下监听的 TCP 请求端口,默认是标准 HTTP 端口 80,不过由于 80 端口需要有管理员权限才能监听,因此在这个例子中,我们监听 8080 端口
当你的 HHVM 启动起来之后,咱们来写下第一个 "Hello World" 程序,命名为 hello.hack
:
<<__EntryPoint>>
function main(): void {
echo "Hello World!\n";
}
保存 hello.hack
到刚刚执行 hhvm
命令的工作目录,然后用浏览器访问 http://localhost:8080/hello.hack ,你就可以看到 “Hello World!” 了
配置 HHVM
HHVM 的配置是开箱即用的,一般来说你不需要去修改它的配置。需要注意的是,给 HHVM 加速的 JIT 编译器默认是开启的。如果你想查看已有配置,Linux 请查看 /etc/hhvm/php.ini
,macOS 请查看 /usr/local/etc/hhvm/php.ini
当你将 HHVM 设置为开机自启的服务而不是像上面这样通过终端模拟器启动时,你就需要专门做一些配置了,具体请查看proxygen 文档
运行 Hack 代码文件
Hack 是 Facebook 发明的一门编程语言,它基于 PHP 的语法,提供了类型检查等众多语言特性,HHVM 是可以运行 Hack 代码的,比如说上面用来测试 HHVM 的 Hello world 程序
在测试和执行 Hack 文件之前,确保你已经用 hh_client
检查过你的代码文件了,否则你将可能会得到一堆类型错误提示
学习 Hack 和 PHP
学习 PHP 和 Hack 编程语言超出了本指南的范围,如果你想认真地学习,那么最佳的资料就是官方 Hack 文档,还有非常推荐一本由 Facebook HHVM 团队的工程师编写的书《O'Reilly book on HHVM and Hack》
关于 PHP 的资料,请查阅PHP 官方文档,上面有很详尽的关于 PHP 的介绍以及大量代码示例
本节由 Y!an 翻译