手册:安装 MediaWiki

From mediawiki.org
This page is a translated version of the page Manual:Installing MediaWiki and the translation is 77% complete.
Outdated translations are marked like this.
Other languages:

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

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

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

下载 MediaWiki 软件

网页浏览器

从 official download page下载MediaWiki tar文件 Generally, if you're using a production environment, you want to be running the latest stable release, which is mediawiki-1.38.1.tar.gz.

Command line (*nix machine)

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

wget https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.1.tar.gz

或者使用 cURL:

curl -O https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.1.tar.gz

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

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


开发者

为了即时跟踪最近的更改，开发者们请通过 Git 下载来建立本地存储库。

同时需要通过Composer 安装必要的依赖。

上传文件到你的服务器

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

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

  1. 直接复制解压的文件夹或
  2. 使用FTP客户端，如FileZilla（开源软件、Windows、OSX和Linux）或Cyberduck（OSX）。
  3. by using cPanel File Manager (see below)

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

如果您安装了Apache，则会在httpd.conf文件中指定正确的目录（它是DocumentRoot指令，通常是/var/www/或<apache-folder>/htdocs）。 注意：这在Ubuntu 14.04 与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>。

cPanel File Manager

cPanel is a popular interface used by many web hosts. This method is efficient because the files are uncompressed on the server itself.

  • Navigate to the directory where you want your wiki folder.
  • Upload the mediawiki-1.xx.x.tar.gz file. You may need to hit "Reload" to see it.
  • Extract the mediawiki-1.xx.x.tar.gz file. Reload again.
  • Confirm that the mediawiki-1.xx.x folder is present.
  • Delete the tar.gz file.
  • Rename the mediawiki-1.xx.x folder to w.

创建数据库

如果您已有数据库服务器并且知道它的root密码，则MediaWiki安装脚本可以为您创建新数据库。 如果是这种情况，您可以跳到下面的运行安装脚本部分。 如果您不知道root密码，例如，如果您在托管服务器上，则必须立即创建新数据库。 目前，您必须使用SQLite、MariaDB、MySQL或PostgreSQL来存储Wiki的实际内容。 If you're unsure which database to choose, use MariaDB as it is the one best supported by MediaWiki.

SQLite

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

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

MariaDB/MySQL

MediaWiki将询问您是否有数据库和用户名，如果它们尚不存在，将尝试创建它们。 如果从MediaWiki这样做是不可能的，你可以使用各种控制面板，如PhpMyAdmin，这些控制面板通常可以从共享主机获得，或者你可以使用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文件，并将其另存为LocalSettings.php-path。

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

Further steps

These are optional but make your site look so much better.

保持最新！

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

安装助理

参见

Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:Installing_MediaWiki/zh&oldid=5196411"