Руководство:Установка MediaWiki на Debian или Ubuntu
Поступило предложение об объединении этой страницы или раздела с Manual:Installing MediaWiki.(Обсудить) |
На этой странице объясняется, как установить 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
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 библиотека | php-gd | Альтернатива ImageMagick для миниатюр изображений. |
| PHP command-line | php-cli | Возможность запуска команд PHP из командной строки для отладки и запуска обслуживающих скриптов. |
| PHP cURL | php-curl | Требуется для некоторых расширений, таких как Расширение:Math. См. 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.43/mediawiki-1.43.0.tar.gz
- распаковать в вашу папку Web
tar -xvzf /tmp/mediawiki-*.tar.gz
sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki
Настройка MySQL
Но прежде чем начать установку MediaWiki, есть определенные шаги, которые вам нужно сперва сделать!
На Raspbian, если это новая установка mariadb, вам также потребуется запустить:
sudo mysqld_safe --skip-grant-tables --skip-networking &
Вам придется:
- создать НОВОГО пользователя mysql (new_mysql_user):
# sudo mysql -u root -p Введите пароль: Введите пароль root-пользователя MySQL (если вы не настроили пароль, он будет пустым, поэтому просто нажмите Enter) 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
Отредактируйте конфигурационный файл PHP, php.ini.
Он расположен по адресу /etc/php/8.*/apache2/php.ini, в зависимости от конкретной версии 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.
Некоторые причины ошибок работы установщика могут быть указаны там.
Например, указания на отсутствие расширений php (mbstring, xml), даже если вы их установили. Включите их вручную, воспользовавшись:
sudo phpenmod mbstring sudo phpenmod xml sudo systemctl restart apache2.service
Заполните форму настройки и продолжайте. Используйте имя пользователя и пароль, которые вы указали выше в разделе конфигурации MySQL:
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
Загрузка файлов
Смотрите Руководство:Настройка загрузки файлов.
Изменение логотипа
См. Руководство:$wgLogos (1.35+) или Описание:$wgLogo.
Расширения MediaWiki
В указанном выше архиве Mediawiki поставляется с пакетом около 15 самых популярных расширений, однако их существует несколько сотен.
Инструкции, о том как включить расширение, можно найти в Руководство:Расширения.
Красивые URL
Чтобы использовать /wiki/* вместо /wiki/index.php/* на Debian, следуйте рекомендациям по использованию коротких адресов URL, используйте '/mediawiki' в качестве пути к скрипту вместо '/w' и укажите эту замену в /etc/apache2/conf-enabled/mediawiki.conf.
Смотрите также
- Canonical поддерживает страницу MediaWiki с дополнительной информацией
- Информация о MediaWiki на Debian wiki