physikerwelt/mediawiki

mediawiki-docker 镜像文档

镜像概述

mediawiki-docker是专为MediaWiki本地开发设计的Docker环境镜像，提供便捷的开发配置和运行方式，支持MediaWiki扩展开发、功能测试及环境隔离，简化本地开发流程。

核心功能与特性

• 子模块管理：支持通过Git命令更新所有子模块，保持依赖组件最新
• 开发镜像构建：提供专用开发Dockerfile（Dockerfile-dev），构建适合本地开发的镜像
• 环境变量配置：可通过环境变量自定义服务器名称等关键配置
• 扩展目录挂载：支持将本地扩展目录挂载到容器中，实现实时开发和调试

使用场景

• MediaWiki扩展本地开发与调试
• MediaWiki功能模块本地测试
• 多版本MediaWiki开发环境隔离

使用方法

1. 更新环境

在项目根目录执行以下命令，更新所有子模块至最新版本：

bash
git submodule update --recursive --remote

2. 配置本地开发环境

创建docker-compose.override.yml文件，自定义开发配置：

docker
version: '3.4'
services:
  mediawiki:
    build:
      context: .
      dockerfile: Dockerfile-dev  # 使用开发专用Dockerfile构建镜像
    image: docker.xuanyuan.run/physikerwelt/mediawiki-dev  # 构建后的镜像名称
    environment:
      SERVER_NAME: localhost  # 配置服务器名称，用于本地访问
    volumes:
      - local/path:/var/www/html/extensions/extension-name  # 挂载本地扩展目录到容器，local/path需替换为实际本地扩展路径

3. 启动开发环境

完成配置后，通过以下命令启动Docker开发环境：

bash
docker-compose up -d

配置说明

环境变量

卷挂载

• local/path:/var/www/html/extensions/extension-name：将本地扩展开发目录挂载到容器内MediaWiki的扩展目录，实现代码实时同步和调试。需将local/path替换为实际本地扩展代码路径，extension-name替换为扩展目录名称。