Руководство:update.php

Файл MediaWiki: update.php
Расположение:	maintenance/
Исходный код:	master • 1.43.1 • 1.42.6 • 1.39.12
Классы:	UpdateMediaWiki

Подробнее

Скрипт обслуживания update.php проверяет, если MediaWiki схема базы данных должна быть обновлена, чтобы работать с текущей версией mediawiki. Вы должны запустить update.php после каждого обновления mediawiki или после обновления, или установки расширения, которое требует обновления схемы. Для большинства расширений, которые требуют обновления схемы, это указано в их документации.

Этот скрипт обслуживания можно отключить с помощью$wgAllowSchemaUpdates . Людям с очень большими и загруженными вики, возможно, придется делать обновления с осторожностью, но если вы не уверены, относится ли это к вам, то, вероятно нет.

Использование

Внимание:

update.php может завершиться с ошибками, оставляя базу данных в несогласованном состоянии. Всегда делайте резервное копирование базы данных перед запуском скрипта!

Из браузера

Если Вы не имеете доступ к командной строке вашего сервера, можете использовать web updater, чтобы запустить скрипт обновления

→ Обновление через веб

Из командной строки

Используйте следующую команду из командной строки или оболочки SSH или аналогичной:

$ php maintenance/run.php update

Используйте следующее в экземплярах Vagrant (из вашего vagrant ssh).

$ mwscript update.php

Параметры

Этот скрипт предлагает несколько параметров (общих, зависящих от скрипта и специфичных для скрипта), которые могут потребоваться в некоторых средах вики.

Общие параметры обслуживания

--help

используется для получения подсказки обо всех доступных параметрах скрипта (общих, зависящих от скрипта и специфичных для скрипта) вместе с краткими пояснениями по их использованию. Это наименее используемый параметр.

--wiki wikiId

обновить семейство вики, если имя базы данных зависит от виртуального хоста, где wikiId - имя базы данных (например, enwiki, dewiki...)

--conf

Указывает файл конфигурации (файл LocalSettings.php для конкретной вики). Используется для вики-семейства.

Специальные параметры скрипта

--quick

пропуск обратного отчета

--initial

(введено в 1.43) Требуется ли первоначальное обновление после ручной установки с использованием tables-generated.sql

--doshared

Также обновить общие таблицы.

--noschema

Все изменения в структуре таблицы или добавления в таблицу пропускаются. Производятся только изменения данных.

--schema

В схемы базу данных не вносятся изменения, но изменения схемы сохраняются в отдельном файле SQL, который можно запустить.

Позволяет запускать "update.php", когда $wgAllowSchemaUpdates имеет значение false. Это полезно для сред, отличных от WMF, где строгие разрешения БД разрешают обновления базы данных (которые выполняет "update.php"), о не позволяют изменять схему (sнапример, добавлять или удалять таблицы или индексы, которые также выполняет "update.php").

--force

Запустите этот скрипт, даже если он отключен параметрами конфигурации.

--skip-external-dependencies

при использовании composer.local.json, чтобы разрешить Composer устанавливать расширения и их зависимости, вы можете увидеть сообщение об ошибке, говорящее о несоответствии между установленной и требуемой версией (например "mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required"). Вы можете использовать этот параметр, чтобы проигнорировать сообщение и запустить update.php в любом случае.

Внимание:

Рекомендуется использовать только разработчикам.

--skip-config-validation

(введено в 1.39) Пропускает проверку допустимости существующей конфигурации. В противном случае этот скрипт не будет запущен, если обнаружена недопустимая конфигурация.

--skip-compat-checks

(удалено в 1.41) Пропускает проверки совместимости (Gerrit change 851684)

--nopurge

(удалено в 1.36) не очищайте таблицу objectcache. Обычно update.php очищает таблицу objectcache (обычно содержит кэш синтаксического анализатора и кэш сообщений), msg_resource и msg_resource_links (они используются для кэширования сообщений Загрузчик ресурсов и очищаются в версии 1.21 и более поздних) в базе данных, если вы не хотите очистить эту таблицу, используйте параметр --nopurge.

Расширения могут устанавливать/обновлять свои схемы с помощью хука LoadExtensionSchemaUpdates .

См. также

• Manual:$wgDBadminuser и Manual:$wgDBadminpassword
• Для получения подробной инструкции по использованию update.php, см. Руководство:Обновление , Manual:Upgrading#Command_line