手册:安装要求

This page is a translated version of the page Manual:Installation requirements and the translation is 97% complete.
Outdated translations are marked like this.

除了Mediawiki软件本体以外,还需要:

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

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

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

简单的一键下载安装包

如果您正在使用Linux,那么最好是使用您的程序包管理器来安装Apache网页服务器、PHPMariaDB数据库服务器。在DebianUbuntu中,可输入以下命令:

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

软件包

在其他操作系统中,可使用一种像来自https://www.apachefriends.orgXAMPP软件包来按照并配置好所有的重要程序包——Apache网络服务器、PHP和MariaDB——只需一次下载。 这可用于Linux、Windows、Mac和Solaris。 截至2021年1月,最新的 XAMPP 包含了PHP 8.0。要运行 MediaWiki 至少需要 PHP 版本在 7.3.19/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.0 - 7.4.2不兼容Use PHP 7.4.3+ instead. 参见任务T246594以获取更多信息。
针对PHP 8.0的支持仍处于实验阶段。 我们尚未得知存在任何问题,但针对它的测试不如PHP 7完备。 PHP 8.1不受支持。 参见任务T248925以获取更多信息。
  • 下列的 PHP 扩展是必需的:
  • 注意所有的这些在PHP中都是默认启用的。
  • 在大多数基于Debian/Ubuntu的发行版上,如果您希望MediaWiki使用MySQL,就需要php-mysql包。
  • MediaWiki的某些功能可能需要执行外部进程的PHP函数,如图像缩略图,但是一些廉价主机通常会禁用。 如果您计划在共享主机上安装MediaWiki,请考虑这一点。
  • MediaWiki扩展可能需要额外的PHP功能,例如 可视化编辑器需要libcurl支持(基于Debian/Ubuntu的发行版上有php-curl)。

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

数据库服务器

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

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

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

一些用户发现安装其他软件包很有帮助,例如phpMyAdmin(MySQL/MariaDB)或phpPgAdmin(Postgres)来帮助管理数据库服务器。 Some 托管服务 also provide such software.

硬件要求

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

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

可选依赖

参见