手册:安装要求

手册:安装指南 • 关于 MediaWiki

功能列表 • 安装要求

下载 • 安装 • 配置

一个标准安装的 MediaWiki 除软件自身以外，还需要安装下列环境：

• Web 服务器。用于服务客户端浏览器的请求。
• PHP 运行环境。
• 数据库服务器。用于储存网站页面与数据。

除上述必需的环境以外，还有若干 可选依赖，如果你需要使用一些高级功能则需要安装这些依赖（见下方）。

如果你的网站是托管的（你不直接控制它）那么联系你的系统管理员或者服务提供商，确保这些软件被安装并处于可用状态。

简单的一键下载安装包

如果您正在使用Linux，那么最好是使用您的程序包管理器来安装apache、php和MariaDB。在Debian和Ubuntu中，可输入以下命令：

sudo apt-get install php php-apcu php-intl php-mbstring php-xml php-mysql mariadb-server apache2

在其他操作系统中，可使用来自https://www.apachefriends.org的XAMPP来按照并配置号所有的重要程序包–Apache网络服务器、PHP和MariaDB–只需一次下载。 这可用于Linux、Windows、Mac和Solaris。 截至2021年1月，最新的 XAMPP 包含了PHP 8.0。要运行 MediaWiki 至少需要 PHP 版本在 7.3.19 以上。

或者，如果您使用苹果电脑，您可以使用MAMP，它与 XAMPP 是类似的软件。 当前的 MAMP 版本包含了 Apache Web Server 和 MySQL 数据库。 它可以同时在Windows和Mac上使用，但它通常用在Mac而不是Windows上。 它现在正运行着最新的PHP和MySQL。

網頁伺服器

为了向浏览器提供维基页面，MediaWiki需要一些Web服务器软件。 通常，您无法选择使用哪种软件，因为它将是您的托管服务提供商提供的。

大多数安装副本使用Apache服务器，可在官方下载页获得。 然而，MediaWiki也被在使用IIS 7.0，Cherokee，Hiawatha，LiteSpeed，nginx（配置实例）、lighttpd和Caddy的情况下测试过。

PHP

由于上游错误，MediaWiki与PHP 7.4.0至7.4.2不兼容。 请使用PHP 7.4.3或者更高版本代替。 参见任务T246594以获取更多信息。

MediaWiki 使用 PHP 编程语言编写，PHP 运行环境是必需的。

记住，虽然MediaWiki通过一个安装脚本来提供基于网络的最重要的东西的配置文件，但一些PHP基础将需要用来做更多的详细的个性化。

• 为了获得最新的稳定版本的MediaWiki，PHP版本7.3.19或更新的版本是必需的。

有关详细信息，请参阅兼容性 页面。

• 下列的 PHP 扩展是必需的：
  • Perl兼容正则表达式（PCRE） (MediaWiki 1.23 要求 PCRE 7.2+)
  • 会话
  • SQL
  • OpenSSL
  • json (MediaWiki 1.22+)
  • mbstring （从1.27版本起要求，早期版本只做推荐）
  • fileinfo （从1.30版本起要求）
• 注意所有的这些在PHP中都是默认启用的。
• 如果你没有可选的PHP intl扩展来处理Unicode规范化，MediaWiki的安装程序会发出警告。
  • 在大多数基于Debian/Ubuntu的发行版中通常是php-intl包。
• PHP OpenSSL扩展也是推荐的。 参见手册:$wgSessionInsecureSecrets 。
• 在大多数基于Debian/Ubuntu的发行版上，如果您希望MediaWiki使用MySQL，就需要php-mysql包。
• MediaWiki的某些功能可能需要执行外部进程的PHP函数，如图像缩略图，但是一些廉价主机通常会禁用。 这已在MediaWiki 1.23上专门针对文件上传（任务T68467）浮出水面。 如果您计划在共享主机上安装MediaWiki，请考虑这一点。
• MediaWiki扩展可能需要额外的PHP功能，例如 可视化编辑器需要libcurl支持（基于Debian/Ubuntu的发行版上有php-curl）。

