druidfi/drupal

Drupal优化PHP镜像文档

镜像概述

本镜像专为Drupal内容管理系统（CMS）设计，提供经过优化的PHP运行环境。基于官方PHP镜像构建，针对Drupal应用的特性进行定制化配置，包含所有Drupal必需的PHP扩展、性能优化参数及兼容性设置，旨在简化Drupal应用的部署流程，提升运行稳定性和效率。

核心功能与特性

1. 完整的Drupal兼容性

• 预安装Drupal运行所需的PHP扩展，包括但不限于：mysqli、pdo_mysql、gd、curl、mbstring、xml、zip、intl等
• 支持主流Drupal版本（Drupal 7/8/9/10），确保版本兼容性

2. 性能优化

• 集成OPcache缓存扩展，提升PHP代码执行效率
• 预配置APC(u)缓存支持，优化Drupal缓存机制
• 针对Drupal数据库操作的PHP配置调优（如连接池、超时设置）

3. 灵活性与易用性

• 基于轻量级Alpine或Debian基础镜像，平衡镜像大小与功能完整性
• 支持多PHP版本标签（如7.4、8.0、8.1、8.2），适配不同Drupal版本需求
• 环境变量驱动的配置，支持运行时自定义参数

4. 安全与稳定性

• 定期更新基础镜像及依赖，修复安全漏洞
• 遵循PHP安全最佳实践，禁用危险函数，限制权限
• 与Drupal安全模块兼容，支持HTTPS配置

使用场景

• 开发环境：快速搭建本地Drupal开发环境，无需手动配置PHP扩展
• 测试环境：在CI/CD流程中部署Drupal应用，验证代码兼容性和性能
• 生产环境：作为Drupal应用的Web服务器后端，配合Nginx/Apache和数据库（如MySQL/PostgreSQL）构建完整服务架构
• 多站点部署：支持Drupal多站点配置，满足复杂网站架构需求

使用方法

基本使用（Docker Run）

bash
# 拉取镜像（指定PHP版本，例如8.1）
docker pull docker.xuanyuan.run/drupal-optimized-php:8.1

# 运行容器（挂载Drupal代码目录）
docker run -d \
  --name drupal-php \
  -p 9000:9000 \  # PHP-FPM端口（如需配合Web服务器）
  -v /path/to/your/drupal/code:/var/www/html \  # 挂载本地Drupal代码
  -e PHP_OPCACHE_ENABLE=1 \  # 启用OPcache
  -e DRUPAL_DB_HOST=db \  # 数据库主机（需配合数据库容器）
  drupal-optimized-php:8.1

Docker Compose示例（完整服务栈）

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  php:
    image: docker.xuanyuan.run/drupal-optimized-php:8.2
    volumes:
      - ./drupal:/var/www/html  # 本地Drupal代码目录
      - ./php.ini:/usr/local/etc/php/php.ini  # 自定义php.ini（可选）
    environment:
      - PHP_OPCACHE_ENABLE=1
      - PHP_MEMORY_LIMIT=256M  # PHP内存限制
      - DRUPAL_DB_HOST=db
      - DRUPAL_DB_USER=drupal_user
      - DRUPAL_DB_PASSWORD=secure_password
      - DRUPAL_DB_NAME=drupal_db
    depends_on:
      - db
    restart: unless-stopped

  web:
    image: docker.xuanyuan.run/nginx:alpine
    ports:
      - "80:80"
      - "443:443"  # 如需HTTPS，挂载证书
    volumes:
      - ./drupal:/var/www/html
      - ./nginx/conf.d:/etc/nginx/conf.d  # Nginx配置（反向代理到PHP-FPM）
      - ./ssl:/etc/nginx/ssl  # SSL证书（可选）
    depends_on:
      - php
    restart: unless-stopped

  db:
    image: docker.xuanyuan.run/mysql:8.0
    volumes:
      - db_data:/var/lib/mysql  # 数据库数据持久化
    environment:
      - MYSQL_DATABASE=drupal_db
      - MYSQL_USER=drupal_user
      - MYSQL_PASSWORD=secure_password
      - MYSQL_ROOT_PASSWORD=root_secure_password
    restart: unless-stopped

volumes:
  db_data:  # 数据库数据卷（持久化存储）

启动服务：

bash
docker-compose up -d

环境变量配置

自定义配置

如需覆盖默认PHP配置，可通过挂载自定义php.ini文件：

bash
docker run -v /path/to/your/php.ini:/usr/local/etc/php/php.ini docker.xuanyuan.run/drupal-optimized-php:8.2

常见自定义场景：调整内存限制、修改上传文件大小、配置日志级别等。

注意事项

• 生产环境中建议配合反向代理（如Nginx）使用，PHP容器仅暴露PHP-FPM端口（通常9000），由Web服务器处理静态资源和HTTP请求
• 数据持久化：确保Drupal代码目录、数据库数据卷正确挂载，避免容器重启后数据丢失
• 版本兼容性：选择与Drupal版本匹配的PHP镜像标签（如Drupal 10需PHP 8.1+，Drupal 9需PHP 7.4+）
• 安全加固：生产环境中需设置强密码，限制容器网络访问，启用HTTPS并定期更新镜像

版本标签说明

镜像标签格式为{PHP版本}，例如：

• drupal-optimized-php:7.4（PHP 7.4，适用于Drupal 7/8）
• drupal-optimized-php:8.1（PHP 8.1，适用于Drupal 9/10）
• drupal-optimized-php:latest（最新稳定PHP版本，推荐用于Drupal最新版）

建议根据Drupal官方文档的PHP版本要求选择对应标签。