前言

MediaWiki 的功能非常强大，一篇千余字的短文很难完整表达清楚。如果你无意中进入，对它产生了兴趣，它就能带你进入一个广袤的维基世界。而对于已经是资深的 wiki 玩家，也欢迎在评论中指正文章中的错误，我会很感激并且及时修改。

Wiki 与 MediaWiki

什么是 MediaWiki?

MediaWiki 是一个使用 PHP 语言编写的最初为维基百科量身打造的免费开源的 wiki 系统。互联网上的其他许多 wiki 网站以及 MediaWiki 主页都建立在这套开源免费的软件之上。

Wiki 是一种在互联网上开放且多人协作的超文本系统，可让知识传播下去。

为什么使用 MediaWiki?

MediaWiki 最主要最正规的用途是归档知识，可用于知识库和交流的平台。

不过别忘了，实现 Wiki 功能的系统不止 MediaWiki 一种，它之所以最出名完全是因为维基百科——它用了 MediaWiki，以及它开源的特点让全世界的人都可以优化代码。虽然国内关于 MediaWiki 的资料不多，但它良好的开放性让你可以轻松地从其他采用该系统的网站上查看代码和内容，以快速理解条目编辑、模板创建等工作。如果愿意，你甚至可以直接复制需要的代码到你的网站。并且，MediaWiki 官方也提供了很多教程的中文版。（只是措辞神似机器翻译）

此外，强大的扩展功能也能让网站变得更出色，事半功倍。只是别忘了，MediaWiki 的初衷是收集和整理知识，如果你想让他成为一个微信那样的全方位平台，可能违背了 wiki 的精神。

建议：

如果你从未使用过 wiki 系统就想采用 MediaWiki，强烈建议你先在维基百科上试用各种功能并阅读基本操作手册。（MediaWiki 的水挺深）

安装 MediaWiki

本教程默认你已经熟知并理解了以下内容：

1. 在 Ubuntu 下的操作可能和其它操作系统不同。

2. 安装过程中会有提示，务必仔细阅读！

3. 所有设置均会储存在 Localsettings.php 中，可随时修改。

4. 本教程默认你的服务器和数据库的搭建都是主流且配置正确的。

5. 网站根目录也叫 {{ROOT}}；MediaWiki 安装目录也叫 {{MW}}；网站域名叫 {{DOMAIN}}。

6. 你的 PHP 扩展安装齐全。

你可以在官网下载最新版本的 MediaWiki（本文发布时已升级至 1.40 版，1.41 是预览版）。

注：从 MediaWiki 1.31 开始，需要 PHP 7.0 以上版本，无法在更低版本上安装。

将压缩包解压到 {{ROOT}}/wiki，浏览器打开会看到这个界面（强烈不建议直接解压在根目录下——MediaWiki 官方）：

提示没有配置文件 LocalSettings.php（这是 MediaWiki 的主配置文件，后面会详细说明），我们逐步生成该文件完成配置。

点击 “继续安装”，进入语言设置界面，MediaWiki 支持 350+ 种语言，中文就有 9 种（这个页面也可以在地址栏直接输入 {{DOMAIN}}/{{MW}}/mw-config/index.php 下访问）。

默认选择中文，点击继续。

这是环境检查，MediaWiki 1.40 的必要配置要求：

• PHP 7.4.3+
• Web 服务器软件
• MariaDB 10.3.0+、 MySQL 5.7.0+、 SQLite 3.8.0+ 或 PostgreSQL 10.0+。

最新的具体要求可在官网查看。警告建议是为了系统全功能稳定运行，点击继续。

接下来配置数据库，如果直接使用 root 账号且密码正确，会自动生成数据库。但建议单独创建账户和数据库，减少风险；或者下一步新建用户。

如果之前直接使用 root 用户，这一步最好新建一个权限较低的账号保证数据库安全。如果本身就是权限较低的数据库管理账号，则继续使用即可。

这里我新增账号并设置密码，然后继续安装。

给你的网站和管理员账户取一个飒名字。

“项目命名空间”可能会让你疑惑，建议使用默认。如果玩过维基百科，就知道很多“维基百科：”开头的条目是站点使用和管理内容，这就是项目命名空间。

如果不明白该选什么，直接点击“我已不耐烦，赶紧安装”，完成基本安装。

或者，如果你充满好奇，继续往下看：

其他保持默认即可。扩展程序中，建议选择“引用”、“解析器函数”、“反垃圾”和“Wiki 编辑器”，这些后面会详细介绍。

如果不知道该选什么，没关系，后面会讲解开启这些扩展。

所有准备就绪后，点击继续，可能直接进入配置完成页面。页面中的文本框可添加你想要的配置，我们直接点击继续。

提示下载 LocalSettings.php 文件，保存后添加到 Wiki 根目录下。

重新输入网址，如果看到类似下图，恭喜你，安装成功!

提示：如果想重新配置，可在浏览器输入{{DOMAIN}}/{{MW}}/mw-config/index.php，点击“重新安装”。当然，你也可以通过下面的内容进一步设置。

注意：完成配置后，强烈建议禁止访问 mw-config 目录，防止被有心人利用。

MediaWiki 简单设置

大部分设置在安装过程中已配置并保存在 LocalSettings.php 文件，我们着重介绍几个常用变量（新安装用户可在首页“新手入门”的第一项中查看详细说明）。

（此图引用自知乎）

注意：登录后右上角有“个人设置”，其中调整的是你个人的内容（如语言、皮肤等），不影响其他用户，不要和系统设置混为一谈。

如何安装 MediaWiki 扩展?

MediaWiki 的强大之处在于大量插件。打开维基百科的版本页面，你会看到它使用的所有扩展。

如果你的目标是做一个类似维基百科的网站，直接照着它的扩展下载安装即可。我们介绍几个常用的：

基本说明：

• 下载的扩展包解压后上传到 {{ROOT}}/{{MW}}/extensions/ 目录
• 在 LocalSettings.php 文件中添加启用代码即可启用

1. 引用扩展（Cite）

描述：增加 <ref> 和 <references/> 标签用于文章引用。

效果：

说明：<ref>标签内的引用会自动编号并汇总，<references/>以列表形式显示。

启用：

wfLoadExtension( 'Cite' );

2. 解析器函数（ParserFunctions）

描述：增加解析器逻辑函数。

说明：ParserFunctions 提供 11 个附加解析函数，补充 MediaWiki 内置的“魔术字”。在维基百科模板中，像#ifeq：、#ifexist：的内容就是解析器函数。无论直接使用还是制作模板，这些函数都很有用。

启用：

wfLoadExtension( 'ParserFunctions' );

3. ElasticaSearch（不好安装）

描述：提供额外的维基文本搜索结果。

效果：

如同百度、Google 的搜索体验。

说明：相比 MediaWiki 原始的搜索，这极大地提高了搜索体验。

启用：

参见Elastica

3. Wiki 编辑器（WikiEditor）

描述：提供可扩展的维基文本编辑界面和组件。

效果：

说明：相比 MediaWiki 原始的编辑器极大地提高了效率。但可视化编辑器。

启用：

wfLoadExtension( 'WikiEditor' );

后记

事实上，你平时浏览的萌娘百科、BWIKI 都是 MediaWiki 的衍生。有钱的话，记得赞助以下 MediaWiki 官方。

相关链接

MediaWiki短链接伪静态设置（通用）