Drupal专用Apache/PHP容器镜像文档

镜像概述和主要用途

本镜像为一个预配置的独立容器，集成了Apache Web服务器和PHP运行环境，专门针对Drupal内容管理系统进行优化。容器内已预装运行Drupal所需的全部必要软件包、PHP扩展及依赖项，可直接作为Drupal应用的基础运行环境，无需额外手动配置底层服务。

核心功能和特性

• 完整运行环境：集成Apache和PHP，无需单独部署Web服务器和PHP解释器
• Drupal专用优化：预安装Drupal核心依赖的PHP扩展（如mysqli、gd、curl、mbstring、xml、zip等）
• 即开即用：包含基础Apache配置，支持.htaccess文件解析，符合Drupal URL重写需求
• 轻量级设计：基于精简基础镜像，减少冗余组件，提升运行效率
• 版本兼容性：兼容主流Drupal版本（具体版本需参考镜像标签说明）

使用场景和适用范围

• Drupal开发环境：快速搭建本地开发环境，避免环境配置差异问题
• 测试环境部署：用于Drupal模块测试、版本升级验证等场景
• 生产环境基础：作为Drupal生产部署的基础容器，配合数据库容器构建完整应用栈
• 教学和演示：快速展示Drupal功能的临时环境

详细使用方法和配置说明

基本运行方法

使用docker run命令启动容器：

bash
docker run -d -p 80:80 --name drupal-apache-php \
  -v /path/to/drupal/code:/var/www/html \
  [镜像名称]:[标签]

参数说明：

• -p 80:80：将容器的80端口映射到主机80端口（可根据需要修改主机端口）
• --name drupal-apache-php：指定容器名称
• -v /path/to/drupal/code:/var/www/html：挂载本地Drupal代码目录到容器内Apache网站根目录

Docker Compose配置示例

推荐配合数据库容器使用，以下是典型的docker-compose.yml配置：

yaml
version: '3'

services:
  web:
    image: [镜像名称]:[标签]
    ports:
      - "80:80"
    volumes:
      - ./drupal:/var/www/html
    depends_on:
      - db
    environment:
      - PHP_MEMORY_LIMIT=256M
      - APACHE_DOCUMENT_ROOT=/var/www/html/web  # 若使用Drupal 8+的目录结构
    restart: always

  db:
    image: mysql:5.7
    environment:
      - MYSQL_DATABASE=drupal
      - MYSQL_USER=drupaluser
      - MYSQL_PASSWORD=drupalpass
      - MYSQL_ROOT_PASSWORD=rootpass
    volumes:
      - db_data:/var/lib/mysql
    restart: always

volumes:
  db_data:

环境变量配置

支持通过环境变量调整PHP和Apache配置：

数据持久化

为确保Drupal代码和配置不丢失，建议挂载以下目录：

• Drupal代码目录：/path/to/drupal/code:/var/www/html
• Apache日志目录（可选）：/path/to/logs:/var/log/apache2

扩展自定义配置

如需添加额外PHP扩展或修改Apache配置，可通过Dockerfile基于本镜像构建自定义镜像：

dockerfile
FROM [镜像名称]:[标签]

# 安装额外PHP扩展示例
RUN apt-get update && apt-get install -y php-xdebug \
  && rm -rf /var/lib/apt/lists/*

# 修改Apache配置
COPY custom-apache.conf /etc/apache2/conf-available/
RUN a2enconf custom-apache

注意事项

• 首次运行需确保Drupal代码目录已包含完整的Drupal核心文件
• 生产环境建议配合HTTPS反向代理（如Nginx）使用
• 数据库连接信息需在Drupal的settings.php中配置，或通过环境变量注入（需Drupal支持）