Docker多阶段构建疑问：如何结合php-fpm-alpine与httpd-alpine

首先明确：多阶段构建的各个阶段完全独立，PHP阶段安装的依赖、配置不会自动复制到服务端阶段，必须通过COPY --from=<阶段名>命令显式指定要传递的文件或目录。

核心逻辑说明 #

每个FROM指令都会启动一个全新的镜像构建上下文，阶段之间没有默认的数据共享。多阶段构建的核心价值是通过"构建阶段"生成产物，再将产物复制到"运行阶段"以减小最终镜像体积，或者整合多个环境的必要组件。

完整Dockerfile示例（httpd + PHP-FPM单镜像） #

如果需要将两个服务打包到同一个镜像中运行，需要借助进程管理器（如supervisord）来同时启动httpd和php-fpm：

# 阶段1：配置PHP-FPM环境
FROM php:8.3-fpm-alpine as php

# 安装所需PHP扩展（根据业务需求调整）
RUN docker-php-ext-install pdo_mysql mysqli

# 复制本地PHP应用代码到容器
COPY ./src /var/www/html

# 调整应用目录权限，确保服务用户可访问
RUN chown -R www-data:www-data /var/www/html

# 阶段2：构建HTTPD环境并整合PHP-FPM
FROM httpd:alpine3.20 as server

# 安装supervisord用于管理多进程
RUN apk add --no-cache supervisor

# 从PHP阶段复制必要组件：
# 1. PHP-FPM二进制文件
# 2. PHP配置文件（含扩展配置）
# 3. PHP应用代码
COPY --from=php /usr/local/sbin/php-fpm /usr/local/sbin/php-fpm
COPY --from=php /usr/local/etc/php /usr/local/etc/php
COPY --from=php /var/www/html /var/www/html

# 复制自定义HTTPD配置（需配置反向代理到PHP-FPM）
# 配置示例：在httpd.conf中添加 ProxyPassMatch ^/(.*\.php)$ fcgi://127.0.0.1:9000/var/www/html/$1
COPY ./conf/httpd.conf /usr/local/apache2/conf/httpd.conf

# 复制supervisord配置文件
COPY ./conf/supervisord.conf /etc/supervisord.conf

# 启动supervisord管理两个服务
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisord.conf"]

配套配置文件示例 #

supervisord.conf（进程管理配置）

[supervisord]
nodaemon=true

[program:httpd]
command=/usr/local/apache2/bin/httpd -D FOREGROUND
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

[program:php-fpm]
command=/usr/local/sbin/php-fpm -F
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

关键注意事项 #

• 显式复制必要组件：PHP阶段的所有依赖、二进制文件、配置都需要手动复制到server阶段，否则server镜像中没有PHP-FPM的运行环境。
• 进程管理：单镜像运行多服务必须用进程管理器（如supervisord、runit），否则只能启动一个服务。
• 反向代理配置：httpd必须配置反向代理规则，将PHP请求转发到本地9000端口（PHP-FPM默认监听端口）。
• 权限一致性：确保应用目录的权限在两个阶段中保持一致，避免访问报错。

替代方案（容器编排） #

如果不需要单镜像部署，推荐用Docker Compose分别运行httpd和php-fpm容器，这种方式更符合容器"单进程"设计原则，维护更简单：

• 单独编写httpd和php-fpm的Dockerfile
• 通过Compose配置网络，让httpd容器能访问php-fpm容器
• 共享应用代码目录（通过卷挂载）

内容的提问来源于stack exchange，提问作者Mega Aleksandar