shinsenter/sulu

生产就绪的PHP/Sulu Docker镜像，包含自动Sulu安装程序。

• Docker Hub: [***]
• GitHub Packages: [***]
• 您还可以在此处找到其他流行PHP应用和框架的预构建Docker镜像：[***]

该Docker镜像提供Debian和Alpine两个版本。

镜像概述

本镜像基于shinsenter/php构建，支持通过环境变量轻松配置PHP和PHP-FPM设置，无需在修改配置时重新构建镜像。

镜像内置最新版本的Composer，可快速启动项目，无需额外安装步骤。

核心功能与特性

• 自动安装Sulu：挂载空目录时自动下载Sulu框架源码，快速初始化新项目
• 灵活配置：通过环境变量配置PHP和PHP-FPM参数，无需重新构建镜像
• 内置工具：包含最新Composer，简化依赖管理
• 多版本支持：提供Debian和Alpine两种基础镜像版本
• HTTPS支持：内置SSL证书配置，可替换为自定义证书
• 持续更新：每日构建以确保包含PHP、基础操作系统、Composer等的最新上游更新

使用场景

• 快速搭建Sulu项目开发环境
• 部署生产就绪的Sulu应用
• 需要灵活配置PHP参数的Sulu应用场景
• 对镜像大小有要求的环境（Alpine版本）

使用方法

查看基础文档

shinsenter/php镜像文档提供了更多自定义配置方法，可参考以适应您的项目需求。

创建新项目

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

创建步骤

1. 在主机创建空目录用于存放项目代码：

mkdir sulu

2. 运行容器并将空目录挂载为卷：

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

容器会检测到挂载到/var/www/html的空目录，并自动克隆框架源码到该目录。

使用现有项目

可将主机上的现有Sulu项目代码目录挂载到容器的/var/www/html目录。由于源码通过卷挂载，主机上的代码修改会实时同步到容器内，便于在容器中运行构建、测试等任务。

使用HTTPS

镜像内置用于本地测试的预生成SSL证书：

• /etc/ssl/site/server.crt
• /etc/ssl/site/server.key

如需为生产网站使用有效HTTPS证书，可通过以下方式替换默认证书。

使用Dockerfile

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

使用docker run

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

使用docker-compose

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

稳定镜像标签

GitHub仓库的发布版本不保证基于相同源码构建的Docker镜像始终完全一致。

我们每日构建新的Docker镜像，以确保包含PHP、基础操作系统、Composer等上游组件的最新更新。相同标签下的镜像会定期更新。

您可通过以下命令拉取shinsenter/sulu:latest镜像并标记为稳定版本（如your-repo/sulu:stable）：

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

之后可使用your-repo/sulu:stable作为基础镜像构建生产环境容器。

贡献

如果您觉得这些镜像有用，可通过PayPal***，或在GitHub提交issue。

您的支持有助于维护和改进这些镜像。

许可证

本项目基于GNU General Public License v3.0许可。

感谢您认可本项目的智力成果。如果您计划使用或基于本项目的任何想法进行开发，请给予适当的引用。

来自越南 🇻🇳 的爱。