moderntribe/squareone-php

SquareOne Docker镜像

SquareOne项目的基础Docker镜像。https://hub.docker.com/r/moderntribe/squareone-php%E3%80%82

PHP

镜像名称：moderntribe/squareone-php

支持的标签

• latest：最新的Dockerfile版本，使用最新的PHP版本（当前为8.0），基于master分支构建。
• 80-latest：PHP 8.0的最新Dockerfile版本，基于master分支构建。
• 80-<x.y.z> 或 80-<x.y>：PHP 8.0的特定Dockerfile版本，基于匹配的标签构建。
• 74-latest：PHP 7.4的最新Dockerfile版本，基于master分支构建。
• 74-<x.y.z> 或 74-<x.y>：PHP 7.4的特定Dockerfile版本，基于匹配的标签构建。
• 建议使用次要版本，以便执行docker pull时能继续接收更新，例如moderntribe/squareone-php:80-1.0、moderntribe/squareone-php:74-2.1。

添加新版本

• 为新版本创建目录，例如/php/8.1/

• 在该目录中创建Dockerfile和所有支持文件。

• 在Docker Hub的moderntribe/squareone-php上添加针对该PHP版本的自动构建配置。以下是创建8.0版本构建规则的示例：

  源类型	源	Docker标签	Dockerfile位置	构建上下文
  分支	master	80-latest	Dockerfile	/php/8.0/
  标签	/^php80-([0-9.]+)$/	80-{\1}	Dockerfile	/php/8.0/

标记前测试发布

修改Dockerfile后，应在本地构建并测试，然后再发布。

• 更新PHP扩展安装器镜像：docker pull docker.xuanyuan.run/mlocati/php-extension-installer
• 进入修改的Dockerfile所在文件夹
• 构建并标记自定义名称的镜像：docker build -t moderntribe/squareone-php:$version-test .，例如docker build -t moderntribe/squareone-php:74-3.0.6-test .
• 在https://github.com/moderntribe/square-one%E4%B8%AD%E6%B5%8B%E8%AF%95%EF%BC%8C%E4%B8%B4%E6%97%B6%E7%BC%96%E8%BE%91https://github.com/moderntribe/square-one/blob/main/dev/docker/docker-compose.yml#L30%E5%B9%B6%E6%9B%B4%E6%96%B0%60x-php%60%E9%95%9C%E5%83%8F%E3%80%82

yaml
x-php: &php
  # 原始镜像
  # image: moderntribe/squareone-php:74-3.0
  # 测试镜像
  image: docker.xuanyuan.run/moderntribe/squareone-php:74-3.0.6-test

• 运行so start并验证项目是否成功加载。

标记发布

• 提交并推送更新到仓库。这将触发master分支上*-latest标签的自动构建。
• 标记版本，前缀为受影响的PHP版本，后缀为发布版本。例如，PHP 8.0的第一个构建版本标记为php80-1.0.0。
• 标签应遵循语义化版本：php<version>-<major>.<minor>.<patch>。<major>版本引入破坏性变更，<minor>版本添加功能并修复bug，<patch>版本仅修复bug。

下游入口点脚本

在下游使用此仓库的镜像时，可以在docker-entrypoint.d文件夹中添加自定义脚本。

该文件夹中的所有脚本将被复制并通过https://manpages.ubuntu.com/manpages/trusty/man8/run-parts.8.html%E8%87%AA%E5%8A%A8%E6%89%A7%E8%A1%8C%E3%80%82

注意脚本命名限制：必须完全由ASCII大小写字母、ASCII数字、ASCII下划线和ASCII连字符组成，因此不要使用.sh扩展名。