手册:安装要求

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

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

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

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

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

简单的一键下载安装包

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

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.orgXAMPP软件包来按照并配置好所有的重要程序包——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或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

可选依赖

参见