手册:在Debian或Ubuntu上运行MediaWiki

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Running MediaWiki on Debian or Ubuntu and the translation is 100% complete.

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎polski • ‎русский • ‎中文 • ‎日本語 • ‎한국어
安装指导
FreeBSD
GNU/Linux
- ALT Linux
- Arch Linux
- Damnsmalllinux
- Debian or Ubuntu
- Fedora
- Gentoo
- Mandriva
- Red Hat Enterprise Linux or CentOS
- Slackware
Mac OS X
NetWare
Solaris
- Solaris 11 / opensolaris
- Solaris 10
Windows
- Windows Server 2016
一键
- Uniform Server
- XAMPP
Sourceforge.net
This page documents how to install MediaWiki using the release tarballs. If you want to use system packages, see User:Legoktm/Packages.

这个页面讲解如何在Debian GNU/Linuxw:zh: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-get update && sudo apt-get upgrade


安装LAMP软件栈

使LAMP(Apache、PHP和MySQL)在安装过程中可供安装。

在安装步骤中,请确保选择安装LAMP服务器。 或者,您可以使用以下命令从标准安装中安装所有这些软件包:

Ubuntu 16.04.2 LTS(Xenial)和Debian Stretch包括PHP 7.0,并将许多软件包从“php5”重命名为plain“php”。 此外,一些PHP模块现在位于不同的包中(xml、mbstring)。
sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring
Ubuntu Trusty,Debian Jessie和Raspbian(Jessie)包括PHP 5,并在大多数(但不是全部)软件包中使用“php5”。
sudo apt-get install apache2 mysql-server php5 php5-mysql libapache2-mod-php5

可选的有用软件包

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

名称 包名 说明
可选的 PHP 缓存 php-apcu or php5-apcu 现代MediaWiki版本将自动利用此安装来提高性能。
PHP Unicode规范化 php-intl or php5-intl 如果不可用,MediaWiki将回退到较慢的PHP实现。
ImageMagick imagemagick 图像缩略图。
Inkscape inkscape SVG缩略图的替代方法,比ImageMagick。 有时,如果最初在Inkscape中创建,它将更好地渲染SVG。
PHP GD 库 php-gd 或 php5-gd ImageMagick替代图像缩略图。
PHP command-line php-cli 或 php5-cli 能够从命令行运行PHP命令,这对于调试和运行维护脚本很有用。
PHP cURL php-curl 或 php5-curl 某些扩展名要求,例如Extension:Math,见Manual:cURL
git source control version git 如果不存在,配置脚本将告诉您它未安装

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

如果你想安装所有这些:sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl git 如果安装php-apcu,则必须重新加载apache配置,以避免在运行配置脚本时出现警告消息:

sudo service apache2 reload

安装MediaWiki

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

    cd /tmp/
    wget https://releases.wikimedia.org/mediawiki/1.33/mediawiki-1.33.0.tar.gz
  • 解压到你的Web目录里
tar -xvzf /tmp/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki


配置MySQL

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

你不得不:

  • 创建一个新的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
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

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

编辑你的 PHP 配置文件,php.ini。 在Ubuntu Trusty和Debian Jessie上,这个文件位于/etc/php5/apache2/php.ini

On Ubuntu Xenial and Debian Stretch (PHP 7), it is located at /etc/php/7.0/apache2/php.ini.

最大上传文件大小

假设要将各种文件上传到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
  • 密切注意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


文件上传

参见手册:配置文件上传

参见手册:$wgLogo

MediaWiki扩展

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

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

美化URLs

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

參見