Podręcznik:Update.php

Plik MediaWiki: update.php
Lokalizacja:	maintenance/
Kod źródłowy:	master • 1.44.0 • 1.43.3 • 1.39.13
Klasy:	UpdateMediaWiki

Szczegóły

Skrypt konserwacyjny update.php sprawdza, czy schemat bazy danych MediaWiki wymaga aktualizacji, aby działał z aktualną wersją MediaWiki. Powinieneś uruchomić update.php po każdej aktualizacji MediaWiki lub po aktualizacji lub instalacji rozszerzeń, które wymagają zmiany schematu bazy. Większość takich rozszerzeń wspomina o tym w swojej dokumentacji.

Ten skrypt konserwacyjny można wyłączyć za pomocą $wgAllowSchemaUpdates . People with extremely large and busy wikis may need to do upgrades with care, but if you're not sure if that applies to you, then it probably doesn't.

Usage

Uwaga:

update.php może zakończyć się błędem, pozostawiając bazę danych w stanie niespójnym. Zawsze utwórz kopię zapasową bazy danych przed uruchomieniem skryptu!

W przeglądarce

Jeżeli nie masz dostępu do wiersza poleceń swojego serwera, użyj aktualizatora webowego do uruchomienia tego skryptu aktualizującego.

→ Aktualizator webowy

Z wiersza poleceń

Z wiersza poleceń, SSH lub podobnego:

Wersja MediaWiki:

≥ 1.40

$ php maintenance/run.php update

Wersja MediaWiki:

≤ 1.39

$ php maintenance/update.php

Use the following on Vagrant instances (from within your Vagrant SSH).

$ mwscript update.php

Parametry

This script offers several parameters (generic, script-dependent, and script-specific) that may be required in some wiki environments.

Generic maintenance parameters

--help

used to get a prompt of all available script parameters (generic, script dependent, and script specific) together with short explanations of their usage. Są to rzadziej stosowane parametry.

--wiki wikiId

update wiki family if database name depends on a virtual host, where wikiId - database name (e.g., enwiki, dewiki ...)

--conf

Specifies the config file (the LocalSettings.php file for the specific wiki). Used for wiki families.

Script specific parameters

--quick

skip countdown sequence

--initial

(wprowadzono w 1.43) Do initial updates required after manual installation using tables-generated.sql

--doshared

Update shared tables as well.

--noschema

All changes to the table structure or table additions are skipped. Only data changes are made.

--schema

No schema changes are made to the database, but the schema changes are saved to a separate SQL file that can be run.

Allows "update.php" to be run when $wgAllowSchemaUpdates is set to false. This is useful for non-WMF environments where strict DB permissions allow database updates (which "update.php" performs), but no schema changes (such as adding or dropping tables or indexes, which "update.php" also performs).

--force

Uruchamia skrypt, nawet jeśli jest wyłączony w opcjach konfiguracyjnych.

--skip-external-dependencies

when using composer.local.json to let Composer install extensions and their dependencies, you may see an error message saying that there is a mismatch between the installed and required version (e.g. "mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required"). Możesz użyć tego parametru, aby zignorować komunikat i niezależnie od tego uruchomić update.php.

Uwaga:

Only recommended for use by developers.

--skip-config-validation

(wprowadzono w 1.39) Skips checking whether the existing configuration is valid. Otherwise, this script will not run if an invalid configuration is detected.

--skip-compat-checks

(usunięto w 1.41) Skips compatibility checks (Gerrit change 851684)

--nopurge

(usunięto w 1.36) do not purge objectcache table. Normally update.php purges the objectcache table (generally contains the parser cache and the messages cache), msg_resource and msg_resource_links (these are used for ResourceLoader message caching and are cleared in 1.21 and later) tables in the database, if you don't want to purge this table, use the --nopurge option.

Extensions can install/update their schemas using the LoadExtensionSchemaUpdates hook.

Zobacz też

• Podręcznik:$wgDBadminuser i Podręcznik:$wgDBadminpassword

• For detailed instruction on using update.php, see Podręcznik:Aktualizowanie , Manual:Upgrading#Command_line