手册:安装要求

安装MediaWiki : 系统需求 • 下載 • 解压缩 • 上传 • 建立数据库 • 安裝 • 配置 • 自訂

FAQ • 常见问题 • 取得帮助和支持

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

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

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

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

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

简单的一键下载安装包

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

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

软件包

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

或者，如果您使用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版本7.4.3或更新的版本是必需的。 有关详细信息，请参阅兼容性 页面。

由于上游漏洞，MediaWiki与PHP 7.4.0 - 7.4.2不兼容。 请改用PHP 7.4.3+。 参见任务T246594以获取更多信息。

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

• 下列的 PHP 扩展是必需的：

• • calendar （从版本1.33起必需）
  • dom (required since 1.34)
  • fileinfo （从版本1.30起必需）
  • intl （从版本1.36起必需）
  • json (required since 1.22)
  • mbstring （从版本1.27起必需，早期版本只做推荐）
  • xml (required since 1.27, recommended for earlier versions)
  • xmlreader (required since 1.36)

• 一般来讲，所有的这些在PHP中都是默认启用的。但是一些主机提供商可能只提供基本的LAMP或LNMP环境。在这种情况下，您应该手动安装这些扩展。

But some host providers may only provide basic LAMP or LNMP environment. In that case you should install these extensions manually.

• • In Debian/Ubuntu, the following command can install PHP and the extensions listed above: sudo apt install php php-calendar php-dom php-fileinfo php-intl php-json php-mbstring php-xml php-xmlreader
• If using graphical hosting control panel software such as cPanel, you can often use "Select PHP Version" (PHP Selector) to check and enable extensions. (example error message: "You are missing a required extension to PHP that MediaWiki requires to run. Please install: intl")

• 在大多数基于Debian/Ubuntu的发行版上，如果您希望MediaWiki使用MySQL，就需要php-mysql包。

• MediaWiki的某些功能可能需要执行外部进程的PHP函数，如图像缩略图，但是一些廉价主机通常会禁用。 如果您计划在共享主机上安装MediaWiki，请考虑这一点。

• MediaWiki扩展可能需要额外的PHP功能，例如 可视化编辑器需要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。 其他的数据库服务器经历了更少的测试，你更有可能遇到软件缺陷。

Since MediaWiki 1.34 , we no longer support using 手册:Oracle and 手冊:Microsoft SQL Server . We strongly advise to no longer use these.

一些用户发现安装其他控制面板软件很有帮助，例如phpMyAdmin（MySQL/MariaDB）或phpPgAdmin（PostgreSQL）来帮助管理数据库服务器。 Some 托管服务 also provide such software.

硬件要求

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

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

可选依赖

• 如果需要使用Image thumbnailing 功能，则需要安装ImageMagick或GD
• 需要安装TeX以显示行内数学方程式。 在大部分基于Debian/Ubuntu的Linux发行版中，这个软件存在于texlive软件包中。
• 运行手册:维护脚本 需要有Shell访问权限；这也能使MediaWiki的升级工作更加轻松。
• 通过服务器发送邮件提醒 需要一个邮件传输代理 (MTA).
• GNU diff3 可以用于自动解决编辑冲突。
• memcached 可用于对象缓存。

参见

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