手册:在Debian或Ubuntu上运行MediaWiki

This page is a translated version of the page Manual:Running MediaWiki on Debian or Ubuntu and the translation is 89% complete.

Outdated translations are marked like this.

This page documents how to install MediaWiki using the release tarballs. If you want to use system packages, and are not installing on Raspbian see Debian packages.

这个页面讲解如何在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是否是最新的：

sudo apt update
sudo apt upgrade

or in one line

sudo apt update && sudo apt upgrade

安装LAMP软件栈

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

sudo apt-get install apache2 mariadb-server php php-mysql libapache2-mod-php php-xml php-mbstring

Alternately you can use mysql (Raspberry Pi OS no longer supports mysql).

sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring

可选的有用软件包

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

名称	包名	说明
可选的 PHP 缓存	php-apcu	现代MediaWiki版本将自动利用此安装来提高性能。
PHP Unicode规范化	php-intl	如果不可用，MediaWiki将回退到较慢的PHP实现。
ImageMagick	imagemagick	图像缩略图。
Inkscape	inkscape	SVG缩略图的替代方法，比ImageMagick。有时，如果最初在Inkscape中创建，它将更好地渲染SVG。
PHP GD 库	php-gd	ImageMagick替代图像缩略图。
PHP command-line	php-cli	能够从命令行运行PHP命令，这对于调试和运行维护脚本很有用。
PHP cURL	php-curl	Required by some extensions such as Extension:數學 . See Manual:cURL
git source control version	git	如果不存在，配置脚本将告诉您它未安装
Basic Calculator	php-bcmath	In order to make the visualeditor work on 32bit machines, like a raspi

你可以通过sudo apt-get install packagename安装以上的任意一个包。

如果你想安装所有这些：

sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl php-bcmath git

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

sudo systemctl reload apache2

安装MediaWiki

下载官方压缩包。

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

cd /tmp/ wget https://releases.wikimedia.org/mediawiki/1.42/mediawiki-1.42.3.tar.gz

tar -xvzf /tmp/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki

配置MySQL

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

On Raspbian, if this is a new installation of mariadb you will also need to run: sudo mysqld_safe --skip-grant-tables --skip-networking &

你不得不：

创建一个新的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> commit;
mysql> quit;

可选操作：配置PHP

这些步骤是可选的，也可以在安装之后进行。没有这些改变MediaWiki也可以运行。

编辑你的 PHP 配置文件，php.ini 。 It is located at /etc/php/7.*/apache2/php.ini, depending on exact version of PHP.

最大上传文件大小

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

upload_max_filesize = 2M

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

内存限制

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

memory_limit = 8M

到

memory_limit = 128M

如果已设置为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

额外的 wiki 配置

基本信息

MediaWiki由LocalSettings.php文件配置，通常位于/var/lib/mediawiki中。 Manual:LocalSettings.php 包含可能有用的详细信息。以下是看似普遍有用的更改

要编辑LocalSettings.php使用

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

或者从终端

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

文件上传

参见手册:配置文件上传。

更改Logo

参见手册:$wgLogos (1.35+) 或手册:$wgLogo 。

MediaWiki扩展

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

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

美化URLs

要在Debian上使用/wiki/*而不是/wiki/index.php/*，请使用/mediawiki<推荐的短网址指南作为脚本路径而不是/w并将重写放在/etc/apache2/conf-enabled/mediawiki.conf中。

参阅

Canonical维护MediaWiki页面提供更多信息
Debian MediaWiki专页