Atualizar o núcleo do Drupal com o Composer

Aprender DrupalGlossário do Drupal

Este artigo parte do princípio que instalou o Drupal com um projeto composer como drupal/core-recommended ou drupal/dxpr-marketing-cms-project

Listar as atualizações disponíveis do Drupal

composer outdated "drupal/*"

Se não existir nenhuma linha a começar por drupal/core, o Composer não tem conhecimento de nenhuma atualização. Se existir uma atualização, continue com os comandos abaixo

Criar uma cópia de segurança da instância de Drupal

Ao atualizar um site de produção, crie sempre uma cópia de segurança antes de atualizar, mesmo que já tenha testado a atualização com sucesso num ambiente de desenvolvimento ou de teste. Use as ferramentas do fornecedor de alojamento para criar uma cópia de segurança ou um instantâneo do site Drupal.

Atualizar o código do núcleo do Drupal

se estiver a usar drupal/core-recommended:

composer update "drupal/core-*" --with-all-dependencies

Para simular a atualização e ver o que aconteceria, sem alterar nada, adicione --dry-run.

Atualizar para a última versão de correção do núcleo

Se quiser atualizar o site para a última versão de correção, mas não para a última versão menor, adicione --with= opções para cada drupal/core-* dependência listada em composer.json.

Por exemplo, se 10.2 for a versão menor atual e quiser atualizar o site para a última versão de correção de 10.3:

composer update "drupal/core-*" --with-all-dependencies --with=drupal/core-recommended:~10.3.0 --with=drupal/core-composer-scaffold:~10.3.0

Este exemplo parte do princípio que  drupal/core-recommended e drupal/core-composer-scaffold são as únicas dependências do núcleo do Drupal em composer.json.

Atualizar para uma versão específica do núcleo

Em geral, recomendamos que não especifique uma versão específica do núcleo do Drupal ao atualizar, exceto se souber que pretende fixar uma versão específica. Se quiser fixar o site numa versão específica, pode usar o seguinte exemplo: 

Para fixar o site na versão 10.3.6 e atualizar todas as dependências em conformidade: 

composer require drupal/core-recommended:10.3.6 drupal/core-composer-scaffold:10.3.6 drupal/core-project-message:10.3.6 --update-with-all-dependencies

Aviso: se fixar o site numa versão específica do núcleo, essa versão será adicionada ao ficheiro de bloqueio e as futuras atualizações não irão além dessa versão. Volte a executar o comando require como indicado abaixo para regressar a uma versão não fixada do núcleo.

Remover a fixação de uma versão específica do núcleo

Se estiver a usar uma versão fixada do núcleo do Drupal e quiser atualizar o site para outra versão, tem duas opções.

  1. Pode executar o comando composer require acima para especificar uma nova versão fixada do núcleo. 
  2. Pode remover a fixação da versão do núcleo e atualizar para a última versão do Drupal.

Para remover a fixação da versão do Drupal, execute este comando: 

composer require drupal/core-recommended drupal/core-composer-scaffold drupal/core-project-message --update-with-all-dependencies

Executar as atualizações da base de dados

Por conveniência, incluímos os comandos do Drush necessários para concluir uma atualização; muitas pessoas consideram o Drush mais rápido e fácil do que a área de administração web.

Pode usar o drush:

drush updatedb
drush cache:rebuild

Ou pode visitar [YOUR DOMAIN]/update.php num navegador.