hhvm/hhvm-proxygen

HHVM Proxygen 镜像文档

镜像概述和主要用途

该镜像包含安装并运行的HHVM，作为Web服务器（通过Proxygen）运行在Ubuntu系统上。HHVM（HipHop Virtual Machine）是一个高性能的PHP执行引擎，适用于服务PHP应用程序。

核心功能和特性

• 作为Web服务器运行，通过Proxygen处理HTTP请求
• 监听80端口
• 默认文档和404文档均为index.php
• 服务根目录为/var/www/public，建议将项目代码安装到/var/www，通过public/子目录作为Web可访问目录
• 支持通过替换/etc/hhvm/site.ini文件添加额外的INI配置

使用场景和适用范围

• 开发环境：快速部署和测试PHP应用程序
• 生产环境：构建基于该镜像的自定义镜像，用于生产环境部署PHP应用

详细使用方法和配置说明

开发使用

bash
$ cd mysite
# 使用随机分配的端口
$ docker run --name=my_container -v $(pwd):/var/www -d -P hhvm/hhvm-proxygen:latest
$ docker port my_container 80 # 查看分配的端口
# 或指定端口12345
$ docker run --name=my_container -v $(pwd):/var/www -d -p 12345:80 hhvm/hhvm-proxygen:latest

生产使用

建议通过指定新的Dockerfile构建基于该镜像的自定义镜像：

dockerfile
FROM hhvm/hhvm-proxygen:latest

RUN apt-get update -y && apt-get install -y curl
# 安装Composer
RUN mkdir /opt/composer
RUN curl -sS https://getcomposer.org/installer | hhvm --php -- --install-dir=/opt/composer

# 安装应用
RUN rm -rf /var/www
ADD . /var/www
RUN cd /var/www && hhvm /opt/composer/composer.phar install

# 重新配置HHVM
ADD hhvm.prod.ini /etc/hhvm/site.ini

EXPOSE 80

使用首选的托管解决方案部署该镜像，已在AWS Elastic Beanstalk上测试：只需执行eb config; eb init; eb create; eb deploy（详见AWS Elastic Beanstalk文档）。

警告：如果使用AWS Elastic Beanstalk构建和部署镜像，它将在用于提供服务的实例上构建镜像，这可能导致内存问题。

禁用类型检查器

HHVM会自动运行类型检查器，这在开发中很有用，但假设您已在开发工作流和CI系统中运行它，在生产环境中运行它没有太多额外好处，且增加的内存使用在生产中可能代价高昂。要禁用它，在/etc/hhvm/site.ini中添加以下内容：

ini
hhvm.hack.lang.auto_typecheck=0
hhvm.hack.lang.look_for_typechecker=0

错误日志

错误会写入stderr，可通过docker logs my-container查看，或使用docker logs -f my_container实时监控。

版本/标签

• 特定版本的HHVM使用标签，例如3.8.0
• latest标签指向最新稳定版本
• 未来支持Proxygen的HHVM LTS版本将添加额外标签，例如3.9-lts-latest

关于 /var/www/public

大多数流行项目将index.php放在源代码树的顶层，应部署到/var/www/public——但遗憾的是，如今这通常被认为是不良实践，因为Web应用的根目录可公开访问容易意外暴露敏感内容（例如包含数据库凭据的配置文件或.git目录）。

如果您正在开发新项目，建议使用如下结构：

myapp/composer.json
myapp/composer.lock
myapp/vendor/
myapp/public/index.php
myapp/src/ # 如果不喜欢PSR-4
myapp/mynamespace/mysubnamespace/ # 如果喜欢PSR-4

然后将myapp/映射到/var/www而非/var/www/public。

如果原则上同意但不喜欢该名称，可在容器中通过/etc/hhvm/site.ini覆盖hhvm.server.source_root路径。

更多详情，请参见官方文档。

源码

https://github.com/hhvm/hhvm-docker