arm32v6/mediawiki

注意：这是https://hub.docker.com/_/mediawiki的`arm32v6`架构构建的“按架构”仓库——更多信息，请参见官方镜像文档中的“https://github.com/docker-library/official-images#architectures-other-than-amd64”和官方镜像FAQ中的“https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what”。

快速参考

• 维护者：
  https://github.com/wikimedia/mediawiki-docker

• 获取帮助：
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic或https://stackoverflow.com/help/on-topic

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

• https://github.com/wikimedia/mediawiki-docker/blob/22e0f2939d36bfc61d1572e4e1a2afd66d84e6f5/1.44/fpm-alpine/Dockerfile

• https://github.com/wikimedia/mediawiki-docker/blob/22e0f2939d36bfc61d1572e4e1a2afd66d84e6f5/1.43/fpm-alpine/Dockerfile

• https://github.com/wikimedia/mediawiki-docker/blob/22e0f2939d36bfc61d1572e4e1a2afd66d84e6f5/1.39/fpm-alpine/Dockerfile

快速参考（续）

• 问题反馈：
  https://phabricator.wikimedia.org/project/view/3094/

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/mediawiki/、https://hub.docker.com/r/arm32v5/mediawiki/、https://hub.docker.com/r/arm32v6/mediawiki/、https://hub.docker.com/r/arm32v7/mediawiki/、https://hub.docker.com/r/arm64v8/mediawiki/、https://hub.docker.com/r/i386/mediawiki/、https://hub.docker.com/r/ppc64le/mediawiki/

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/mediawiki（https://github.com/docker-library/repo-info/commits/master/repos/mediawiki）
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fmediawiki
  https://github.com/docker-library/official-images/blob/master/library/mediawiki（https://github.com/docker-library/official-images/commits/master/library/mediawiki）

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/mediawiki（https://github.com/docker-library/docs/commits/master/mediawiki）

什么是MediaWiki？

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

***.org/wiki/MediaWiki

如何使用本镜像

基本使用

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

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

若需从主机访问实例（无需容器IP），可使用标准端口映射：

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

然后通过浏览器访问http://localhost:8080或http://主机IP:8080。

本镜像支持多种数据库类型，最简便的方式是通过标准容器链接使用。默认配置下，可使用SQLite避免额外容器，直接写入平面文件。以下是不同（更适合生产环境的）数据库类型的详细说明。

首次访问本镜像提供的Web服务器时，会进入简短的设置流程。下文详细说明配置过程中“设置数据库”步骤的具体信息。

MySQL数据库配置

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

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

卷（Volumes）

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

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

可通过以下命令将容器内文件复制到主机：

console
$ docker run --rm arm32v6/mediawiki tar -cC /var/www/html/sites . | tar -xC /主机路径/sites

使用https://github.com/docker/compose

mediawiki的compose.yaml示例：

yaml
# MediaWiki与MariaDB
#
# 通过"http://localhost:8080"访问
services:
  mediawiki:
    image: docker.xuanyuan.run/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: docker.xuanyuan.run/mariadb
    restart: always
    environment:
      # @see https://phabricator.wikimedia.org/source/mediawiki/browse/master/includes/DefaultSettings.php
      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或http://主机IP:8080（根据实际情况）。

添加额外库/扩展

本镜像不包含任何额外PHP扩展或其他库，即使是热门插件所需的。由于插件数量众多且可能需要任何PHP支持的扩展，包含所有PHP扩展会显著增加镜像体积。

如需额外PHP扩展，需基于本镜像创建自定义镜像。https://github.com/docker-library/docs/blob/31280550a3c7104fef824450753844d2f3d917be/php/README.md#how-to-install-more-php-extensions说明如何编译额外扩展。

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

• https://docs.docker.com/docker-hub/builds/：让Docker Hub在推送更改时自动构建Dockerfile。

镜像变体

arm32v6/mediawiki镜像有多种版本，适用于不同场景。

arm32v6/mediawiki:<version>

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

arm32v6/mediawiki:<version>-alpine

此镜像基于流行的https://alpinelinux.org（来自https://hub.docker.com/_/alpine）。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此生成的镜像通常更精简。

当最终镜像大小是首要考虑因素时，此变体非常有用。需注意的是，它使用https://musl.libc.org而非https://www.etalabs.net/compare_libcs.html，因此软件可能因libc依赖/假设而出现问题。更多讨论参见此Hacker News评论线程。

为最小化镜像大小，Alpine基础镜像通常不包含额外相关工具（如git或bash）。如需这些工具，可在基于此镜像的Dockerfile中添加（参见https://hub.docker.com/_/alpine/了解包安装示例）。

许可证

查看本镜像所包含软件的https://phabricator.wikimedia.org/source/mediawiki/browse/master/COPYING。

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

可在https://github.com/docker-library/repo-info/tree/master/repos/mediawiki中找到一些自动检测到的额外许可证信息。

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