Solução de Problemas de Atualização de Banco de Dados

Antes de começar a solucionar problemas relacionados à atualização do banco de dados, sempre faça backup do banco de dados e da base de código.

Se houver algum problema que impeça a execução segura de atualizações de banco de dados, o update.php relatará um erro.

Leia cuidadosamente a mensagem de erro para resolver o problema.

Módulos ou temas inválidos

Em alguns casos, o update.php pode relatar que há módulos ou temas inválidos. Isso ocorre quando um módulo ou tema é especificado no arquivo de configuração core.extension.yml, mas está ausente ou é incompatível com o site.

Ao resolver esse problema, primeiro você deve verificar se não importou uma versão incorreta da configuração core.extension.yml. Depois, resolva os problemas adicionais com base na mensagem específica exibida. Reinicie o update.php assim que o problema for resolvido.

Módulo ou tema ausente

1. Se o update.php relatar que um módulo ou tema está ausente e você estiver usando o arquivo core.extension.yml correto, certifique-se de que o módulo ou tema esteja presente na base de código do site.

• Por exemplo, procure em [site-root]/modules e [site-root]/sites/all/modules para encontrar a pasta que corresponde ao nome do módulo ausente. [site-root]/modules tem precedência sobre [site-root]/sites/all/modules, mas ambos são verificados para módulos.

2. Se a pasta estiver completamente ausente, localize o módulo em Drupal.org e tente fazer o upload novamente para a pasta de seus módulos. Certifique-se de fazer o download da versão compatível com sua versão do Drupal.

3. Se a pasta estiver presente, talvez faltem arquivos ou o conteúdo seja corrompido de outra forma. Você também pode localizar o módulo em Drupal.org e tentar fazer o download novamente neste caso. Certifique-se de fazer o download da versão compatível com sua versão do Drupal. Sobrescreva a pasta existente com a nova versão baixada.

4. Se o módulo não foi baixado do Drupal.org, tente encontrar sua fonte original.

• Se o módulo pertencer ao seu site ou aplicativo, tente encontrar sua versão original e adicione-a novamente à pasta de módulos.
• Se o módulo foi criado por terceiros, mas não está hospedado no Drupal.org (por exemplo, fornecido em GitHub), tente encontrar uma versão válida e fazer o download novamente.

5. Como último recurso, se o módulo não puder ser encontrado, você pode tentar remover a entrada para ele do core.extension.yml. Lembre-se de que isso pode resultar em outros erros fatais no site.

6. Assim que o módulo for restaurado, reinicie o update.php.

Módulo ou tema incompatível com a versão instalada do Drupal

1. Se o update.php relatar que um módulo ou tema é incompatível com a versão instalada do Drupal, você precisará atualizar o Drupal ou atualizar o módulo ou tema.

2. Primeiro, verifique qual versão do núcleo do Drupal está instalada. Isso pode ser feito na página Relatórios - Relatório de Status (Reports - Status report).

3. Em seguida, verifique qual versão do módulo ou tema está instalada lendo o arquivo modules/modulename/modulename.info.yml. Você deve ver pelo menos uma das linhas a seguir no início do arquivo:

core: 8.x
core_version_requirement: ^8.8 || ^9

Isso significa que o módulo é compatível com Drupal 8.8+ e Drupal 9. A chave core: 8.x é opcional neste caso e pode estar presente ou ausente. (Mais informações sobre a chave core_version_requirement.)

core_version_requirement: ^9

Isso significa que o módulo é compatível apenas com Drupal 9. (Mais informações sobre a chave core_version_requirement.)

core: 8.x

Isso significa que o módulo é compatível apenas com Drupal 8.

core: 7.x

Isso significa que o módulo é compatível apenas com Drupal 7.

4. Se a versão do núcleo do Drupal for muito pequena para o módulo instalado, faça o download de uma atualização para o núcleo do Drupal.

5. Se a versão do módulo for muito pequena para a versão do núcleo do Drupal, faça o download ou instale uma versão atualizada do módulo.

6. Se uma versão compatível do módulo ou núcleo não estiver disponível, talvez seja necessário restaurar a versão anterior do backup.

7. Assim que versões compatíveis do núcleo do Drupal e do módulo ou tema aparecerem na base de código, reinicie o update.php.

Módulo ou tema incompatível com a versão instalada do PHP

1. Se um módulo ou tema for incompatível com a versão instalada do PHP, localize uma linha como a seguinte no arquivo modules/modulename/modulename.info.yml:

php: 7.3

2. Opção 1. Instale a versão do módulo ou tema que oferece suporte à versão PHP do seu site.

3. Opção 2. Altere a versão do PHP do seu site para uma versão compatível com o módulo.

4. Quando versões compatíveis de PHP e o módulo ou tema afetado aparecerem na base de código, reinicie o update.php.