Manual:Running MediaWiki on Debian or Ubuntu/ru

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/ru.

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

Введение

Процедура установки требует умения работать с терминалом (например, для установки приложений) и текстовым редактором (графические: 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 update && sudo apt upgrade

Установка LAMP Stack

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

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

Альтернотивно при использовании mysql (Raspberry Pi OS больше не поддерживает mysql)

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

Дополнительные полезные пакеты

Перечисленные ниже пакеты не являются обязательными, но могут быть полезны, в зависимости от установки:

Название	Пакет	Описание
Альтернативные кеши PHP	php-apcu	Последние версии MediaWiki автоматически воспользуются этой возможностью для повышения производительности.
Оптимизация юникода в PHP	php-intl	При недоступности пакета MediaWiki вернется к более медленной реализации PHP.
ImageMagick	imagemagick	Создание уменьшенных версий изображения
Inkscape	inkscape	Альтернатива ImageMagick для создания миниатюр SVG. Зачастую это улучшает работу с SVG, если они созданы в Inkscape.
PHP GD library	php-gd	Альтернатива ImageMagick для миниатюр изображений.
PHP command-line	php-cli	Возможность запуска команд PHP из командной строки для отладки и запуска обслуживающих скриптов.
PHP cURL	php-curl	Required by some extensions such as Расширение:Math . See Manual:cURL
git source control version	git	If not present config script will tell you that it is not installed
Basic Calculator	php-bcmath	In order to make the visualeditor work on 32bit machines, like a raspi

Вы можете установить любой из вышеперечисленных пакетов 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 php-bcmath 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 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

Configuring MySQL

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

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

You will have to:

create a NEW mysql user (new_mysql_user):

# sudo mysql -u root -p 
Enter password: Enter password of mysql root user (if you have not configured password it will be blank, so just press enter)
mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';
mysql> quit;

create a NEW mysql database my_wiki:

# sudo mysql -u root -p
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> 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 в качестве контента, необходимо скорректировать ограничение на максимальный размер загрузки. 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

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.

Некоторые причины ошибок работы установщика могут быть указаны там.

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

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

Заполните форму настройки и продолжайте. Use the username and password which you provided as above 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. В Руководство:LocalSettings.php есть подробная информация, которая может быть полезной. Ниже указаны настройки для изменения внешнего вида, которые могут быть полезны для всех.

Для редактирования файла LocalSettings.php используйте

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

или в терминале

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

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

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

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

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

Расширения MediaWiki

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

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

Красивые URL

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

Смотрите также

Canonical maintains a MediaWiki page with more information

Информация о MediaWiki на Debian wiki