roadiz/php82-fpm-alpine

roadiz/php82-fpm-alpine

用于运行Roadiz应用、定时任务（cron-jobs）和工作进程（workers）的基础php-fpm镜像

本镜像不提供Nginx服务器，但包含dcron和多种图像处理二进制文件。它监听9000端口，需与独立的Nginx容器配合使用。

请确保在项目根目录使用.dockerignore文件，避免包含已有的缓存文件或构建时的依赖（如node_modules）。

构建项目Docker镜像前，请准备好项目源码：

• 执行 composer install -o
• 将任何开发或用户文件路径添加到.dockerignore中

单容器单进程

本镜像设计为每次仅运行一个进程。如果项目需要运行定时任务（cron jobs）或工作进程（Symfony Messenger），应为每个进程使用单独的容器，并覆盖容器的入口点（仅主应用容器应启动docker-php-entrypoint）。

镜像构建示例

在Roadiz/Symfony项目中创建docker/php-fpm-alpine/Dockerfile文件。

您可以通过覆盖以下文件来自定义镜像：

• docker/php-fpm-alpine/php.prod.ini
• docker/php-fpm-alpine/crontab.txt
• docker/php-fpm-alpine/docker-php-entrypoint

Dockerfile
# 文件：docker/php-fpm-alpine/Dockerfile
FROM roadiz/php82-fpm-alpine:latest
MAINTAINER Ambroise Maupate <ambroise@rezo-zero.com>
ARG USER_UID=1000

RUN usermod -u ${USER_UID} www-data \
    && groupmod -g ${USER_UID} www-data

# 复制自定义配置文件
COPY docker/php-fpm-alpine/php.prod.ini /usr/local/etc/php/php.ini
COPY docker/php-fpm-alpine/crontab.txt /crontab.txt
COPY docker/php-fpm-alpine/docker-php-entrypoint /usr/local/bin/docker-php-entrypoint

# 复制项目文件
COPY --chown=www-data:www-data . /var/www/html/

RUN ln -s /var/www/html/bin/console /usr/local/bin/console \
    && /usr/bin/crontab -u www-data /crontab.txt \
    && chmod +x /usr/local/bin/docker-php-entrypoint \
    && chown -R www-data:www-data /var/www/html/

# 定义持久化数据卷目录
VOLUME /var/www/html/config/jwt \
       /var/www/html/config/secrets \
       /var/www/html/public/files \
       /var/www/html/public/assets \
       /var/www/html/var/files \
       /var/www/html/var/secret

使用场景

• 带默认入口点的主应用容器（运行php-fpm）

yaml
app:
    build:
        dockerfile: ./docker/php-fpm-alpine
        context: .
        args:
            USER_UID: ${USER_UID}
    restart: always
    depends_on:
        - db
        - redis
    volumes:
        # 为持久化数据提供命名卷
        - app_jwt_data:/var/www/html/config/jwt
        - app_file_data:/var/www/html/public/files
        - app_assets_data:/var/www/html/public/assets
        - app_private_file_data:/var/www/html/var/files
        - app_secret_data:/var/www/html/config/secrets
    networks:
        - default
    environment:
        APP_ENV: ${APP_ENV}
        APP_RUNTIME_ENV: ${APP_RUNTIME_ENV}
        APP_DEBUG: ${APP_DEBUG}

• 通过覆盖容器入口点支持定时任务（crontab）：

yaml
cron:
    extends: app
    init: true
    entrypoint: [ "crond", "-f", "-L", "15" ]
    restart: always

• 通过覆盖容器入口点运行Symfony Messenger工作进程：

yaml
worker:
    extends: app
    deploy:
        replicas: 1
    entrypoint: [ "php", "/var/www/html/***/console", "messenger:consume", "async", "--time-limit=1800" ]
    restart: always