craftcms/nginx

Craft Docker镜像

这些镜像为基于Docker的Craft CMS部署提供起点，具有离散、轻量级特性，且预配置满足Craft在生产和开发环境中的需求。

镜像类型

提供三种主要镜像类型以适应不同应用场景：php-fpm、nginx和cli。每种镜像允许开发者选择PHP版本（例如craftcms/nginx:7.4）。

每种镜像和PHP版本还提供-dev变体，已安装Xdebug，适用于本地开发（例如craftcms/php-fpm:7.4-dev）。不含-dev的镜像为生产环境版本。

注意：本地开发不强制使用-dev镜像，其提供Xdebug仅为简化调试过程。

php-fpm

php-fpm镜像作为基础镜像（也用于nginx镜像），需自行配置Web服务器。

nginx

nginx镜像适用于典型安装，集成Nginx服务器并配置用于Craft CMS和php-fpm。

cli

cli镜像用于运行队列、迁移等命令行任务，不暴露HTTP/S或PHP-FPM端口。

使用方法

主要镜像类型包括：php-fpm（处理Web应用）和cli（运行队列及其他Craft命令行任务）。

注意：我们未提供Web服务器镜像，因选择取决于项目需求，但提供了如何将Nginx或Caddy与php-fpm镜像配合使用的示例。

多阶段构建示例

以下示例使用Docker多阶段构建在单独层中安装Composer依赖，再复制到最终镜像。

dockerfile
# 使用多阶段构建安装依赖
FROM composer:1 as vendor
COPY composer.json composer.json
COPY composer.lock composer.lock
RUN composer install --ignore-platform-reqs --no-interaction --prefer-dist

FROM craftcms/php-fpm:7.4

# 以www-data用户复制文件（用户和组）
COPY --chown=www-data:www-data --from=vendor /app/vendor/ /app/vendor/
COPY --chown=www-data:www-data . .

以下示例使用craftcms/nginx仓库并安装mysql-client工具，以支持从Craft CMS控制面板进行备份。

dockerfile
# Composer依赖
FROM composer:1 as vendor
COPY composer.json composer.json
COPY composer.lock composer.lock
RUN composer install --ignore-platform-reqs --no-interaction --prefer-dist

FROM craftcms/nginx:7.4

# 切换到root用户安装mysql工具
USER root
RUN apk add --no-cache mysql-client
USER www-data

# 以www-data用户复制文件（用户和组）
COPY --chown=www-data:www-data --from=vendor /app/vendor/ /app/vendor/
COPY --chown=www-data:www-data . .

权限

镜像设计为以www-data用户运行，该用户拥有镜像的/app目录。以非root用户运行是Docker最佳实践，尤其是将容器镜像部署到生产环境时。

注意：可使用USER root指令切换回root用户以安装所需额外包。

本地使用Docker Compose运行

若项目部署到基于Docker的环境（如AWS ECS），建议本地运行Docker。以下Docker Compose文件将设置包含以下服务的本地环境：

1. web：处理PHP和Nginx运行
2. mysql：存储内容数据
3. console：本地运行队列
4. redis：处理队列和缓存

yaml
version: "3.6"
services:
  web:
    image: craftcms/nginx:7.4-dev
    volumes:
      - .:/app
    env_file: .env
  console:
    image: craftcms/cli:7.4-dev
    volumes:
      - .:/app
    env_file: .env
    command: ["./craft", "queue/listen"]
  mysql:
    image: mysql:8.0
    ports:
      - 3306:3306
    environment:
      MYSQL_ROOT_PASSWORD: SuperPassword123456!
      MYSQL_DATABASE: dev_craftcms
      MYSQL_USER: craftcms
      MYSQL_PASSWORD: SecretPassword
    volumes:
      - db_data:/var/lib/mysql
  redis:
    image: redis:5-alpine
    ports:
      - 6379:6379
volumes:
  db_data:

安装扩展

该镜像基于https://hub.docker.com/_/php%EF%BC%88Alpine Linux），因此可使用所有工具安装PHP扩展。安装扩展需切换到root用户。以下示例切换到root用户为PHP 7.4安装sockets扩展，安装后切换回www-data：

dockerfile
FROM craftcms/php-fpm:7.4

# 切换到root用户
USER root
RUN docker-php-ext-install sockets
USER www-data

# 以www-data用户复制文件（用户和组）
COPY --chown=www-data:www-data --from=vendor /app/vendor/ /app/vendor/
COPY --chown=www-data:www-data . .

自定义PHP设置

php-fpm或cli镜像可通过设置环境变量自定义部分PHP配置。

以下示例将PHP内存限制设置为512M（默认256M）：

yaml
version: "3.6"
services:
  php-fpm:
    image: craftcms/php-fpm:7.4-dev
    volumes:
      - .:/app
    env_file: .env
    environment:
      PHP_MEMORY_LIMIT: 512M
  # ...

可自定义设置