Atualizar o Núcleo do Drupal Manualmente

Antes de você começar

Se ainda não tiver feito, recomenda-se ler esta introdução, que resume todas as opções que você pode escolher ao atualizar o Drupal 8.

PS! Este procedimento de atualização também é descrito no guia do usuário.

Se você instalou módulos de contribuição com dependências de terceiros usando o Composer, você precisa usar outras opções de atualização, pois essas instruções sobrescreverão o diretório vendor/.

Atualizar o Núcleo do Drupal 8

Etapas para atualizar o núcleo do Drupal 8 usando instalação manual e linha de comando (shell):

1. Faça backup de seus arquivos e banco de dados. Um backup completo torna fácil voltar à versão anterior em caso de falha na atualização.

Opcionalmente, se você fez alterações manuais em arquivos como .htaccess, composer.json ou robots.txt, copie-os para um lugar fácil de encontrar. Porque após instalar o novo núcleo do Drupal, você precisará reaplicar as alterações. Por exemplo, o Acquia Dev Desktop coloca o arquivo .htaccess no diretório de nível superior, e sem ele, apenas a página inicial funcionará no seu site.

Sempre reverta para um backup se você receber um erro fatal durante o processo de atualização.

2. Usando o Drupal, faça login como qualquer usuário com as permissões de "Administrar atualizações de software".

3. Usando o Drupal, coloque seu site em modo de manutenção. Para fazer isso:

           - Vá através da interface de administração Administration > Configuration > Development > Maintenance mode.

           - Marque a caixa "Put site into maintenance mode".

           - Clique em "Salvar configuração (Save configuration)".

4. Escolha uma das duas opções a seguir para remover arquivos nos diretórios de nível superior, bem como nos diretórios "core" e "vendor", deixando para trás os diretórios "modules", "profile", "sites", "themes":

      Usando o Shell

         1. Vá para sua instalação do Drupal.

cd /path/to/your/drupal/directory

         2. Remova os diretórios 'core' e 'vendor'

rm -rf core vendor

         3. Remova todos os arquivos no diretório de nível superior.

rm -f *.* .[a-z]*

      Usando um Cliente FTP

         1. Vá para o diretório do Drupal.
         2. Selecione todos os arquivos no diretório de nível superior (também arquivos ocultos começando com um ponto), bem como os diretórios "core" e "vendor" e exclua-os. Não exclua os diretórios 'modules', 'profiles', 'sites' e 'themes'.

5. Opcionalmente, às vezes uma atualização inclui alterações no arquivo default.settings.php. Isso será anotado nas notas de lançamento. Você pode encontrar as notas de lançamento para sua versão em https://www.drupal.org/project/drupal. Na parte inferior da página do projeto na seção "Downloads" use o link para sua versão do Drupal para visualizar as notas de lançamento. Se sua versão não estiver listada, use o link "Ver todos os lançamentos". Nesta página, você pode rolar para baixo ou usar o filtro para encontrar sua versão e notas de lançamento. Se a atualização contiver alterações no arquivo default.settings.php, siga estas etapas.

• Copie as entradas personalizadas e específicas do site do backup que você fez para o novo arquivo settings.php. Você certamente precisará das linhas que fornecem informações do banco de dados, e também pode querer copiar qualquer outra configuração que tenha adicionado.
• Faça uma cópia do novo arquivo default.settings.php e nomeie a cópia settings.php (sobrescrevendo seu arquivo settings.php anterior).
• Faça um backup do seu arquivo settings.php com um nome diferente.
• Localize o arquivo settings.php no diretório /sites/* . (Geralmente sites/padrão.)

6. Escolha uma das duas opções a seguir para obter novos arquivos nos diretórios de nível superior e nos diretórios "core" e "vendor":

      Usando o Shell

         1. Usando uma linha de comando típica Unix/Linux, use os seguintes comandos para fazer download e extrair:

wget https://ftp.drupal.org/files/projects/drupal-x.y.z.tar.gz
tar zxf drupal-x.y.z.tar.gz

         2. Este comando criou um novo diretório drupal-x.y.z/ contendo todos os arquivos e diretórios do Drupal. Entre no novo diretório e copie os diretórios "core" e "vendor", bem como os arquivos do diretório de nível superior para o diretório de instalação do Drupal:

cd drupal-x.y.z
cp -R core vendor /path/to/your/drupal/directory
cp *.* .[a-z]* /path/to/your/drupal/directory

      Usando Navegador e Cliente FTP

• Baixe a versão mais recente do Drupal 8.x.x do site https://www.drupal.org/download para um diretório fora da sua raiz da web.
• Extraia o arquivo.
• Use um cliente FTP para fazer upload dos diretórios "core" e "vendor", bem como dos arquivos do diretório de nível superior para o diretório Drupal.

7. Conforme necessário, reaplique qualquer alteração manual em arquivos como .htaccess, composer.json ou robots.txt.

8. Usando seu navegador, execute update.php visitando http://www.example.com/update.php (substituindo www.example.com pelo seu nome de domínio). Isso atualizará as principais tabelas do banco de dados.

       Opcionalmente, se você não estiver conectado como um usuário com a permissão de "Administrar atualizações de software" ou com a conta de manutenção do site (criada durante a instalação), você não conseguirá acessar o update.php. Aqui estão os passos para contornar essa limitação:

              - Abra o arquivo settings.php com um editor de texto.
              - Encontre esta linha

$settings['update_free_access'] = FALSE;

              - Altere o valor FALSE para TRUE:

$settings['update_free_access'] = TRUE;

              - Visite a página /update.php novamente.
              - Depois de concluir todas as etapas acima, é importante para a segurança alterar a configuração de volta para FALSE.

9. Usando o navegador, faça login no administrador do Drupal e selecione "Administração > Relatórios > Relatório de Status" (Administration > Reports > Status report). Certifique-se de que tudo funciona conforme o esperado.

10. Ainda usando o navegador, faça login no administrador do Drupal e selecione Administration > Configuration > Development > Maintenance mode. Desmarque a caixa "Put site into maintenance mode" e clique no botão "Salvar".

11. Após a atualização, exclua a versão do Drupal que você baixou e extraiu anteriormente:

rm drupal-x.y.z.tar.gz
rm -rf drupal-x.y.z/

12. Pronto. Você atualizou com sucesso o núcleo do Drupal 8 usando instalação manual e shell/navegador. :)