手册:安装 MediaWiki

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Installing MediaWiki and the translation is 100% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎yue • ‎čeština • ‎русский • ‎नेपाली • ‎中文 • ‎日本語 • ‎한국어
Mediawiki-logo.png 手册:安装指南 | 关于 MediaWiki
Help-browser.svg 功能列表 | 安装要求
Preferences-system.svg 下载 | 安装 | 配置


MediaWiki 可以通过内置的 Web 安装脚本完成安装。 参阅安装要求快速安装指南 获得准备环境来运行安装脚本的详细信息 .

如果没有 Apache, PHP 和 MySQL/MariaDB 的使用经验的话,安装 MediaWiki 可能会很吃力。 因此更多的用户可能会考虑使用 MediaWiki 托管服务 或者 预先配置的软件包.

Manual:Errors and Symptoms#Installation Errors 提供了排解一般安装问题的指导。

下载 MediaWiki 软件

前往 下载页面来下载: 对于用于生产环境的一般情况推荐使用当前的稳定版本。

在 *nix 系统上 下载 MediaWiki 当前的稳定版本 1.31.1, 可以通过以下命令完成:

wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.1.tar.gz

或者使用 cURL:

curl -O https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.1.tar.gz

下载的文件是 .tar.gz 格式,所以在使用前需要先从压缩文件中提取。 可以在本地提取并上传到服务器,或者上传压缩包然后在服务器上提取,或者直接在服务器上下载并提取. 在Windows上,这通常由7-Zip(免费)、WinZipWinRARIZArc(免费)来完成。 Linux 和 macOS 系统上可以通过这个命令来提取:

tar xvzf mediawiki-*.tar.gz
如果你以 root 用户提取文件,请考虑使用chown命令来修改文件的所有者,否则那些文件的所有者会是默认的 #1000。

开发者

为了即时跟踪最近的更改,开发者们请通过 Git 下载来建立本地存储库。 同时需要通过Composer安装必要的依赖。

上传文件到你的服务器

如果尚未将文件上载到Web服务器,请立即执行此操作。

通过以下方式将文件上传到Web服务器的Web目录:

  1. 直接复制解压的文件夹或
  2. 使用FTP客户端,如FileZilla(开源软件、Windows、OSX和Linux)或Cyberduck(OSX)。

如果您的上传工具有“将文件名更改为小写”选项,则必须禁用此选项。

如果您安装了Apache,则会在httpd.conf文件中指定正确的目录(它是DocumentRoot指令,通常是/var/www/<apache-folder>/htdocs)。 注意:这在Ubuntu 14.04 [与Apache 2.4.7的https://nixmash.com/post/changes-that-will-affect-you-in-apache-2-4-7/]中发生了变化,其中Apache服务器设置和目录的主要配置文件是/etc/apache2/apache2.conf

如果您使用的是Linux或Unix服务器,则可以将文件复制到服务器上的任何目录,然后从Web服务器的Web目录中为该文件夹创建。

将上传的文件夹重命名为您希望在URL中拥有的任何内容。 如果您的Web服务器以http://localhost运行,例如,重命名为/w/目录意味着你将在http://localhost/w/index.php访问你的wiki。 如果您希望将其用作缩短URL的话,不要使用/wiki/ (并且在运行安装脚本之前不要设置短URL。)

请注意,在某些情况下,例如在设置本地存储库使用Git时,在浏览到index.php时,Linux服务器可能会显示“500 Internal server Error”。 这可能是一个权限错误,可以通过在将目录更改为“w”后在SSH中运行以下命令来更改文件和目录权限时解决:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

此(重命名)文件夹现在将被称为<MediaWiki-folder>

创建数据库

如果您已有数据库服务器并且知道它的root密码,则MediaWiki安装脚本可以为您创建新数据库。 如果是这种情况,您可以跳到下面的运行安装脚本部分。 如果您不知道root密码,例如,如果您在托管服务器上,则必须立即创建新数据库。 目前,您必须使用SQLite、MariaDB、MySQL或PostgreSQL来存储Wiki的实际内容。

SQLite

SQLite是一个独立的数据库库,它将数据库内容存储在一个文件中。 如果 PHP 中启用了pdo-sqlite模块,那么没有什么其他步骤需要做的。

在安装页面上,您需要选择数据库名称(可以是任何内容)和SQLite数据库目录。 对于数据库目录,安装程序将尝试使用文档根目录之外的子目录,并在需要时创建它。 如果此目录不安全(例如Web可读),请手动更改它以避免Web上的每个人都可以访问它。

MariaDB/MySQL

MediaWiki将询问您是否有数据库和用户名,如果它们尚不存在,将尝试创建它们。 如果从MediaWiki这样做是不可能的,你可以使用各种控制面板,如,这些控制面板通常可以从共享主机获得,或者你可以使用SSH登录到您的主机并在MySQL提示符下键入命令。 请参阅相应的文档。 或者,与您的主机提供商联系,让他们为您创建一个帐户。

CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

如果您的数据库未在与Web服务器相同的服务器上运行,则需要提供相应的Web服务器主机名,以下示例中的mediawiki.example.com,如下:

GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';
警告 警告: UNIX/Linux上的MySQL/MariaDB将发送给它的所有查询记录到一个文件中,该文件将包含您用于该用户帐户的密码。 如果这与您有关,请在运行这些查询后删除.mysql_history文件。 此文件可以在您的主目录(~/.mysql_history)中找到。

PostgreSQL

如果您使用的是PostgreSQL,则需要为您创建数据库和用户,或者只是为配置表单提供具有“超级用户”权限的PostgreSQL用户的名称。 通常,这是名为postgres的数据库用户。

这是完成大部分设置的一种方法。 这用于类Unix系统。 在这个例子中,我们将创建一个名为wikidb的数据库,由名为wikiuser的用户拥有。 从命令行,作为postgres用户,执行以下步骤。

 createuser -S -D -R -P -E wikiuser (然后输入密码)
 createdb -O wikiuser wikidb

或者作为超级用户(默认postgres)在数据库提示符下执行以下命令:

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password';
CREATE DATABASE wikidb WITH OWNER wikiuser;

注意使用PostgreSQL运行MediaWiki时已知问题的列表

启动安装脚本

完成上述所有步骤后,您可以通过浏览器中的index.php通过Web浏览器完成安装:查看手册:初始配置 中提到的说明。

安装工具将提示您下载LocalSettings.php文件,并将其另存为<MediaWiki-folder>/LocalSettings.php

或者,您可以运行命令行安装程序或CLI:php maintenance/install.php添加适当的配置参数。


保持最新!

订阅我们的发布公告邮件列表。

安装后,请确保您及时了解版本,并确保您的服务器安全!

安装助理

参见