Обновление 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?.
Что-то не сработало или устарело? Напишите в чат или предложите исправление.