shinsenter/spiral

shinsenter/spiral

镜像概述和主要用途

shinsenter/spiral是生产就绪的PHP/Spiral Docker镜像，内置自动Spiral安装器，支持Debian和Alpine两种版本。该镜像设计目标是通过环境变量轻松配置PHP和PHP-FPM设置，无需重建镜像即可修改配置，同时包含最新版Composer，便于快速启动Spiral项目。

• Docker Hub: https://hub.docker.com/r/shinsenter/spiral
• GitHub Packages: [***]
• 更多预构建PHP应用和框架镜像：https://hub.docker.com/u/shinsenter

核心功能和特性

• 灵活配置：通过环境变量配置PHP和PHP-FPM设置，无需重建镜像
• 快速启动：内置最新版Composer，无需额外安装即可启动项目
• 自动安装：挂载空目录时自动下载Spiral框架源代码，快速引导新项目
• 多版本支持：提供Debian和Alpine两种基础系统版本
• HTTPS支持：包含预生成SSL证书用于本地测试，支持替换为生产环境证书
• 持续更新：每日构建以同步PHP、基础系统、Composer等上游最新更新

使用场景和适用范围

• 快速初始化新的Spiral框架项目
• 生产环境部署Spiral应用程序
• 需要频繁调整PHP配置而不想重建镜像的场景
• 本地开发和测试Spiral应用

详细的使用方法和配置说明

创建新项目

当挂载空目录到容器时，镜像会自动下载Spiral框架源代码，快速完成项目引导。

创建步骤

1. 在主机创建空项目目录：

   shell
   mkdir spiral
   

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

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

容器会检测到空目录并自动克隆框架源代码到挂载目录。

使用现有项目

将主机上的现有项目代码挂载到容器的/var/www/html目录即可，主机文件更改会实时同步到容器内。

配置HTTPS

镜像包含预生成的SSL证书用于本地测试，生产环境可替换为自定义证书。

使用Dockerfile替换证书

Dockerfile
FROM shinsenter/spiral: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 ./spiral/ /var/www/html/

使用docker run命令替换证书

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

使用docker-compose配置证书

yml
services:
  web:
    image: shinsenter/spiral:latest
    volumes:
      - ./spiral:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

稳定镜像标签

由于每日构建会更新PHP、基础系统和Composer等组件，相同标签的镜像内容可能变化。建议将最新镜像标记为稳定版本用于生产：

shell
docker pull shinsenter/spiral:latest
docker tag  shinsenter/spiral:latest your-repo/spiral:stable
docker push your-repo/spiral:stable

之后使用your-repo/spiral:stable作为生产环境基础镜像。

贡献

如果发现这些镜像有用，可通过******，或在GitHub提交issue。您的支持有助于维护和改进这些镜像。

许可

本项目采用GNU General Public License v3.0许可。使用或基于本项目思想构建时，请给予适当引用。

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