shinsenter/flarum

shinsenter/flarum

镜像概述和主要用途

shinsenter/flarum是基于PHP的Flarum生产就绪Docker镜像，内置自动Flarum安装程序。该镜像支持通过环境变量轻松配置PHP和PHP-FPM设置，无需在修改配置时重建镜像。镜像包含最新版本的Composer，可快速启动项目，无需额外安装步骤。提供Debian和Alpine两种基础版本，满足不同环境需求。

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

核心功能和特性

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

使用场景和适用范围

• 快速创建新的Flarum项目
• 部署现有Flarum项目到开发或生产环境
• 需要灵活配置PHP环境的Flarum应用部署
• 对镜像大小有要求的场景（Alpine版本）

详细使用方法和配置说明

创建新项目

当挂载空目录到容器时，镜像会自动下载Flarum源代码，实现项目快速引导。

步骤

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

   shell
   mkdir flarum
   

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

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

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

使用现有项目

将主机上的现有Flarum项目目录挂载到容器的/var/www/html目录即可使用。主机上的代码更改会实时反映到容器内，便于在容器中执行构建、测试等操作。

使用HTTPS

镜像内置测试用SSL证书（路径：/etc/ssl/site/server.crt和/etc/ssl/site/server.key），生产环境可替换为自定义证书。

使用Dockerfile

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

使用docker run命令

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

使用docker-compose

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

稳定镜像标签

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

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

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

# 推送到私有仓库
docker push your-repo/flarum:stable

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

贡献

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

许可证

本项目采用GNU General Public License v3.0许可证。使用或借鉴本项目的想法时，请给予适当的署名。

来自越南 🇻🇳 的爱心。