手册:在Debian或Ubuntu上运行MediaWiki

From mediawiki.org
This page is a translated version of the page Manual:Running MediaWiki on Debian or Ubuntu and the translation is 93% complete.
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/LinuxUbuntu服务器上安装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 using 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 service apache2 reload


安装MediaWiki

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

cd /tmp/ wget https://releases.wikimedia.org/mediawiki/1.40/mediawiki-1.40.1.tar.gz

  • 解压到你的Web目录里
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中。 手册:LocalSettings.php 包含可能有用的详细信息。 以下是看似普遍有用的更改

要编辑LocalSettings.php使用

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

或者从终端

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

文件上传

参见手册:配置文件上传

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

MediaWiki扩展

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

有关如何启用扩展程序的说明,参见手册:扩展

美化URLs

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

參見