Configurar o LiteMage Cache no Magento 2

O LiteMage integra a cache de página completa do Magento 2 com o LiteSpeed Enterprise. A melhoria depende do catálogo, das páginas que possam ser armazenadas e da taxa de acertos; não pode ser expressa como uma percentagem fixa.

A extensão do Magento é gratuita, mas só funciona se o servidor dispuser de uma licença LiteSpeed Enterprise com o módulo LiteMage ativado. Confirme esta disponibilidade com o suporte antes de a instalar.

Verificações prévias

• Utilize uma versão do Magento 2 que continue a ter suporte e reveja os seus requisitos de PHP, extensões e Composer.
• Crie uma cópia recuperável e ensaie a instalação em staging.
• Verifique se o LiteMage está ativado no servidor; instalar apenas a extensão não ativa a cache.

Para o instalar precisa de acesso SSH e de experiência prévia com o terminal.

Instalação

Aceda à conta por SSH e posicione-se no diretório do Magento. Anote o modo de implementação atual e utilize o PHP e o Composer compatíveis com essa instalação. Agende uma janela de manutenção antes de modificar uma loja em produção.

Se o Magento estiver em modo production, passe-o temporariamente para developer seguindo o procedimento oficial do Magento. Depois, instale o pacote mantido a partir do Composer:

composer require litespeed/module-litemage

Com os seguintes comandos, que devem ser executados um a um, ative o módulo e recompile os ficheiros de configuração para que seja tido em conta.

php bin/magento module:enable Litespeed_Litemage
php bin/magento setup:upgrade
php bin/magento setup:di:compile

Se a loja utilizava o modo production, volte a ativá-lo no fim. Este comando recompila as dependências, implementa o conteúdo estático e limpa a cache durante a mudança de modo:

php bin/magento deploy:mode:set production

Verifique se o comando termina sem erros e se a parte pública carrega os seus recursos antes de reabrir a loja.

Para concluir, edite o ficheiro .htaccess do Magento e acrescente no início as seguintes linhas:

<IfModule LiteSpeed>
LiteMage on
</IfModule>

Colocação em funcionamento

Com o LiteMage instalado, aceda à administração do Magento, secção Store > Configuration > Advanced > System, e altere Full Page Cache, se for necessário, para que LiteMage apareça como o sistema de cache em uso.

Para terminar, aceda a System > Cache Management e atualize a cache em Configuration e Page Cache, verificando também que ambas aparecem como ativas.

Verificar e reverter

Numa sessão sem início de sessão, carregue duas vezes uma página pública e reveja os seus cabeçalhos nas ferramentas do navegador. O LiteMage pode mostrar X-LiteSpeed-Cache: hit, litemage quando entrega uma resposta armazenada. Reveja também o carrinho, o pagamento, as moedas, os idiomas e duas sessões de cliente diferentes.

Se a instalação falhar, não continue a executar os comandos restantes. Guarde o erro e restaure a implementação anterior com a sua configuração. O setup:upgrade pode modificar a base de dados: voltar ao código anterior não reverte por si só essas alterações. A recuperação deve respeitar as encomendas e escritas que entretanto se tenham produzido.

Para deixar de usar o LiteMage, altere primeiro o sistema de cache de página completa seguindo o procedimento do Magento, limpe a cache e verifique a loja antes de retirar a extensão. Consulte a instalação oficial do LiteMage para os requisitos e comandos da sua versão.