Příručka:Update.php

Soubor MediaWiki: update.php
Lokalita:	maintenance/
Zdrojový kód:	master • 1.43.0 • 1.42.5 • 1.39.11
Třídy:	UpdateMediaWiki

Podrobnosti

Skript údržby update.php kontroluje, zda je potřeba aktualizovat schéma databáze MediaWiki, aby fungovalo s aktuální verzí MediaWiki. Měli byste po každé aktualizaci MediaWiki nebo po aktualizaci či instalaci rozšíření spustit update.php, které vyžaduje aktualizaci schématu. Většina rozšíření, která vyžadují aktualizace schématu, to uvádí ve své dokumentaci.

Tento skript údržby lze deaktivovat pomocí $wgAllowSchemaUpdates . Lidé s extrémně velkými a zaneprázdněnými wikinami mohou potřebovat provádět aktualizace opatrně, ale pokud si nejste jisti, zda se to týká vás, pravděpodobně ne.

Použití

Varování:

update.php může skončit s chybami a ponechat databázi v nekonzistentním stavu. Před spuštěním skriptu vždy zálohujte databázi!

Z prohlížeče

Pokud nemáte přístup k příkazové řádce svého serveru, spusťte skript aktualizace pomocí webového aktualizačního nástroje.

→ Webový aktualizátor

Z příkazové řádky

Použijte následující příkaz na příkazovém řádku nebo SSH shell nebo podobně:

$ php maintenance/run.php update

Použijte následující na Vagrant instance (z vašeho Vagrant SSH).

$ mwscript update.php

Parametry

Tento skript nabízí několik parametrů (obecné, závislé na skriptu a specifické pro skript), které mohou být vyžadovány v některých prostředích wiki.

Obecné parametry údržby

--help

Slouží k získání výzvy ke všem dostupným parametrům skriptu (obecné, závislé na skriptu a specifické pro skript) spolu s krátkým vysvětlením jejich použití. Jedná se o méně často používané parametry.

--wiki wikiId

Aktualizujte rodinu wiki, pokud název databáze závisí na virtuálním hostiteli, kde wikiId - název databáze (např. enwiki, dewiki ...)

--conf

Určuje konfigurační soubor (soubor LocalSettings.php pro konkrétní wiki). Používá se pro wiki rodiny.

Parametry specifické pro skript

--quick

Přeskočit odpočítávací sekvenci

--initial

(zavedeno od 1.43) Proveďte počáteční aktualizace požadované po ruční instalaci pomocí tables-generated.sql

--doshared

Aktualizujte také sdílené tabulky.

--noschema

Všechny změny ve struktuře tabulky nebo doplňky tabulky jsou přeskočeny. Provádějí se pouze změny dat.

--schema

V databázi nejsou provedeny žádné změny schématu, ale změny schématu jsou uloženy do samostatného souboru SQL, který lze spustit.

Umožňuje spuštění "update.php", když je $wgAllowSchemaUpdates nastaveno na false. To je užitečné pro prostředí bez WMF, kde přísná oprávnění DB umožňují aktualizace databáze (které provádí "update.php"), ale žádné změny schématu (jako je přidávání nebo vypouštění tabulek nebo indexů, které také provádí "update.php").

--force

Spusťte tento skript, i když jej možnosti konfigurace zakazují.

--skip-external-dependencies

při použití composer.local.json k tomu, aby Composer instaloval rozšíření a jejich závislosti, se může zobrazit chybová zpráva, že existuje neshoda mezi nainstalovanou a požadovanou verzí (např. "mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required"). Tento parametr můžete použít k ignorování zprávy a spuštění update.php bez ohledu na to.

Varování:

Doporučeno pouze pro použití vývojáři.

--skip-config-validation

(zavedeno od 1.39) Přeskočí kontrolu, zda je stávající konfigurace platná. V opačném případě se tento skript nespustí, pokud je zjištěna neplatná konfigurace.

--skip-compat-checks

(odstraněno od 1.41) Přeskočí kontroly kompatibility (Gerrit change 851684)

--nopurge

(odstraněno od 1.36) Nečistit tabulku objectcache. Normálně update.php vyčistí tabulku objectcache (obecně obsahuje mezipaměť analyzátoru a mezipaměť zpráv), msg_resource a msg_resource_links (tyto se používají pro ukládání zpráv ResourceLoader do mezipaměti a jsou vymazány v 1.21 a novějších) tabulky v databázi, pokud tuto tabulku vyčistit nechcete, použijte volbu --nopurge.

Rozšíření mohou instalovat/aktualizovat svá schémata pomocí háčku LoadExtensionSchemaUpdates .

Související odkazy

• Příručka:$wgDBadminuser a Příručka:$wgDBadminpassword
• Podrobné pokyny k používání update.php naleznete na stránkách Příručka:Aktualizace a Příručka:Aktualizace#Příkazový řádek