Manual:Installing MediaWiki/zh

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

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

下载 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.

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

tar -xf mediawiki-*.tar.gz

上传文件到你的服务器
如果尚未将文件上载到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 web hosting control panel software used by many web hosts.


 * 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 mediawiki-1.xx.x.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 中启用了 模块，那么没有什么其他步骤需要做的.

在安装页面上，您需要选择数据库名称（可以是任何内容）和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浏览器完成安装：查看中提到的说明.

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

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

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



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

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

安装助理

 * 阅读有关安装和配置的常见问题.
 * MediaWiki installation errors
 * Ask questions and receive help about installing MediaWiki

参见

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