Manuale:Update.php

archivio MediaWiki: update.php
Ubicazione:	maintenance/
Codice sorgente:	master • 1.41.1 • 1.40.3 • 1.39.7
Classi:	UpdateMediaWiki

Dettagli

Lo script di manutenzione update.php verifica se lo schema del database di MediaWiki ha bisogno di essere aggiornato per funzionare con la versione di MediaWiki corrente. Dovresti eseguire update.php dopo ogni aggiornamento di MediaWiki o dopo l'aggiornamento o installazione di una estensione che richiede un aggiornamento dello schema. La maggior parte delle estensioni che necessitano di aggiornamenti dello schema lo dichiarano nella loro documentazione.

Da browser

Se non hai accesso alla riga di comando del tuo server, allora utilizza l'aggiornamento via web per eseguire lo script aggiornamento.

→ Aggiornamento via web

Da riga di comando

Dalla riga di comando, o da una shell SSH o simili:

• Entra nella cartella maintenance
• Eseguo lo script di aggiornamento:

$ php update.php

Attenzione:

L'esecuzione dello script update.php potrebbe interrompersi con errori, lasciando il database in uno stato non consistente. Effettua sempre un backup del database prima di eseguire lo script!

Questo script di manutenzione può essere disabilitato usando $wgAllowSchemaUpdates . Le persone con siti wiki estremamente grandi e trafficati potrebbero aver bisogno di prestare molta cautela effettuando gli aggiornamenti, ma se non si è sicuri se la cosa ti riguardi, probabilmente non lo è.

Utilizza le seguenti istanze su Vagrant (dall'interfaccia SSH della tua vagrant).

$ mwscript update.php

Parametri

Questo script offre diversi parametri (generici, dipendenti dallo script, e specifici di script) che potrebbero richiedere alcune variabili d'ambiente del wiki.

Parametri di manutenzione generici

--help

used to get a prompt of all available script parameters (generic, script dependent and script specific) together with short explanations of their usage. Questi sono più o meno i parametri utilizzati più spesso.

--wiki wikiId

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

Parametri specifici dello script

--quick

salta sequenza del conto alla rovescia

--nopurge

(rimosso nella 1.36) non svuotare la tabella objectcache. 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.

--doshared

Aggiorna anche le tabelle condivise.

--force

Run this script even if it is disabled by configuration options.

--conf

Specificare il file di configurazione (il file LocalSettings.php per il specifico wiki). Usato per le famiglie wiki.

--noschema

Tutte le modifiche alla struttura delle tabelle o l'aggiunta di tabelle sono ignorate. Vengono effettuate soltanto le modifiche ai dati.

--schema

Il database non riceve alcuna modifica allo schema, ma i cambiamenti allo schema sono salvati in un file SQL separato da poter eseguire a parte.

Permette di eseguire "update.php" quando $wgAllowSchemaUpdates è impostato a 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).

--skip-compat-checks

Salta i test di compatibilità (rimosso nella 1.41), Gerrit change 851684

--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"). Puoi usare questo parametro per ignorare il messaggio ed eseguire update.php a prescindere.

Attenzione:

Uso raccomandato solo agli sviluppatori.

Le estensioni possono installare/aggiornare il loro schema usando l'hook LoadExtensionSchemaUpdates .

Vedi anche

• Manual:$wgDBadminuser e Manual:$wgDBadminpassword
• Per istruzioni dettagliate sull'utilizzo di update.php, vedi Manuale:Aggiornare , Manuale:Aggiornamenti#Riga di comando