Обновление MediaWiki

Чтобы обновить MediaWiki, сделайте резервную копию, распакуйте новую версию в отдельную папку, перенесите туда свои файлы и запустите php maintenance/run.php update. Скрипт сам изменит таблицы базы под новую версию.

Что прочитать перед обновлением

В архиве каждой версии есть файлы RELEASE-NOTES и UPGRADE. В них написано, какие настройки переименованы или удалены и что изменилось в требованиях. Те же сведения есть на mediawiki.org на странице выпуска.

Проверьте и расширения. Сторонние расширения обновляются отдельно, и для новой версии движка может понадобиться их новая версия.

1. Сделайте резервную копию

Скрипт обновления меняет таблицы базы данных. Без копии вернуть всё как было не получится.

терминал
mysqldump -u wiki -p wiki > wiki-backup.sql

Это команда для MariaDB и MySQL: первое wiki — пользователь, второе — имя базы. Кроме базы, сохраните файлы:

  • LocalSettings.php;
  • папку images с загруженными файлами;
  • папки extensions и skins, если вы ставили туда что-то своё.

Подробнее о копиях — в Manual:Backing up a wiki.

2. Распакуйте новую версию в отдельную папку

Не распаковывайте архив поверх старой версии: в папке останутся удалённые в новой версии файлы, и они могут мешать. Распакуйте его рядом и перенесите в новую папку:

  • LocalSettings.php;
  • папку images;
  • свои расширения и темы оформления, которых нет в комплекте.

Расширения из комплекта брать из старой папки не нужно: в новом архиве уже лежат их версии для нового движка.

3. Обновите сторонние расширения

Для каждого стороннего расширения скачайте версию, которая подходит к новому движку. У расширений с mediawiki.org она обычно называется по ветке движка, например REL1_43.

4. Запустите скрипт обновления

Перейдите в корневую папку новой версии и выполните:

терминал
php maintenance/run.php update

Скрипт выждет несколько секунд перед началом. Ключ --quick убирает эту паузу. В старых инструкциях встречается команда php maintenance/update.php. Официальная инструкция для 1.43 запускает скрипт через run.php.

Когда скрипт закончит, переключите сайт на новую папку: например, переименуйте папки или поменяйте путь в настройках веб-сервера.

Важно. Запускайте скрипт после каждого обновления движка, даже небольшого. Без него новые файлы будут работать со старыми таблицами базы, и вики может выдавать ошибки.

Можно ли обновить без командной строки?

Можно. Откройте в браузере адрес вики с /mw-config/ в конце. Установщик найдёт старую базу и предложит обновить её. Он попросит ключ обновления: это значение $wgUpgradeKey из LocalSettings.php.

Что проверить после обновления

  • Откройте несколько статей и страницу правки.
  • На странице Служебная:Версия должна стоять новая версия движка и расширений.
  • Если ставили движок через Composer, обновите и его зависимости.

Если что-то сломалось, верните старую папку и восстановите базу из копии.

Из очень старых версий обновиться сразу до новой иногда нельзя, нужен промежуточный шаг. Проверьте это на странице Manual:Upgrading — там же полная официальная инструкция.

Краткая версия этой статьи — в ответе Как обновить MediaWiki?.

Что-то не сработало или устарело? Напишите в чат или предложите исправление.