手册:安装要求
一个标准安装的 MediaWiki 除软件自身以外,还需要安装下列环境:
除上述必需的环境以外,还有若干 可选依赖,如果你需要使用一些高级功能则需要安装这些依赖(见下方)。
如果你的网站是托管的(你不直接控制它)那么联系你的系统管理员或者服务提供商,确保这些软件被安装并处于可用状态。
简单的一键下载安装包
如果您正在使用Linux,那么最好是使用您的程序包管理器来安装apache、php和MariaDB。在Debian和Ubuntu中,可输入以下命令:
sudo apt-get install php php-apcu php-intl php-mbstring php-xml php-mysql php-calendar 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/7.4.3 以上。
或者,如果您使用苹果电脑,您可以使用MAMP,它与 XAMPP 是类似的软件。 当前的 MAMP 版本包含了 Apache Web Server 和 MySQL 数据库。 它可以同时在Windows和Mac上使用,但它通常用在Mac而不是Windows上。 它现在正运行着最新的PHP和MySQL。
Web服务器
为了向浏览器提供维基页面,MediaWiki需要一些Web服务器软件。 通常,您无法选择使用哪种软件,因为它将是您的托管服务提供商提供的。
大多数安装副本使用Apache服务器,可在官方下载页获得。 然而,MediaWiki也被在使用IIS 7.0、Cherokee、Hiawatha、LiteSpeed、nginx(配置实例)、lighttpd和Caddy的情况下测试过。
PHP
MediaWiki 使用 PHP 编程语言编写,PHP 运行环境是必需的。
记住,虽然MediaWiki通过一个安装脚本来提供基于网络的最重要的东西的配置文件,但一些PHP基础将需要用来做更多的详细的个性化。
- 为了获得最新的稳定版本的MediaWiki,PHP版本7.3.19/7.4.3或更新的版本是必需的。 有关详细信息,请参阅兼容性 页面。
- 下列的 PHP 扩展是必需的:
- 注意所有的这些在PHP中都是默认启用的。
- 如果你没有可选的PHP intl扩展来处理Unicode规范化,MediaWiki的安装程序会发出警告。
- 在大多数基于Debian/Ubuntu的发行版中通常是php-intl包。
- 在大多数基于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)添加到要安装的功能中。
数据库服务器
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)来帮助管理数据库服务器。
硬件要求
运行一个单机网站的最低要求配置是 256MB 运行内存和 85MB 的储存空间。但是在大流量或者启用了上传功能的的网站上,这些配置可能完全不够。 一些用户也报告了在电脑上运行的 MediaWiki 最低可能只占用 48MB 运行内存。
对于开发人员安装,安装大小可以减少到大约50Mb,对于非开发人员的最终用户安装,大小可以减少到大约26Mb。 参见Manual:Reduce size of the installation
可选依赖
其他软件
- ImageMagick或GD被要求,如果需要使用Image thumbnailing 功能
- TeX被要求用来显示行内数学方程式。 在大部分基于Debian/Ubuntu的Linux发行版中, 这个软件存在于
texlive
软件包中。 - 为了使系统能够发送电子邮件,需要邮件传输代理(MTA)的功能配置(如Sendmail、Postfix或其他)。
- Shell访问被要求用于运行手册:维护脚本 ,这能使MediaWiki的升级工作更加轻松。
- GNU diff3 可以提供自动化来解决冲突的问题。
有关上述项目的更多信息,请参见手册:安装第三方工具 。
可视化编辑器
在MediaWiki 1.34及之前版本,VisualEditor 扩展(以及结构式讨论扩展,曾被称作“Flow”)需要Parsoid web 服务,这由Node.js实现。 大多数共享托管公司(HostGator、Bluehost、Dreamhost等)不提供Node.js。 出于性能和安全原因,最好使用专用托管解决方案,例如虚拟专用服务器(“VPS”)。
Scribunto
如果您希望从wiki页面和模板调用Lua模块(参见此wiki的例子),您的wiki也需要Scribunto。
参见
- 兼容性 ,了解Mediawiki的安装要求将来可能会如何变化的信息
- 手册:操作系统特定帮助
- MediaWiki主机服务和wiki农场
- 软件包