Manual:安装要求

除Mediawiki软件本体外，还需要：

• Web服务器软件，用于向网页浏览器提供MediaWiki页面。
• PHP，用于运行Mediawiki。
• 数据库服务器，用于储存Mediawiki页面与数据。

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

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

你需要命令行访问权限以运行MediaWiki维护脚本。

一键下载安装包

如果您正在使用 Linux ，那么最好是使用您的程序包管理器来安装 Apache 网页服务器、 PHP 和 MariaDB 数据库服务器。在 Debian 和 Ubuntu 中，可输入以下命令：

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

软件包

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

或者，如果您使用Mac OS，您可以使用MAMP，它与 XAMPP 是类似的软件。 MAMP 版本包含了 Apache Web Server 和 MySQL 数据库。 它可以同时在Windows和Mac上使用，但它通常用在Mac而不是Windows上。

Web服务器

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

MediaWiki与所有可以调用兼容版本的PHP的主流Web服务器兼容。 大多数安装副本使用Apache HTTPD服务器。 Nginx(配置示例)也是一个好选择。

PHP

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

• 为了获得最新的稳定版本的MediaWiki，PHP版本8.1.0或更新的版本是必需的。 有关详细信息，请参阅兼容性 页面。

如果使用PHP8，建议使用MediaWiki 1.38.4或更高版本。 PHP8尚未被维基媒体下的各wiki使用，因此没有得到太多测试，但有其他组织在PHP8上运行MediaWiki时并未遇到问题。 如果您在PHP8上使用MediaWiki时遇到任何问题，请在此处报告。 参见工單T248925以获取更多信息。

• 下列的 PHP 扩展是必需的：
  • dom - 从版本1.34起必需
  • intl - 从版本1.36起必需
  • mbstring - 从版本1.27起必需，早期版本只做推荐
  • xml - 从版本1.27起必需，早期版本只做推荐
  • xmlreader - 从版本1.36起必需
• 除了必需的扩展外，还推荐使用以下扩展：
  • apcu
  • curl
• MediaWiki中只需要PHP的扩展在PHP中都是默认启用的。 如果您的主机服务提供的基本LAMP环境没有这些，您可能需要手动安装或启用这些环境。
  • 在Debian/Ubuntu系统中，推荐使用以下命令安装上面所列的PHP扩展：

    sudo apt-get install php php-intl php-mbstring php-xml php-apcu php-curl

• 当使用诸如cPanel的带有控制面版的主机服务时，你通常可以用“选择PHP版本”（PHP选择器）来启用这些扩展。（例如以下错误信息：“你缺失一个Mediawiki运行所需要的PHP扩展。请安装：intl”）
• 在大多数基于Debian/Ubuntu的发行版上，如果您希望MediaWiki使用MySQL，就需要php-mysql包。
• MediaWiki的某些功能可能需要执行外部进程的PHP函数，如图像缩略图，但是一些廉价主机通常会禁用。 如果您计划在共享主机上安装MediaWiki，请考虑这一点。
• MediaWiki扩展可能需要额外的PHP功能，例如VisualEditor需要libcurl支持（基于Debian/Ubuntu的发行版上有php-curl）。

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

数据库服务器

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

• MariaDB 10.3.0+ 或 MySQL 5.7.0+
• PostgreSQL 10.0+
• SQLite 3.8.0+

建议使用MariaDB或MySQL，维基媒体使用MariaDB。 其他的数据库服务器经历了更少的测试，你更有可能遇到软件缺陷。

从 1.34 起，我们不再支持 Oracle 和 Microsoft SQL Server 。

一些用户发现安装其他控制面板软件很有帮助，例如phpMyAdmin（MySQL/MariaDB）或phpPgAdmin（PostgreSQL）来帮助管理数据库服务器。 有的托管服务 也会提供这类软件。

硬件要求

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

可选依赖

• 如果需要使用缩略图功能，则需要安装ImageMagick或GD
• 运行维护脚本 需要有Shell访问权限；这也能使MediaWiki的升级工作更加轻松。
• 通过服务器发送邮件提醒 需要一个邮件传输代理 (MTA).
• GNU diff3 可用于自动解决编辑冲突。
• memcached 可用于对象缓存。

参阅

• 兼容性 ，用于了解未来 MediaWiki 的安装要求可能会如何变化的信息
• 手册:操作系统特定帮助