craftcms/php-fpm

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镜像），需自备服务器。

Nginx

nginx镜像适用于典型安装，包含为Craft CMS和php-fpm配置的Nginx服务器。

cli

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

使用

主要有两种镜像类型：php-fpm用于处理Web应用，cli用于运行队列和其他Craft 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 . .

以下示例使用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用户。以下示例切换到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
  # ...

可自定义设置