Apache + PHP-FPM 镜像文档

镜像概述

Apache + PHP-FPM是一个集成Apache Web服务器与PHP-FPM的Docker镜像，专为在反向Nginx代理环境下部署WordPress、OpenCart、Magento等PHP应用设计。基于Ubuntu:rolling或Debian:stable构建，PHP包来自Ondrej PPA仓库，Apache包来自维护者专属仓库。支持挂载/etc/php和/etc/apache2目录，首次运行时若挂载目录为空会自动填充默认配置文件。

核心功能与特性

• 优化的Apache版本：基于Ubuntu 20.10 Groovy Apache2包进行更新重建与回溯移植，提升稳定性
• 性能优化：Apache通过-O3 -flto编译选项优化，提升运行效率
• 安全协议支持：链接OpenSSL 1.1.1h，支持ALPN协商和TLS 1.3协议
• 邮件服务集成：内置nullmailer，方便PHP应用（如WordPress）发送邮件
• 开发工具：预装最新版Composer，支持PHP项目依赖管理
• 自动配置填充：首次运行时，/etc/apache2、/etc/php和/etc/nullmailer目录为空会自动生成默认配置
• 丰富PHP模块：包含Ondrej PPA仓库中的大部分PHP扩展模块
• 持续更新机制：每日自动重建镜像，确保组件为最新版本
• 配置自动重载：启用mod_ssl时每日自动重载配置（如更新Let's Encrypt证书）

使用场景与适用范围

适用于各类PHP Web应用的部署场景，包括但不限于：

• 内容管理系统：WordPress、Drupal、Joomla
• 电商平台：OpenCart、Magento、PrestaShop
• 自定义PHP Web应用开发与测试环境
• 需要多PHP版本支持的复杂应用架构

环境变量配置

镜像标签说明

Ubuntu基础镜像系列

• eilander/apache-phpfpm:latest：最新稳定版（默认PHP版本）
• eilander/apache-phpfpm:multi：支持多PHP版本的集成版
• eilander/apache-phpfpm:5.6：PHP 5.6版本
• eilander/apache-phpfpm:7.2：PHP 7.2版本
• eilander/apache-phpfpm:7.4：PHP 7.4版本
• eilander/apache-phpfpm:8.0：PHP 8.0版本

Debian基础镜像系列

• eilander/apache-phpfpm:deb-latest：Debian最新稳定版
• eilander/apache-phpfpm:deb-multi：Debian多PHP版本集成版
• eilander/apache-phpfpm:deb-5.6：Debian PHP 5.6版本
• eilander/apache-phpfpm:deb-7.2：Debian PHP 7.2版本
• eilander/apache-phpfpm:deb-7.4：Debian PHP 7.4版本
• eilander/apache-phpfpm:deb-8.0：Debian PHP 8.0版本

使用方法与部署示例

基本运行命令

bash
docker run -d \
  --name apache-phpfpm \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/php/app:/var/www/html \
  -v /path/to/apache-config:/etc/apache2 \
  -v /path/to/php-config:/etc/php \
  -e TZ=Asia/Shanghai \
  -e A2ENMOD=rewrite,ssl \
  -e CACHE=yes \
  eilander/apache-phpfpm:latest

Docker Compose配置示例

yaml
version: '3'
services:
  apache-phpfpm:
    image: eilander/apache-phpfpm:latest
    container_name: apache-phpfpm
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./wordpress:/var/www/html  # PHP应用目录
      - ./apache-config:/etc/apache2  # Apache配置目录
      - ./php-config:/etc/php  # PHP配置目录
      - ./ssl-certs:/etc/ssl/certs  # SSL证书目录
    environment:
      - TZ=Asia/Shanghai
      - A2ENMOD=rewrite,ssl
      - CACHE=yes
    restart: unless-stopped

注意事项

• 首次运行时，空挂载目录会自动生成默认配置，建议首次运行后备份配置文件
• 启用HTTPS需配置SSL证书（如Let's Encrypt），mod_ssl模块每日自动重载配置以更新证书
• 多PHP版本模式（:multi标签）需在虚拟主机配置中手动指定PHP版本处理器，配置示例可参考***仓库
• 挂载/etc/apache2目录后，A2ENMOD等模块操作会持久化保存