hussainweb/drupal-base

Drupal基础Docker镜像

镜像概述

该镜像为Drupal项目提供基础运行时环境，设计用于CI（持续集成）环境，同时也适用于使用docker-compose的本地开发环境。本镜像与https://hub.docker.com/_/drupal%E7%B1%BB%E4%BC%BC%EF%BC%8C%E4%BD%86%E4%B8%8D%E5%90%ABDrupal%E6%A0%B8%E5%BF%83%E6%96%87%E4%BB%B6%EF%BC%8C%E5%85%81%E8%AE%B8%E7%94%A8%E6%88%B7%E6%8C%82%E8%BD%BD%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BB%A3%E7%A0%81%E5%BA%93%E3%80%82

核心功能与特性

• 提供Drupal项目运行所需的基础环境
• 支持CI环境和本地开发环境使用
• 不含Drupal核心文件，允许挂载自定义代码库
• 提供两种镜像变体，满足不同部署需求

镜像变体

本仓库包含两种主要镜像变体：

• apache-bookworm：基于Debian Bookworm，集成Apache Web服务器
• fpm-alpine：基于Alpine Linux，集成PHP-FPM

根据需求选择合适的镜像：Apache镜像适合简单的一体化容器部署，而FPM镜像则适用于配合Nginx等独立Web服务器的场景。

使用场景与适用范围

• CI环境：作为Drupal项目自动化构建、测试的基础运行时
• 本地开发环境：通过docker-compose快速搭建开发环境
• 部署选择：简单场景选择Apache变体（一体化容器），需要独立Web服务器时选择FPM变体（配合Nginx等）

使用方法

Apache变体

Apache镜像使用简单，将Drupal代码库挂载到容器内的/var/www/html目录即可。

以下是docker-compose.yml示例片段：

yaml
services:
  drupal:
    image: hussainweb/drupal-base:php8.4
    volumes:
      - ./path/to/your/drupal/root:/var/www/html  # 挂载本地Drupal根目录
    ports:
      - "8080:80"  # 将容器80端口映射到本地8080端口
    restart: always  # 容器退出时自动重启

FPM-Alpine变体

FPM-Alpine镜像需要配合独立的Web服务器使用，以下示例使用Nginx作为Web服务器。

docker-compose.yml示例

yaml
services:
  drupal:
    image: hussainweb/drupal-base:php8.4-alpine
    volumes:
      - ./path/to/your/drupal/root:/var/www/html  # 挂载本地Drupal根目录
    restart: always  # 容器退出时自动重启

  nginx:
    image: nginx:latest
    ports:
      - "8080:80"  # 将Nginx 80端口映射到本地8080端口
    volumes:
      - ./path/to/your/drupal/root:/var/www/html  # 共享Drupal代码目录给Nginx
      - ./path/to/your/nginx.conf:/etc/nginx/conf.d/default.conf  # 挂载自定义Nginx配置
    depends_on:
      - drupal  # 确保drupal服务先启动
    restart: always  # 容器退出时自动重启

Nginx配置示例

需创建nginx.conf文件，以下是基础配置示例：

conf
server {
    listen 80;
    server_name your-domain.com;  # 替换为实际域名
    root /var/www/html;  # Drupal代码根目录

    location / {
        try_files $uri /index.php?$query_string;  # Drupal URL重写规则
    }

    location ~ \.php$ {
        fastcgi_pass drupal:9000;  # 连接到drupal服务的PHP-FPM端口
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;  # 包含FastCGI参数
    }
}