craftcms/cli

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镜像适用于典型安装，包含为Craft CMS配置的Nginx服务器和php-fpm。

cli

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

使用方法

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

注意：我们不提供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 . .

Nginx镜像示例

以下示例使用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:

安装扩展

该镜像基于官方Docker PHP FPM镜像（Alpine Linux），因此可使用相关工具安装PHP扩展。安装扩展需切换到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
  # ...

可自定义设置