Manual:Running MediaWiki on Debian or Ubuntu/zh

这个页面讲解如何在Debian GNU/Linux或Ubuntu服务器上安装MediaWiki. 下面是以Debian为例进行说明，也适用于Ubuntu和Raspbian，不一样的地方会特别标明.

介绍
该安装过程需要知道从终端发出命令（例如安装应用程序）和使用文本编辑器（例如图形：gedit、kate；文本：nano、emacs、vim）.

当需要进行文本编辑时，可以通过按Alt-F2并键入来在图形桌面上执行

gksudo gedit 文件名

或者，可以从终端进行编辑

sudo nano 文件名

当然，可以使用kate代替gedit或vi/emacs而不是nano.

确保您的Debian系统是最新的
通过运行来仔细检查Debian是否是最新的：

or in one line

安装LAMP软件栈
Ubuntu使LAMP（Apache、PHP和MySQL）在安装过程中可供安装. 在安装步骤中，请确保选择安装LAMP服务器. 或者，您可以使用以下命令从标准安装中安装所有这些软件包：

可选的有用软件包
这些包不是必需的，但可能有用，具体取决于安装：

你可以通过 安装以上的任意一个包.

如果你想安装所有这些：

如果安装php-apcu，则必须重新加载apache配置，以避免在运行配置脚本时出现警告消息：

安装MediaWiki

 * 下载官方压缩包.

这可以通过浏览器或命令行完成


 * 解压到你的Web目录里

配置MySQL
但在继续安装最初的MediaWiki之前，您需要先执行某些步骤！

On Raspbian, if this is a new installation of mariadb you will also need to run:

你不得不：


 * 创建一个新的mysql用户（new_mysql_user）：

# sudo mysql -u root -p 输入密码：输入mysql root用户的密码（如果你没有配置密码，它将为空，所以只需按回车键） mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED'; mysql> quit;


 * 创建一个新的mysql数据库my_wiki：

# sudo mysql -u root -p mysql> CREATE DATABASE my_wiki; mysql> use my_wiki; Database changed


 * 授予新的mysql用户访问新创建的mysql数据库my_wiki：

mysql> GRANT ALL ON my_wiki.* TO 'new_mysql_user'@'localhost'; Query OK, 0 rows affected (0.01 sec) mysql> quit;

可选操作：配置PHP
编辑你的 PHP 配置文件，php.ini. It is located at, depending on exact version of PHP.

最大上传文件大小
假设要将各种文件上传到Wiki作为内容，则必须调整上传文件的最大大小限制. 大约在文件上传小节的下半部分. 修改以下语句：

将上传大小上限调整到至少20M. 将来你需要上传更大的文件时，你可能需要再次调整这个值.

内存限制
一些 PHP 脚本运行时需要很多内存. 要增加脚本可以使用的最大内存量，请向下翻页约21％，并从中更改以下条目（如果找到）

到

如果已设置为128M或更高，请保持原样.

配置MediaWiki
将浏览器导航到http://localhost/mediawiki（对于某些安装，可能是http://localhost/mediawiki/config或http://wiki.hostname.com/config），并按照给定的步骤进行操作.

如果这给出了404错误，则使用符号链接应解决它：

sudo ln -s /var/lib/mediawiki /var/www/html/mediawiki

For Debian based systems running apache2, once you create a symbolic link in the /var/www/html directory you may still run into a 404 error. If this happens, try loading: localhost/html/mediawiki/.


 * 密切注意MediaWiki安装脚本中的检查环境....

这可以通过专门识别任何错误的来源来解决许多问题.

它可能会抱怨像mbstring和xml这样的php扩展都会丢失，即使你已经安装了它们. 请使用以下方法手动激活它们：

sudo phpenmod mbstring sudo phpenmod xml sudo systemctl restart apache2.service

填写配置表单中的所有字段，然后按继续按钮. 您将不得不使用mysql配置部分中提供的用户名和密码：

mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';

在数据库配置下，您可能将数据库名称和数据库用户名更改为新值，但您必须打开“使用超级用户帐户”，名称：

debian-sys-maint

给出之前配置的mysql root密码.

配置过程将提示您下载必须保存到新Wiki的父目录的“LocalSettings.php”. 配置页面将提供必须移动的确切目录/文件名：

sudo mv ~/Downloads/LocalSettings.php /var/lib/mediawiki/

然后将浏览器导航到http://localhost/mediawiki（或http://server_ip_address/mediawiki或http://server_ip_address/mediawiki/index.php）以查看您的新wiki.

完成！ 你现在有了一个可正常运行的 Wiki

基本信息
MediaWiki由LocalSettings.php文件配置，通常位于 中. 包含可能有用的详细信息. 以下是看似普遍有用的更改

要编辑LocalSettings.php使用

gksudo gedit /var/lib/mediawiki/LocalSettings.php

或者从终端

sudo nano /var/lib/mediawiki/LocalSettings.php

文件上传
参见.

更改Logo
参见.

MediaWiki扩展
MediaWiki的当前tarball附带了15个左右最受欢迎的扩展程序包，但实际上还有数百个.

有关如何启用扩展程序的说明，参见.

美化URLs
要在Debian上使用/wiki/*而不是/wiki/index.php/*，请使用 作为脚本路径而不是 并将重写放在/etc/apache2/conf-enabled/mediawiki.conf中.

參見

 * Canonical维护MediaWiki页面提供更多信息
 * Debian MediaWiki专页
 * Ubuntuguide.org提供了在Ubuntu和Kubuntu上设置MediaWiki的详细说明，包括多个wiki和嵌套的subwikis.