brettt89/silverstripe-web

Silverstripe Docker 镜像文档

快速参考

• 问题反馈地址：
  https://github.com/brettt89/silverstripe-docker/issues

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  amd64、arm64v8

支持的标签及对应的 Dockerfile 链接

注意：本镜像描述超出 Hub 的 25000 字符限制，因此“支持的标签”列表已被精简。更多信息请参见 docker/hub-beta-feedback#238。

• 详见 GitHub README 中的“https://github.com/brettt89/silverstripe-docker/blob/master/README.md#supported-tags-and-respective-dockerfile-links%E2%80%9D

什么是 Silverstripe CMS

Silverstripe CMS 是一款免费开源的内容管理系统（CMS）和框架，用于创建和维护网站及 Web 应用。它提供开箱即用的基于 Web 的管理面板，能让用户对网站部分内容进行修改，其中就包含 WYSIWYG 网站编辑器。该软件的核心是 Silverstripe Framework，这是一个 PHP Web 应用框架。

[***]

!https://raw.githubusercontent.com/brettt89/silverstripe-docker/master/docs/logo.png "Silverstripe CMS 标志"

如何使用本镜像

基本用法

运行带有 Apache 的 brettt89/silverstripe-web 镜像非常简单，命令如下：

shell
$ docker run -d \
  --volume $PWD:/app \
  brettt89/silverstripe-web:8.1-apache

在 PHP 项目中创建 Dockerfile

Dockerfile
FROM brettt89/silverstripe-web:8.1-apache
ENV DOCUMENT_ROOT /usr/src/myapp

COPY . $DOCUMENT_ROOT
WORKDIR $DOCUMENT_ROOT

在 PHP 项目中创建 docker-compose.yml

yaml
version: "3.8"
services:
  silverstripe:
    image: brettt89/silverstripe-web:8.1-apache
    volumes:
       - .:/var/www/html
    depends_on:
       - database
    environment:
       - DOCUMENT_ROOT=/var/www/html/public
       - SS_TRUSTED_PROXY_IPS=*
       - SS_ENVIRONMENT_TYPE=dev
       - SS_DATABASE_SERVER=database
       - SS_DATABASE_NAME=SS_mysite
       - SS_DATABASE_USERNAME=root
       - SS_DATABASE_PASSWORD=
       - SS_DEFAULT_ADMIN_USERNAME=admin
       - SS_DEFAULT_ADMIN_PASSWORD=password

  database:
    image: mysql:5.7
    environment:
       - MYSQL_ALLOW_EMPTY_PASSWORD=yes
    volumes:
       - db-data:/var/lib/mysql
volumes:
     db-data:

环境变量

环境变量可用于辅助配置容器。以下是可用于自定义容器的现有环境变量：

• DOCUMENT_ROOT：Apache 的文档根目录位置。（对于 SilverStripe 4 安装，您需要将其设置为 /public 目录，例如 /var/www/html/public）

如何安装更多 PHP 扩展

许多扩展已预先编译到镜像中，因此在费力编译更多扩展之前，建议先检查 php -m 或 php -i 的输出。

我们提供了辅助脚本 https://hub.docker.com/r/mlocati/php-extension-installer%EF%BC%8C%E4%BB%A5%E4%BE%BF%E6%9B%B4%E8%BD%BB%E6%9D%BE%E5%9C%B0%E5%AE%89%E8%A3%85 PHP 扩展。

Dockerfile
FROM brettt89/silverstripe-web:8.1-apache
RUN install-php-extensions xdebug

默认扩展

以下扩展是在默认 PHP 镜像基础上额外安装的：

• bcmath
• mysqli
• pdo
• pdo_mysql
• intl
• ldap
• gd
• soap
• tidy
• xsl
• zip
• exif
• gmp

镜像变体

php 镜像有多种版本，每种版本都设计用于特定场景。

某些标签可能包含 bullseye 或 buster 等名称，这些是 Debian 的发行版代号，表示该镜像所基于的 Debian 版本。如果您的镜像需要安装除自带软件之外的其他包，建议明确指定这些代号，以减少 Debian 新版本发布时可能出现的问题。

brettt89/silverstripe-web:<version>-apache

此镜像包含 Debian 的 Apache httpd 以及 PHP（作为 mod_php），默认使用 mpm_prefork。有关使用示例，请参见基本用法。

brettt89/silverstripe-web:<version>-cli

此变体包含 PHP CLI 工具及默认模块。如果您需要 Web 服务器，此镜像可能不适用。它设计用于临时容器（挂载源代码并启动容器以运行应用）以及作为构建其他镜像的基础。

它也是唯一包含（不推荐使用的）php-cgi 二进制文件的变体，这对于某些工具（如 https://github.com/php-pm/php-pm%EF%BC%89%E5%8F%AF%E8%83%BD%E6%98%AF%E5%BF%85%E9%9C%80%E7%9A%84%E3%80%82

注意：所有 php 变体都包含 PHP CLI（/usr/local/bin/php）。

brettt89/silverstripe-web:<version>-fpm

此变体包含 PHP - FPM，它是 PHP 的 FastCGI 实现。有关 PHP - FPM 的更多信息，请参见 PHP - FPM 网站。

要使用此镜像变体，需要某种反向代理（如 NGINX、Apache 或其他支持 FastCGI 协议的工具）。

一些可能有用的资源：

• PHP-FPM.org
• https://gist.github.com/md5/d9206eacb5a0ff5d6be0
• Pascal Landau 的详细文章
• Stack Overflow 讨论
• Apache httpd Wiki 示例

brettt89/silverstripe-web:<version>-alpine

此镜像基于流行的 Alpine Linux 项目，可在 https://hub.docker.com/_/alpine 中获取。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是首要考虑因素时，此变体非常有用。需要注意的主要问题是它使用 musl libc 而非 glibc 等，因此软件可能会因 libc 要求/假设的深度而遇到问题。有关可能出现的问题以及使用基于 Alpine 的镜像的优缺点的更多讨论，请参见 此 Hacker News 评论线程。

为最小化镜像大小，基于 Alpine 的镜像通常不包含额外的相关工具（如 git 或 bash）。将此镜像用作基础时，请在您自己的 Dockerfile 中添加所需的工具（如果不熟悉如何安装包，请参见 https://hub.docker.com/_/alpine/ 中的示例）。

许可证

查看此镜像中包含的软件的 许可证信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。

问题反馈

如果您对此镜像有任何问题或疑问，请通过 https://github.com/brettt89/silverstripe-web/issues 与我们联系。

贡献

欢迎您贡献新功能、修复或更新，无论大小；我们始终很高兴收到拉取请求，并会尽力尽快处理。

在开始编码之前，我们建议通过 https://github.com/brettt89/silverstripe-web/issues 讨论您的计划，特别是对于更宏大的贡献。这使其他贡献者有机会为您指明正确的方向，提供对您设计的反馈，并帮助您了解是否有其他人正在从事相同的工作。