shinsenter/hyperf Docker镜像文档

镜像概述和主要用途

shinsenter/hyperf是基于PHP和Hyperf框架的生产就绪Docker镜像，内置自动Hyperf安装器，旨在简化Hyperf项目的部署与开发流程。该镜像支持快速搭建新项目及部署现有项目，无需复杂配置即可投入生产环境使用。

• Docker Hub地址：[***]
• GitHub Packages地址：[***]
• 更多PHP应用框架镜像：[***]

镜像提供Debian和Alpine两种基础系统版本，满足不同场景需求。

核心功能和特性

• 自动Hyperf安装：挂载空目录时自动拉取Hyperf框架源码，快速初始化新项目
• 灵活配置：通过环境变量配置PHP及PHP-FPM参数，无需重建镜像即可调整设置
• 内置Composer：预安装最新版Composer，支持项目依赖管理及快速构建
• 多基础系统：提供Debian和Alpine两种基础版本，兼顾兼容性与轻量需求
• HTTPS支持：内置测试SSL证书，可替换为生产环境证书实现HTTPS部署

使用场景和适用范围

• 新建Hyperf项目：通过挂载空目录自动完成框架安装，快速启动项目开发
• 现有项目部署：挂载本地代码目录，直接运行现有Hyperf应用，支持开发与生产环境
• 环境一致性：统一开发、测试和生产环境配置，减少"本地正常线上异常"问题
• 生产环境就绪：定期更新基础组件（PHP、系统依赖、Composer等），确保安全性与稳定性

详细使用方法和配置说明

新建项目

当挂载空目录至容器/var/www/html时，镜像将自动下载Hyperf框架源码，完成项目初始化。

操作步骤

1. 在主机创建空目录（例如hyperf）：

   mkdir hyperf
   

2. 运行容器并挂载该目录：

   docker run -p 80:80 -p 443:443 -p 443:443/udp \
       -v ./hyperf:/var/www/html \
       shinsenter/hyperf:latest
   

容器将检测到空目录并自动克隆Hyperf框架源码至/var/www/html（即主机./hyperf目录）。

使用现有项目

将主机现有Hyperf项目代码目录挂载至容器/var/www/html，即可直接运行应用。由于采用卷挂载，主机代码变更会实时同步至容器，支持开发调试与生产部署。

示例（docker run）：

docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v /path/to/your/hyperf/project:/var/www/html \
    shinsenter/hyperf:latest

配置HTTPS

镜像内置测试SSL证书（位于/etc/ssl/site/server.crt和/etc/ssl/site/server.key），适用于本地测试。生产环境需替换为有效证书，可通过以下方式实现：

方法1：通过Dockerfile构建

FROM shinsenter/hyperf:latest

# 复制生产证书覆盖默认证书
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

# 可选：复制项目代码（若不通过卷挂载）
# ADD --chown=$APP_USER:$APP_GROUP ./hyperf/ /var/www/html/

方法2：通过docker run挂载证书

docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./hyperf:/var/www/html \
    -v ./my_domain.crt:/etc/ssl/site/server.crt \
    -v ./my_domain.key:/etc/ssl/site/server.key \
    shinsenter/hyperf:latest

方法3：通过docker-compose配置

services:
  web:
    image: shinsenter/hyperf:latest
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./hyperf:/var/www/html  # 挂载项目代码
      - ./my_domain.crt:/etc/ssl/site/server.crt  # 挂载SSL证书
      - ./my_domain.key:/etc/ssl/site/server.key  # 挂载SSL密钥

稳定镜像标签管理

该镜像每日更新以同步上游组件（PHP、系统依赖、Composer等），相同标签（如latest）可能对应不同镜像版本。为确保生产环境稳定性，建议拉取最新镜像后标记为自定义稳定标签：

# 拉取最新镜像
docker pull shinsenter/hyperf:latest

# 标记为稳定版本
docker tag shinsenter/hyperf:latest your-repo/hyperf:stable

# 推送至私有仓库（可选）
docker push your-repo/hyperf:stable

后续生产环境可直接使用your-repo/hyperf:stable作为基础镜像，避免版本波动影响。

贡献

若发现该镜像对您的工作有帮助，欢迎通过PayPal***，或在GitHub提交issue反馈问题。您的支持将帮助我们持续维护和改进该项目。

许可证

本项目基于GNU General Public License v3.0许可。使用或借鉴本项目时，请给予适当引用。

来自越南 🇻🇳 的爱心贡献。