如果需要从源代码编译PHP，请参阅PHP 配置 以获取影响MediaWiki的编译选项。

• 某些服务器可能还需要安装等效的数据库模块和会话管理模块。 有关更多信息，请参阅各个操作系统说明。
• 使用Microsoft安装程序在Windows上安装时，将所选数据库的扩展名（MySQL、MariaDB或Postgres）添加到要安装的功能中。

資料庫伺服器

警告：	Oracle与Microsoft SQL Server的支持不再维护并将在MediaWiki 1.34中移除。 强烈建议你不要使用它们。

MediaWiki将所有文本和数据（内容页面、用户详细信息、系统消息等）存储在数据库中，该数据库能够与其他基于Web的应用程序（phpBB等）共享。您将需要以下数据库服务器中的“一个”来运行最新版本的MediaWiki：

• MySQL 5.5.8+^* 或 MariaDB 5.1+
• PostgreSQL 9.2+ （自MediaWiki 1.8起支持） 更多信息请查看Manual:Installing MediaWiki#PostgreSQL。
• 手册:SQLite 3

过去支持，现在不支持：

• 手册:Oracle （由于开放封禁错误，在上个MediaWiki版本中不受支持）
• Special:MyLanguage/Version lifecycle#Release policy发行版亦支持Microsoft SQL Server 2008 R2或更高版本。但在非LTS发行版中，使用SQL Server不保证能正常工作

必须要确保该全文模块已安装好。

一些用户发现安装其他软件包很有帮助，例如phpMyAdmin（MySQL/MariaDB）或phpPgAdmin（Postgres）来帮助管理数据库服务器。

从MediaWiki 1.19起要求MySQL 5。 从MediaWiki 1.6开始需要MySQL4。（如果您使用的是古老版本的MySQL且无法升级，则需要使用MediaWiki 1.5.8，但不支持此版本。）

硬體需求

运行一个单机网站的最低要求配置是 256MB 运行内存和 85MB 的储存空间。但是在大流量或者启用了上传功能的的网站上，这些配置可能完全不够。 一些用户也报告了在电脑上运行的 MediaWiki 最低可能只占用 48MB 运行内存。

对于开发人员安装，安装大小可以减少到大约50Mb，对于非开发人员的最终用户安装，大小可以减少到大约26Mb。 参见Manual:Reduce size of the installation

可选依赖

其他软件

• ImageMagick或GD被要求，如果需要使用Image thumbnailing 功能
• TeX被要求用来显示行内数学方程式。 在大部分基于Debian/Ubuntu的Linux发行版中, 这个软件存在于texlive软件包中。
• Sendmail被要求用来发送电子邮件。
• Shell访问被要求用于运行手册:维护脚本 ，这能使MediaWiki的升级工作更加轻松。
• GNU diff3 可以提供自动化来解决冲突的问题。

有关上述项目的更多信息，请参见手册:安装第三方工具 。

可视化编辑器

在MediaWiki 1.34及之前版本，VisualEditor 扩展（以及Special:MyLanguage/Extension:StructuredDiscussions扩展）需要Parsoid web 服务，这由Node.js实现。 大多数共享托管公司（HostGator、Bluehost、Dreamhost等）不提供Node.js。 出于性能和安全原因，最好使用专用托管解决方案，例如虚拟专用服务器（“VPS”）。

Scribunto

如果您希望从wiki页面和模板调用Lua模块（参见此wiki的例子），您的wiki也需要Scribunto。

参见

• 兼容性 ，了解Mediawiki的安装要求将来可能会如何变化的信息

• 手册:操作系统特定帮助
• MediaWiki主机服务和wiki农场

软件包

• MediaWiki软件包
  • Manual:Running MediaWiki on Windows/bitnami
• XAMPP