手册:在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 92% complete.
Outdated translations are marked like this.
Languages:
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 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 systemctl reload apache2


安装MediaWiki

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

cd /tmp/ wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.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中。 Manual: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个左右最受欢迎的扩展程序包，但实际上还有数百个。

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

美化URLs

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

参阅

Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:Running_MediaWiki_on_Debian_or_Ubuntu/zh&oldid=6386183"