Como atualizar o PrestaShop

Este capítulo descreve várias maneiras de concluir uma atualização do PrestaShop.

Atualização manual - detalhes do processo

Este guia fornece controle total sobre o processo. Este foi aplicado pela PrestaShop para várias versões principais e, portanto, pode ser aplicado em lojas muito antigas.

Baixar download

O primeiro passo é baixar a versão mais recente em https://www.prestashop.com/.

Se você atualizar para outra versão do PrestaShop 1.6, os arquivos de lançamento podem ser encontrados em um lista de arquivos dedicados.

O download também pode ser feito na linha de comando, como feito aqui com a versão 1.7.6.8:

wget -O prestashop-upgrade.zip https://www.prestashop.com/download/old/prestashop_1.7.6.8.zip

Extração de arquivo

Extraia os arquivos do arquivo com uma ferramenta como 7zip

Observação a partir do PrestaShop 1.7.0.0, o pacote de lançamento contém um arquivo zip, que também deve ser extraído.

Em um terminal Linux, você pode usar o comando `unzip`:

unzip prestashop-upgrade.zip && unzip prestashop.zip

Depois de ter as pastas como classes/, modules/, themes/, etc, você pode ir para a próxima etapa.

Limpeza de arquivos de amostra

Evite substituir os recursos de produção (imagens, conf…) com os dados padrão. Essas pastas podem ser removidas da nova versão:

• img /
• sobrepor/

Todos os outros arquivos presentes na nova versão sobrescreverão os arquivos existentes. Todas as alterações feitas no código-fonte original serão perdidas (a propósito, isso não é recomendado, você nunca deve modificar os arquivos principais).

Além disso, renomeie a pasta “admin” para corresponder ao nome da pasta admin da sua loja. Isso evitará uma duplicação indesejada do conteúdo de administração.

Ativando o modo de manutenção

A loja agora será modificada. Como isso pode causar um comportamento inesperado para você e seus clientes durante a atualização, é altamente recomendável ativar o modo de manutenção durante a atualização.

Isso pode ser feito em seu painel de administração:

• No PrestaShop 1.7, em Parâmetros da loja> Geral> guia Manutenção
• No PrestaShop 1.6, em Parâmetros da loja> Manutenção

Adicionar seu endereço IP permitirá que você acesse sua loja enquanto ela está em modo de manutenção. Dessa forma, você pode ter certeza de que tudo está funcionando corretamente antes de permitir que seus clientes acessem novamente.

Cópia do arquivo

Nesta etapa, nós “atualizamos” os arquivos PrestaShop copiando o novo conteúdo do lançamento na loja existente.

Nota sobre a pasta `vendor` : as atualizações anteriores do PrestaShop 1.7 mostraram que podem ocorrer conflitos ao mesclar o novo fornecedor / pasta com o antigo. Para evitar esse problema, recomendamos excluir esta pasta na loja existente antes de copiar a nova.

No Windows, copie o novo conteúdo da pasta e cole-o na pasta da sua loja. Você receberá avisos de que os arquivos já existem na pasta de destino. Escolha “substituir” para continuar.

No linux, a cópia pode ser feita em seu terminal:

cp -R <path_to_the_new_release>/* <path_to_the_current_shop>/

Exemplo:

cp -R ~/Downloads/prestashop/* /var/www/html/

Atualização de banco de dados

Assim que os arquivos forem copiados, o banco de dados da sua loja está pronto para ser atualizado.

Todas as mudanças a serem aplicadas foram definidas na pasta `install`, rodando-as pode ser feito com um script PHP específico.

Quando estiver pronto, execute o arquivo `install / upgrade / upgrade.php`.

Isso pode ser feito com um navegador, acessando o endereço http://<shop_domain>/install/upgrade/upgrade.phpou a partir da linha de comando do seu servidor:

php install/upgrade/upgrade.php

Em ambos os casos, um log XML será exibido. O resultado pode ser encontrado no atributo resultda primeira tag <action>:

• ok se as atualizações foram encontradas e executadas
• error se algo deu errado
• info para as próximas ações, exibindo os detalhes do processo

Registro de execução

Quando o script de atualização encontrar algumas atualizações para aplicar, as consultas SQL executadas serão listadas junto com seus respectivos resultados.

<?xml version="1.0" encoding="UTF-8"?><action result="ok" id="">
<action result="info" id="1.7.0.5"><![CDATA[[OK] PHP 1.7.0.5 : /* PHP:ps_update_tabs(); */]]></action>
<action result="info" id="1.7.0.5"><![CDATA[[OK] SQL 1.7.0.5 : ALTER TABLE `ps_currency` MODIFY `name` varchar(64) NOT NULL]]></action>
<action result="info" id="1.7.1.0"><![CDATA[[OK] SQL 1.7.1.0 : SET SESSION sql_mode = '']]></action>
<action result="info" id="1.7.1.0"><![CDATA[[OK] SQL 1.7.1.0 : SET NAMES 'utf8']]></action>
[...]

Você pode verificar se cada ação está marcada como “OK”. Caso contrário, detalhes adicionais serão mostrados após a solicitação, o que pode ajudá-lo a corrigir o problema e executar novamente a solicitação manualmente em seu banco de dados. Em alguns casos, pode ser necessário restaurar o backup do banco de dados e reiniciar.

Códigos de erro

