fazalfarhan01/wordpress-redis

WordPress-Redis Docker镜像文档

镜像概述和主要用途

本镜像基于官方WordPress镜像构建，已预安装php-redis扩展，适用于需要Redis缓存支持的WordPress网站部署。运行时需配合独立的Redis服务器使用，提供完整的WordPress运行环境，包括数据库、管理工具等组件的集成配置。

核心功能和特性

• 基于最新版WordPress官方镜像构建，确保核心功能与官方同步
• 已预安装并启用php-redis扩展，支持Redis缓存等功能
• 支持自定义PHP配置（上传限制、内存分配等）
• 集成MariaDB数据库、phpMyAdmin管理工具和WP-CLI命令行工具
• 提供完整的docker-compose配置，支持一键部署
• 兼容ARM64架构设备（需调整phpMyAdmin镜像）

使用场景和适用范围

• 需要Redis缓存优化性能的WordPress网站
• 开发环境快速搭建和测试
• 生产环境中需要简化部署流程的WordPress应用
• 需要自定义PHP配置的WordPress项目
• 需同时管理数据库和WordPress内容的场景

使用方法和配置说明

环境准备

需安装Docker和Docker Compose。项目文件结构建议如下：

project/
├── .env
├── config/
│   └── php.conf.ini
├── wp-app/        # WordPress文件
├── plugins/       # 插件目录
├── themes/        # 主题目录
├── wp-data/       # 数据库初始化脚本
└── docker-compose.yml

环境变量配置（.env）

创建.env文件配置基础参数：

ENV
DB_ROOT_PASSWORD=password       # 数据库root密码
DB_NAME=wordpress               # WordPress数据库名
WORDPRESS_PORT=8080             # WordPress访问端口
PHPMYADMIN_PORT=8081            # phpMyAdmin访问端口

PHP配置（config/php.conf.ini）

自定义PHP配置文件，示例：

CONF
file_uploads = On               # 允许文件上传
memory_limit = 1024M            # PHP内存限制
upload_max_filesize = 100M      # 最大上传文件大小
post_max_size = 100M            # POST数据最大大小
max_execution_time = 600        # 最大执行时间（秒）

Docker Compose部署

创建docker-compose.yml文件，完整配置如下：

注意：ARM64架构设备需将phpmyadmin/phpmyadmin替换为arm64v8/phpmyadmin

DOCKER
version: '3'

services:
  wp:
    image: fazalfarhan01/wordpress-redis
    ports:
      - ${WORDPRESS_PORT}:80     # 映射WordPress端口
    volumes:
      - ./config/php.conf.ini:/usr/local/etc/php/conf.d/conf.ini  # 挂载PHP配置
      - ./wp-app:/var/www/html                                    # WordPress文件
      - ./plugins:/var/www/html/wp-content/plugins                # 插件目录
      - ./themes:/var/www/html/wp-content/themes                  # 主题目录
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_NAME: "${DB_NAME}"
      WORDPRESS_DB_USER: root
      WORDPRESS_DB_PASSWORD: "${DB_ROOT_PASSWORD}"
    depends_on:
      - db
    links:
      - db
    restart: always

  wpcli:
    image: wordpress:cli         # WordPress命令行工具
    volumes:
      - ./config/php.conf.ini:/usr/local/etc/php/conf.d/conf.ini
      - ./wp-app:/var/www/html
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_NAME: "${DB_NAME}"
      WORDPRESS_DB_USER: root
      WORDPRESS_DB_PASSWORD: "${DB_ROOT_PASSWORD}"
    depends_on:
      - db
      - wp

  pma:
    image: phpmyadmin/phpmyadmin # PHPMyAdmin数据库管理工具
    environment:
      PMA_HOST: db
      PMA_PORT: 3306
      MYSQL_ROOT_PASSWORD: "${DB_ROOT_PASSWORD}"
    ports:
      - ${PHPMYADMIN_PORT}:80    # 映射phpMyAdmin端口
    links:
      - db:db
    restart: always

  db:
    image: mariadb:latest        # MariaDB数据库
    command: [
        '--default_authentication_plugin=mysql_native_password',
        '--character-set-server=utf8mb4',
        '--collation-server=utf8mb4_unicode_ci'
    ]
    volumes:
      - ./wp-data:/docker-entrypoint-initdb.d  # 数据库初始化脚本
      - db_data:/var/lib/mysql                 # 数据持久化
    environment:
      MYSQL_DATABASE: "${DB_NAME}"
      MYSQL_ROOT_PASSWORD: "${DB_ROOT_PASSWORD}"
    restart: always

  redis:
    restart: always
    image: redis:latest          # Redis服务器

volumes:
  db_data:                       # 数据库数据卷

启动服务：

bash
docker-compose up -d

自定义构建镜像

如需自行构建镜像，创建Dockerfile：

DOCKERFILE
FROM wordpress:latest
RUN pecl install -o -f redis \
&&  rm -rf /tmp/pear \
&&  docker-php-ext-enable redis

构建命令：

bash
docker build -t my-wordpress-redis .