Manual:Installing MediaWiki/zh

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

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

Web browser
Download the MediaWiki tar file from the official download page. Generally, if you're using a production environment, you want to be running the latest stable release, which is mediawiki-.tar.gz.

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

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

或者使用 cURL:

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

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

tar xvzf mediawiki-*.tar.gz

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

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

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


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

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

如果您安装了Apache，则会在 文件中指定正确的目录（它是DocumentRoot指令，通常是 或 ）. 注意：这在Ubuntu 14.04 与Apache 2.4.7的中发生了变化，其中Apache服务器设置和目录的主要配置文件是.

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

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

此（重命名）文件夹现在将被称为 .

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.

创建数据库
如果您已有数据库服务器并且知道它的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 中启用了 模块，那么没有什么其他步骤需要做的.

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

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

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

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

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

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

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

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

启动安装脚本
完成上述所有步骤后，您可以通过浏览器中的index.php通过Web浏览器完成安装：查看中提到的说明.

安装工具将提示您下载文件，并将其另存为.

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

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


 * Logo
 * favicon.ico

保持最新！
订阅我们的发布公告邮件列表.

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

安装助理

 * 阅读有关安装和配置的常见问题.
 * 与MediaWiki开发人员、系统管理员和用户聊天：
 * mediawiki-l邮件列表是要求支持的高流量列表.

参见

 * - 列出MediaWiki消息链接到的Wiki页面，您需要创建这些页面或编辑消息.
 * - 用于链接到更高级的配置.
 * - 用于具有更多用户友好的URL到文章页面.
 * - 使用单组MediaWiki文件设置MediaWiki的多个实例.