注意： 这是mediawiki镜像的arm32v7架构构建的“每架构”仓库——更多信息，请参见镜像文档中的“除amd64之外的架构？”和***镜像FAQ中的“Git中的镜像源已更改，现在该怎么办？”。

快速参考

-** 维护者：**MediaWiki社区和Docker社区

-** 获取帮助的地方：**Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应的Dockerfile链接

• 1.44.2、1.44、latest（最新版）、stable（稳定版）

• 1.44.2-fpm、1.44-fpm、stable-fpm

• 1.44.2-fpm-alpine、1.44-fpm-alpine、stable-fpm-alpine

• 1.43.5、1.43、lts（长期支持版）

• 1.43.5-fpm、1.43-fpm、lts-fpm

• 1.43.5-fpm-alpine、1.43-fpm-alpine、lts-fpm-alpine

• 1.39.15、1.39

• 1.39.15-fpm、1.39-fpm

• 1.39.15-fpm-alpine、1.39-fpm-alpine

快速参考（续）

-** 提交问题的地方：[*]

-** 支持的架构：**(更多信息)
amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le

-** 已发布镜像制品详情：**repo-info仓库的repos/mediawiki/目录（历史记录）
（镜像元数据、传输大小等）

-** 镜像更新：**official-images仓库的library/mediawiki标签
official-images仓库的library/mediawiki文件（历史记录）

-** 本描述的来源：**docs仓库的mediawiki/目录（历史记录）

什么是MediaWiki？

MediaWiki是免费开源的wiki软件。最初由Magnus Manske开发，后经Lee Daniel Crocker改进，它运行在许多网站上，包括***、维基词典和维基共享资源。它使用PHP编程语言编写，并将内容存储在数据库中。与基于类似许可和架构的WordPress一样，它已成为其类别中的主导软件。

***.org/wiki/MediaWiki

!logo

如何使用本镜像

启动mediawiki实例的基本命令模式如下：

console
$ docker run --name some-mediawiki -d arm32v7/mediawiki

如果希望从主机访问实例而无需使用容器的IP，可以使用标准端口映射：

console
$ docker run --name some-mediawiki -p 8080:80 -d arm32v7/mediawiki

然后，在浏览器中通过http://localhost:8080或[***]访问。

本镜像支持多种数据库类型，最容易通过标准容器链接使用。在默认配置中，可以使用SQLite来避免使用第二个容器并写入平面文件。以下是不同（更适合生产环境）数据库类型的详细说明。

首次访问本镜像提供的Web服务器时，会进行简短的设置过程。以下详细信息专门针对该配置过程中的“设置数据库”步骤。

MySQL

console
$ docker run --name some-mediawiki --link some-mysql:mysql -d arm32v7/mediawiki

• 数据库类型：MySQL、MariaDB或等效数据库
• 数据库名称/用户名/密码：<访问MySQL实例的详细信息>（MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE；参见mariadb描述中的环境变量）
• 高级选项；数据库主机：some-mysql（使用--link添加的/etc/hosts条目访问链接容器的MySQL实例）

卷

默认情况下，本镜像不包含任何卷。

路径/var/www/html/images和/var/www/html/LocalSettings.php通常应作为卷，但本镜像中没有显式声明VOLUME，因为卷无法被移除。

console
$ docker run --rm arm32v7/mediawiki tar -cC /var/www/html/sites . | tar -xC /path/on/host/sites

... 通过docker compose

mediawiki的compose.yaml示例：

yaml
# MediaWiki与MariaDB
#
# 通过"http://localhost:8080"访问
services:
  mediawiki:
    image: mediawiki
    restart: always
    ports:
      - 8080:80
    links:
      - database
    volumes:
      - images:/var/www/html/images
      # 初始设置后，将LocalSettings.php下载到与本yaml相同的目录，取消以下行的注释并使用compose重启mediawiki服务
      # - ./LocalSettings.php:/var/www/html/LocalSettings.php
  database: # <- 此键定义设置过程中的数据库名称
    image: mariadb
    restart: always
    environment:
      # 参见[***]
      MYSQL_DATABASE: my_wiki
      MYSQL_USER: wikiuser
      MYSQL_PASSWORD: example
      MYSQL_RANDOM_ROOT_PASSWORD: 'yes'
    volumes:
      - db:/var/lib/mysql

volumes:
  images:
  db:

运行docker compose up，等待完全初始化后，访问http://localhost:8080或[***]（视情况而定）。

添加额外的库/扩展

本镜像不提供任何额外的PHP扩展或其他库，即使它们是流行插件所必需的。可能的插件数量无限，它们可能需要PHP支持的任何扩展。包含所有存在的PHP扩展会显著增加镜像大小。

如果需要额外的PHP扩展，需要基于本镜像创建自己的镜像。php镜像的文档解释了如何编译额外的扩展。

以下Docker Hub功能可帮助保持依赖镜像的更新：

• 自动构建让Docker Hub在每次推送更改时自动构建Dockerfile。

镜像变体

arm32v7/mediawiki镜像有多种版本，每种版本设计用于特定用例。

arm32v7/mediawiki:<version>

这是默认镜像。如果不确定自己的需求，可能需要使用此版本。它既可以用作临时容器（挂载源代码并启动容器以运行应用），也可以作为构建其他镜像的基础。

arm32v7/mediawiki:<version>-alpine

此镜像基于流行的Alpine Linux项目，可在alpine***镜像中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是首要考虑因素时，此变体非常有用。需要注意的主要问题是它使用musl libc而非glibc及类似库，因此软件可能会因对libc要求/假设的深度不同而遇到问题。有关可能出现的问题以及使用基于Alpine的镜像的优缺点的更多讨论，请参见此Hacker News评论线程。

为了最小化镜像大小，基于Alpine的镜像通常不包含额外的相关工具（如git或bash）。以此镜像为基础，可在自己的Dockerfile中添加所需工具（如果不熟悉如何安装包，请参见alpine镜像描述中的示例）。

许可

查看本镜像中包含的软件的许可信息。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可（如基础发行版中的Bash等，以及包含的主要软件的任何直接或间接依赖项）约束。

在repo-info仓库的mediawiki/目录中可以找到一些能够自动检测到的额外许可信息。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可。