Manual: Установка MediaWiki под Debian или Ubuntu

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 77% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎polski • ‎русский • ‎中文 • ‎日本語 • ‎한국어
Installation guides
FreeBSD
GNU/Linux
- ALT Linux
- Arch Linux
- Damnsmalllinux
- Debian or Ubuntu
- Fedora
- Gentoo
- Mandriva
- Red Hat Enterprise Linux
- Slackware
Mac OS X
NetWare
Solaris
- Solaris 11 / opensolaris
- Solaris 10
Windows
- Windows Server 2016
on a stick
- 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.

На этой странице объясняется, как установить MediaWiki на сервер Debian или Ubuntu GNU/Linux. Приведённые ниже инструкции относятся к Debian. Если не написано каких-либо заметок, то также подходит для Ubuntu или Raspbian.

Introduction

Процедура установки требует умения работать с терминалом (например, для установки приложений) и текстовым редактором (графические: gedit, kate; текстовые: nano, emacs, vi).

Если требуется редактировать текст, то это можно сделать в графическом рабочем столе, нажав Alt-F2 и набрав

    gksudo gedit filename

Иначе редактирование текста можно сделать из терминала

    sudo nano filename

Конечно же, вы можете использовать другие текстовые редакторы, например, kate вместо gedit или vi вместо nano.

Шаг за шагом

Убедитесь, что Debian обновлен

Дважды проверьте, что Debian обновлен, выполнив команды:

sudo apt update
sudo apt upgrade

or in one line

sudo apt-get update && sudo apt-get upgrade


Установка LAMP Stack

Серверная версия Ubuntu позволяет выбрать установку LAMP (Apache, PHP и MySQL) во время установки дистрибутива. Убедитесь, что вы выбрали установку сервера LAMP. Иначе, при обычной установке, можно установить все эти пакеты используя следующие команды:

Ubuntu 16.04.2 LTS (Xenial) и Debian Stretch включают PHP 7.0. Множество пакетов переименованы с «php5» на просто «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 php-intl or php5-intl При недоступности пакета MediaWiki вернется к более медленной реализации PHP.
ImageMagick imagemagick Создание уменьшенных версий изображения
Inkscape inkscape Альтернатива ImageMagick для создания миниатюр SVG. Зачастую это улучшает работу с SVG, если они созданы в Inkscape.
PHP GD library php-gd or php5-gd Альтернатива ImageMagick для миниатюр изображений.
PHP command-line php-cli or php5-cli Возможность запуска команд PHP из командной строки для отладки и запуска обслуживающих скриптов.
PHP cURL php-curl or php5-curl Required by some extensions such as Extension:Math. See Manual:cURL
git source control version git If not present config script will tell you that it is not installed

Вы можете установить любой из вышеперечисленных пакетов sudo apt-get install packagename.

If you want to install all of them: sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl git If you install php-apcu you will have to reload your apache configuration in order to avoid a warning message when running configuration script:

sudo service apache2 reload

Получить MediaWiki

Это можно сделать в браузере или из командной строки:

    cd /tmp/
    wget https://releases.wikimedia.org/mediawiki/1.32/mediawiki-1.32.1.tar.gz
  • распаковать в вашу папку Web
tar -xvzf /tmp/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki


Configuration mysql

But before proceeding with the initial MediaWiki installation, there are certain steps you need to do first!

You will have to:

  • create a NEW mysql user (new_mysql_user):
# sudo mysql -u root -p and enter password of mysql root user (if you have no configured password it will be empty, so just press return)
mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';
mysql> quit;
  • create a NEW mysql database my_wiki:
# sudo mysql -u root
mysql> CREATE DATABASE my_wiki;
mysql> use my_wiki;
Database changed
  • GRANT the NEW mysql user access to the NEW created mysql database 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 в качестве контента, необходимо скорректировать ограничение на максимальный размер загрузки. About one-half way down is the File Uploads section. Измените:

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. Некоторые причины ошибок работы установщика могут быть указаны там.

Например, указания на отсутствие расширений php (mbstring, xml), даже если вы их установили. Включите их вручную, воспользовавшись:

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

Заполните форму настройки и продолжайте.

You will have to use your username and password provided in the mysql configuration section:

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

В разделе Конфигурация базы данных вы можете изменить название базы данных и имя пользователя БД на новые значения, вы должны включить "Use superuser account" с именем:

debian-sys-maint

подтвердив действия паролем пользователя root, заданным раньше.

В процессе установки вам предложат скачать файл LocalSettings.php, который должен быть сохранен в родительской директории новой wiki. На странице конфигурации будет точный путь директория/имя файла, где должен быть помещен файл:

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

Затем перейдите в браузере по адресу http://localhost/mediawiki (или http://ip_адрес_сервера/mediawiki или http://ip_адрес_сервера/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


Загрузка файлов

См. Manual:Настройка загрузки файлов .

Изменение логотипа

См. Описание:$wgLogo .

Расширения MediaWiki

В указанном выше архиве Mediawiki поставляется с пакетом около 15 самых популярных расширений, однако их существует несколько сотен.

Инструкции, о том как включить расширение, можно найти в Manual:Расширения .

Красивые URL

Чтобы использовать /wiki/* вместо /wiki/index.php/* на Debian, следуйте рекомендациям по использованию коротких адресов URL, используйте '/mediawiki' в качестве пути к скрипту вместо '/w' и укажите эту замену в /etc/apache2/conf-enabled/mediawiki.conf.

См. также