Manual:Update.php/pt
| ficheiro do MediaWiki: update.php | |
|---|---|
| Localização: | maintenance/ |
| Código fonte: | master • 1.44.0 • 1.43.3 • 1.39.13 |
| Classes: | UpdateMediaWiki |
Detalhes
O comando de manutenção update.php verifica se o esquema da base de dados do MediaWiki precisa de ser atualizada para funcionar com a versão atual do MediaWiki.
Deveria executar update.php depois de cada atualização do MediaWiki ou depois de atualizar ou instalar uma extensão que requer uma atualização de esquema.
A maioria das extensões que requerem atualizações de esquema irão informar na própria documentação.
Este comando de manutenção pode ser desativado via
$wgAllowSchemaUpdates. As pessoas com wikis extremamente grandes e muito utilizadas podem ter que atualizar com cuidado, mas se não tem a certeza se isso aplica-se a si, então provavelmente não.
Utilização
 Aviso: | update.php pode sair com erros, deixando a base de dados num estado inconsistente. Efetue sempre a cópia de segurança da base de dados antes de executar o comando! |
No navegador
Se não tem acesso à linha de comandos do seu servidor, então, então utilize o atualizador da Web para executar o comando de atualização.
Na linha de comandos
Utilize o seguinte na linha de comandos, ou numa interface de SHH ou similar:
| Versão MediaWiki: | ≥ 1.40 |
$ php maintenance/run.php update
| Versão MediaWiki: | ≤ 1.39 |
$ php maintenance/update.php
Utilize o seguinte nas instâncias Vagrant (dentro da sua SHH Vagrant).
$ mwscript update.php
Parâmetros
Este comando oferece vários parâmetros (genérico, dependente e específico de comando) que pode ser necessário em alguns ambientes da wiki.
Parâmetros de manutenção genéricos
--help- utilizado para obter um aviso de todos os parâmetros de comando disponíveis (genérico, dependente de comando e específico de comando), juntamente com breves explicações sobre a sua utilização. Estes são parâmetros menos utilizados.
--wiki wikiId- atualizar família wiki se o nome da base de dados depende de um anfitrião virtual, onde wikiId - nome da base de dados (por exemplo, enwiki, dewiki...)
--conf- Especifica o ficheiro de configuração (o ficheiro
LocalSettings.phppara a wiki específica). Utilizado para as famílias wiki.
Parâmetros específicos de comando
--quick- ignorar sequência de contagem
--initial- (introduzido(a) na 1.43) Realize atualizações iniciais necessárias depois da instalação manual, utilizando tables-generated.sql
--doshared- Também atualize as tabelas partilhadas.
--noschema- Todas as alterações na estrutura ou adições à tabela são ignoradas. Apenas são realizadas as alterações de dados.
--schema- Não são realizadas nenhumas alterações de esquema na base de dados, mas as alterações de esquema são guardadas num ficheiro SQL separado que pode ser executado.
- 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- 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"). You can use this parameter to ignore the message and run update.php regardless.
- Aviso:
Recomendado apenas para a utilização por programadores. --skip-config-validation- (introduzido(a) na 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- (removed in 1.41) Ignora as verificações de compatibilidade (Gerrit change 851684)
--nopurge- (removed in 1.36) do not purge objectcache table. Normally
update.phppurges 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--nopurgeoption.
Extensions can install/update their schemas using the LoadExtensionSchemaUpdates hook.
Consultar também
- Manual:$wgDBadminuser e Manual:$wgDBadminpassword
- Para instrução detalhada em como utilizar
update.php, consulte Manual:Atualização, Manual: Atualização#Linha de comandos