手册:安装要求
除了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或更新的版本是必需的。 有关详细信息,请参阅兼容性 页面。
- 下列的 PHP 扩展是必需的:
- 一般来讲,所有的这些在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
- In Debian/Ubuntu, the following command can install PHP and the extensions listed above:
- 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,请考虑这一点。
如果需要从源代码编译PHP,请参阅PHP 配置 以获取影响MediaWiki的编译选项。
数据库服务器
MediaWiki将所有文本和数据(内容页面、用户详细信息、系统消息等)存储在数据库中,该数据库能够与其他基于Web的应用程序(phpBB等)共享。您将需要以下数据库服务器中的“一个”来运行最新版本的MediaWiki:
建议使用MariaDB或MySQL,维基媒体使用MariaDB。 其他的数据库服务器经历了更少的测试,你更有可能遇到软件缺陷。
硬件要求
运行一个单机网站的最低要求配置是 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的安装要求将来可能会如何变化的信息
- 手册:操作系统特定帮助