Manuale:Update.php

archivio MediaWiki: update.php
Ubicazione:	maintenance/
Codice sorgente:	master • 1.42.3 • 1.41.4 • 1.39.10
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.

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 è.

Usage

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!

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

From the command line

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

$ php maintenance/run.php update

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 a virtual host, where wikiId - database name (e.g., enwiki, dewiki ...)

--conf

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

Parametri specifici dello script

--quick

salta sequenza del conto alla rovescia

--initial

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

--doshared

Aggiorna anche le tabelle condivise.

--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).

--force

Run this script even if configuration options disable it.

--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.

--skip-config-validation

(introdotto nella 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

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

--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.

 Nota:

Vedi anche

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