Um código de erro também pode ser exibido. Cada código está relacionado a uma mensagem descrita aqui:

• Erro # 27: a loja está executando uma versão mais recente do que o conteúdo fornecido pela pasta de instalação.
• Erro # 28: a loja já está na versão para a qual você está tentando atualizar.
• Erro # 29: não foi possível encontrar a versão atual. Verifique o arquivo de parâmetros do banco de dados e a conexão do banco de dados.
• Erro nº 31: não foi possível encontrar o diretório de atualização no caminho de instalação, a pasta install/upgrade/sqlexiste e não está vazia?
• Erro nº 32: nenhuma atualização precisa ser aplicada.
• Erro # 33: Erro ao carregar um arquivo de atualização do SQL. Verifique suas permissões da pasta install/upgrade/sql.
• Erro # 40: a versão fornecida no arquivo install/install_version.phpé inválida.
• Erro # 43: erro ao atualizar o esquema do banco de dados usando a doutrina.
• Erro # 44: Erro ao atualizar as traduções.
• Erro # 45: Erro ao habilitar o tema.

Limpar

Antes de prosseguir, algumas coisas devem ser limpas.

• A pasta `install`, usada para executar as atualizações do banco de dados, não é mais necessária e pode ser excluída com segurança.
• Ao abrir sua loja (na frente ou no back office) em seu navegador, você pode ver alguns problemas visuais. Isso pode ser devido aos seus ativos antigos ainda serem servidos por um cache. Recarregue-os atualizando a página à força (pressione ctrl + R no Windows / Linux ou cmd + R no Mac OS) ou limpando o cache do navegador.

Atualização de módulos

Seus arquivos de módulos foram atualizados durante a cópia do arquivo, no entanto, muitos deles podem exigir alterações adicionais no banco de dados. Verifique a página do módulo em seu Back Office para ver se as atualizações estão esperando para serem executadas.

Vá para o painel de administração e faça o login. Você notará que a versão exibida mudou na página de login. Em seguida, no menu, clique na página do módulo para acessar seu catálogo.

No PrestaShop 1.6, esta página pode ser encontrada em “Módulo e Serviços”. Clique em “Atualizar tudo” no topo da página para executar todas as atualizações disponíveis:

No PrestaShop 1.7, o mesmo recurso pode ser encontrado na página Melhorar >> Módulos, na aba “Notificações”:

Módulo de atualização com 1 clique

Sobre

Se o processo manual parecer muito tedioso, existem outras soluções para concluir uma atualização.

O PrestaShop fornece o módulo de atualização com 1 clique gratuitamente no marketplace e no painel de administração da sua loja. Ele executa o processo fornecido anteriormente automaticamente e está disponível para quase todas as versões do PrestaShop.

Nota sobre a versão +4.0.0

Este módulo foi reformulado internamente para PrestaShop 1.6 e 1.7.

Detalhes técnicos sobre esta versão principal podem ser encontrados em um documento específico (Google docs).

Download / instalação

• Faça download do marketplace: https://addons.prestashop.com/en/data-migration-backup/5496-.html

Em seguida, importe seu arquivo de módulo na página de módulos. Para fazer isso, você pode encontrar o botão “Carregar um módulo” (PrestaShop 1.7) ou “Adicionar um módulo” (PrestaShop 1.6) no canto superior direito da página. Clicar nele abrirá um formulário que permitirá que você carregue o zip do módulo.

No PrestaShop 1.7:

No PrestaShop 1.6:

• Do painel de administração

No PrestaShop 1.7:

No PrestaShop 1.6:

Uso

A página de configuração do módulo exibe algumas verificações e as opções disponíveis para uma atualização.

A primeira configuração permite que você escolha o tipo de atualização que deseja executar. É sempre recomendável manter os ramos secundários / principais das opções, pois eles usam algumas informações adicionais fornecidas pelo PrestaShop (checksum md5, arquivos principais a serem excluídos ...).

É sempre recomendável deixar o módulo fazer seu próprio backup, pois isso permitirá que ele execute um rollback imediatamente se algo der errado durante a atualização.

No entanto, se você está confiante no backup que fez e está pronto para reverter manualmente em caso de problemas, você pode desativar a etapa de backup.

Por fim, as últimas opções de personalização do processo de atualização permitem que você mantenha todas as alterações feitas no tema padrão, e-mails, etc.

Caso a configuração escolhida e as autoverificações sejam válidas, um botão “Atualizar Agora” estará disponível. Clicar em iniciar imediatamente a atualização.

Observe que a interface pode ser hostil para você, mas exibe o máximo de informações possível para que você saiba o que aconteceu em caso de problemas. Deixe o processo funcionar até que a mensagem “Upgrade bem sucedido” apareça. Se um erro for encontrado, você terá a opção de reverter.

Serviço de suporte

Fazer uma atualização sozinho pode ser arriscado. Se você se sentir desconfortável em fazer isso sozinho, pode deixar para nossa equipe de suporte, que cuidará do backup e da atualização para a última versão secundária para você (1.6 → 1.6, 1.7 → 1.7 etc.).

Basicamente, o processo e o resultado serão os mesmos. Os dados existentes na loja serão mantidos, assim como seu módulo e seu tema atual.

Você pode assinar o serviço de atualização no mercado.

Muitas agências e freelancers em sua área também podem fornecer esse tipo de serviço.