shinsenter/sulu

shinsenter/sulu

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

• Docker Hub: https://hub.docker.com/r/shinsenter/sulu
• GitHub Packages: [***]
• 您还可以在此处找到其他流行PHP应用和框架的预构建Docker镜像：https://hub.docker.com/u/shinsenter

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

镜像概述

本镜像基于https://hub.docker.com/r/shinsenter/php%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E8%BD%BB%E6%9D%BE%E9%85%8D%E7%BD%AEPHP%E5%92%8CPHP-FPM%E8%AE%BE%E7%BD%AE%EF%BC%8C%E6%97%A0%E9%9C%80%E5%9C%A8%E4%BF%AE%E6%94%B9%E9%85%8D%E7%BD%AE%E6%97%B6%E9%87%8D%E6%96%B0%E6%9E%84%E5%BB%BA%E9%95%9C%E5%83%8F%E3%80%82

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

核心功能与特性

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

使用场景

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

使用方法

查看基础文档

https://hub.docker.com/r/shinsenter/php%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E6%8F%90%E4%BE%9B%E4%BA%86%E6%9B%B4%E5%A4%9A%E8%87%AA%E5%AE%9A%E4%B9%89%E9%85%8D%E7%BD%AE%E6%96%B9%E6%B3%95%EF%BC%8C%E5%8F%AF%E5%8F%82%E8%80%83%E4%BB%A5%E9%80%82%E5%BA%94%E6%82%A8%E7%9A%84%E9%A1%B9%E7%9B%AE%E9%9C%80%E6%B1%82%E3%80%82

创建新项目

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

创建步骤

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

shell
mkdir sulu

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

shell
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

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

shell
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

yaml
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）：

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

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

贡献

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

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

许可证

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

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

来自越南 🇻🇳 的爱。